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

Tablestore:分析ストアの TTL の更新

最終更新日:Aug 04, 2026

Tablestore SDK for Java を使用して分析ストアの TTL を更新し、データ保持期間を延長したり、履歴データを削除したりできます。

前提条件

Tablestore SDK for Java をインストールし、時系列モデルクライアントを初期化します。分析ストアの操作には Tablestore SDK for Java 5.15.0 以降が必要です。最新バージョンの使用を推奨します。

機能の説明

updateTimeseriesAnalyticalStore メソッドを呼び出して、分析ストアの TTL を更新します。分析ストアのデータ同期モードは更新できません。

public UpdateTimeseriesAnalyticalStoreResponse updateTimeseriesAnalyticalStore(UpdateTimeseriesAnalyticalStoreRequest request) throws TableStoreException, ClientException
重要
  • 有限 TTL を設定すると、TTL を超過したデータは直ちに読み取り不可となり、その後 Tablestore が非同期に削除します。

  • TTL を短くすると、一部のデータが直ちに期限切れになる場合があります。TTL を長くした場合、削除されておらず、新しい TTL の範囲内であれば、以前の TTL の範囲外だったデータも再び読み取り可能になります。

次のサンプルコードは、example_timeseries_table 内の example_analytical_store の TTL を 30 日に更新します。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

TimeseriesAnalyticalStore analyticalStore =
        new TimeseriesAnalyticalStore("example_analytical_store");
analyticalStore.setTimeToLive(2592000);

UpdateTimeseriesAnalyticalStoreRequest request =
        new UpdateTimeseriesAnalyticalStoreRequest("example_timeseries_table");
request.setAnalyticStore(analyticalStore);

timeseriesClient.updateTimeseriesAnalyticalStore(request);

パラメーター

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

名前

タイプ

説明

timeseriesTableName (必須)

String

時系列テーブルの名前。

analyticStore (必須)

TimeseriesAnalyticalStore

更新する分析ストアの設定。

分析ストアの設定

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

名前

タイプ

説明

analyticalStoreName (必須)

String

分析ストアの名前。

timeToLive (必須)

int

分析ストアの TTL (秒)。値は -1、または 2592000 以上の int32 整数に設定します。-1 は、データが期限切れにならないことを示します。