すべてのプロダクト
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 のいずれかを指定する必要がありますが、両方を指定することはできません。

時系列データの設定

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

名前

型

説明

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 に設定してください。

時系列メタデータの設定

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

名前

型

説明

metaTimeToLive (任意)

整数

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

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

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

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);