すべてのプロダクト
Search
ドキュメントセンター

Tablestore:時系列テーブルの設定の更新

最終更新日:Aug 04, 2026

Tablestore SDK for Java を使用して、時系列データとメタデータの Time-to-Live (TTL) を更新し、メタデータ属性列の更新可否を指定します。

前提条件

Tablestore SDK for Java をインストールし、時系列クライアントを初期化します。

説明

updateTimeseriesTable API を呼び出して、時系列テーブルの設定を更新します。各リクエストでは、時系列データの設定またはメタデータの設定のいずれかを更新できますが、両方を同時に更新することはできません。

public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)

次の例では、example_timeseries_table の時系列データの Time-to-Live (TTL) を 3 年に更新します。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesTableOptions(
        new TimeseriesTableOptions(86400 * 365 * 3));

timeseriesClient.updateTimeseriesTable(request);

パラメーター

UpdateTimeseriesTableRequest には、次のパラメーターが含まれています。

名前

説明

timeseriesTableName (必須)

文字列

設定を更新する時系列テーブルの名前。

timeseriesTableOptions (任意)

TimeseriesTableOptions

時系列データの設定。 timeseriesTableOptions または timeseriesMetaOptions のいずれかを指定する必要がありますが、両方を指定することはできません。

timeseriesMetaOptions (任意)

TimeseriesMetaOptions

時系列メタデータの設定。 timeseriesTableOptions または timeseriesMetaOptions のいずれかを指定する必要がありますが、両方を指定することはできません。

時系列データの設定

timeseriesTableOptionsTimeseriesTableOptions 型で、次のパラメーターが含まれています。

名前

説明

timeToLive (必須)

整数

時系列データの Time-to-Live (TTL) (秒単位)。値を -1 または 86,400 以上の整数に設定します。値 -1 は、データが失効しないことを意味します。

Tablestore は失効したデータを自動的に削除します。

メタデータの Time-to-Live (TTL) が -1 でない場合、この値はメタデータの Time-to-Live (TTL) を超えることはできません。この値を -1 に設定する前に、メタデータの Time-to-Live (TTL) を -1 に設定してください。

時系列メタデータの設定

timeseriesMetaOptionsTimeseriesMetaOptions 型です。 次のパラメーターの少なくとも 1 つを指定します。 省略されたパラメーターは現在の値を保持します。

名前

説明

metaTimeToLive (任意)

整数

時系列メタデータの Time-to-Live (TTL) (秒単位)。値を -1 または 604,800 以上の整数に設定します。値 -1 は、メタデータが失効しないことを意味します。

この値は、時系列データの Time-to-Live (TTL) 未満には設定できません。データの Time-to-Live (TTL) が -1 の場合、この値も -1 である必要があります。

有限の Time-to-Live (TTL) を設定する場合は、allowUpdateAttributesfalse に設定してください。

allowUpdateAttributes (任意)

ブール値

メタデータ属性列の更新可否を指定します。メタデータの Time-to-Live (TTL) が -1 でない場合、この値は false である必要があります。

時系列メタデータの設定の更新

次の例では、時系列メタデータが失効しないように設定し、メタデータ属性列の更新を許可します。

String tableName = "example_timeseries_table";
TimeseriesMetaOptions metaOptions = new TimeseriesMetaOptions();
metaOptions.setMetaTimeToLive(-1);
metaOptions.setAllowUpdateAttributes(true);

UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesMetaOptions(metaOptions);

timeseriesClient.updateTimeseriesTable(request);