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

Tablestore:時系列データのライフサイクル

最終更新日:Oct 09, 2026

時系列テーブル内の履歴データを自動的にクリーンアップするには、データライフサイクル (TTL) 機能を使用できます。これにより、時系列データを効率的に管理し、ストレージ使用量を削減し、ストレージコストを低減できます。TTL を設定した後、データ保持期間を延長したい場合は、その値を変更できます。

注意事項

  • 削除されたデータは復元できません。慎重に操作してください。

    TTL を設定して履歴データをクリーンアップする前に、必要に応じてデータをバックアップしてください。DataWorks のデータ統合サービスを使用して、時系列データを OSS にエクスポートできます。詳細については、「OSS へのデータ同期」をご参照ください。

  • TTL を変更する前に、DescribeTimeseriesTable API を呼び出して、現在のデータライフサイクルの設定を確認できます。

データライフサイクル

時系列モデルでは、データには時系列メタデータと時系列データが含まれ、それぞれ時系列メタデータテーブルと時系列データテーブルに格納されます。Tablestore は、時系列メタデータと時系列データに対して個別のデータライフサイクルを提供します。

時系列テーブルデータのライフサイクル

時系列テーブルのデータライフサイクルは、時系列データテーブルの属性です。これは、データ保持期間を秒単位で指定します。時系列データの経過期間が設定された TTL を超えると、システムは期限切れのデータを自動的かつ非同期に削除します。

たとえば、テーブルの TTL が 86400 (1 日) に設定されている場合、2016-07-21 00:00:00 UTC+8 の時点では、2016-07-20 00:00:00 UTC+8 より前のすべての時系列データが期限切れになります。その後、システムは期限切れのデータを自動的かつ非同期に削除します。

時系列テーブルを作成する際に TTL を設定しない場合、システムはデフォルト値の -1 を使用します。これはデータが期限切れにならないことを意味します。カスタム TTL を定義することもできます。テーブルを作成した後、UpdateTimeseriesTable API を呼び出して TTL を変更できます。

期限切れのデータは無効と見なされ、システムが物理的にまだ削除していなくても、クエリすることはできません。

  • TTL を短くすると、時系列テーブル内の一部のデータが直ちに期限切れになる場合があります。システムはこの期限切れのデータを非同期に削除します。

  • TTL を長くすると、古い TTL では期限切れになっていたものの、新しい TTL の保持期間内にあるデータは、システムがまだ削除していなければ、再びクエリ可能になる場合があります。

時系列メタデータのライフサイクル

時系列メタデータのデータライフサイクルは、時系列メタデータテーブルの属性です。これは、メタデータの保持期間を秒単位で指定します。時系列メタデータの経過期間が設定された TTL を超えると、システムは期限切れのメタデータを自動的かつ非同期に削除します。このプロセスでは、対応する時系列データは削除されません。

重要

時系列メタデータが期限切れになっても、対応する時系列データが期限切れになっていない場合、GetTimeseriesData API を呼び出す際に時系列識別子を指定することで、時系列データをクエリできます。

時系列テーブルを作成する際にメタデータの TTL を設定しない場合、システムはデフォルト値の -1 を使用します。これはメタデータが期限切れにならないことを意味します。カスタム TTL を定義することもできます。テーブルを作成した後、UpdateTimeseriesTable API を呼び出して TTL を変更できます。

重要

時系列メタデータには、_attributes という名前の更新可能な属性列が含まれています。ただし、この属性を更新できるのは、時系列メタデータのデータライフサイクルが -1 (メタデータが期限切れにならないことを意味する) に設定されている場合のみです。

時系列メタデータのデータライフサイクルを -1 から 7 日以上の値に変更する場合、ビジネスロジックが時系列メタデータ属性の更新を必要としないことを確認してください。また、タイムラインメタデータのプロパティ更新を許可するかどうか を いいえ に設定する必要があります。

タイムラインメタデータのプロパティ更新を許可するかどうか を はい に設定するには、タイムラインメタデータのライフサイクル を -1 に設定する必要があります。

期限切れのメタデータは無効と見なされ、システムが物理的にまだ削除していなくても、検索することはできません。

  • TTL を短くすると、時系列メタデータテーブル内の一部のメタデータが直ちに期限切れになる場合があります。システムはこの期限切れのメタデータを非同期に削除します。

  • TTL を長くすると、古い TTL では期限切れになっていたものの、新しい TTL の保持期間内にあるメタデータは、システムがまだ削除していなければ、再び検索可能になる場合があります。

方法

データライフサイクルは、時系列テーブルの作成時に設定することも、テーブルの作成後に変更することもできます。このセクションでは、コンソール、CLI、または SDK を使用して、既存のテーブルのデータライフサイクルを変更する方法を説明します。

説明
  • テーブル作成時のデータライフサイクルの設定方法については、「時系列テーブルの管理」をご参照ください。

  • サポートされる機能は、使用する方法によって異なる場合があります。

コンソール

コンソールを使用して、時系列データまたは時系列メタデータのデータライフサイクルを変更できます。

データライフサイクル

  1. インスタンスの管理 ページに移動します。

    1. Tablestore コンソールにログインします。

    2. 上部メニューで、リソースグループとリージョンを選択します。

    3. 概要 ページで、インスタンス名をクリックするか、対象インスタンスの 操作 列にある インスタンスの管理 をクリックします。

  2. インスタンスの詳細 タブで、時系列テーブル タブをクリックします。

  3. 時系列テーブル タブで、時系列テーブルの名前をクリックします。

  4. 基本情報 タブの 説明 セクションで、データのライフサイクル の横にある image.png アイコンをクリックします。

  5. 表示されたダイアログボックスで、データライフサイクルの値を変更します。

    TTL は、データ保持期間 (秒単位) です。86400 (1 日) 以上の整数値、または -1 を設定します。値 -1 は、データが期限切れにならないことを意味します。

  6. OK をクリックします。

メタデータのライフサイクル

  1. インスタンスの管理 ページに移動します。

    1. Tablestore コンソールにログインします。

    2. 上部メニューで、リソースグループとリージョンを選択します。

    3. 概要 ページで、インスタンス名をクリックするか、対象インスタンスの 操作 列にある インスタンスの管理 をクリックします。

  2. インスタンスの詳細 タブで、時系列テーブル タブをクリックします。

  3. 時系列テーブル タブで、時系列テーブルの名前をクリックします。

  4. 基本情報 タブの 説明 セクションで、タイムラインメタデータのライフサイクル の横にある image.png アイコンをクリックします。

  5. 表示されたダイアログボックスで、データライフサイクルの値を変更します。

    TTL は、メタデータの保持期間 (秒単位) です。604800 (7 日) 以上の整数値、または -1 を設定します。値 -1 は、メタデータが期限切れにならないことを意味します。

  6. OK をクリックします。

CLI

CLI を使用して、時系列テーブルのデータライフサイクルを変更できます。

alter コマンドを実行して、テーブル情報を更新します。詳細については、「テーブルの更新」をご参照ください。

次の例は、現在のテーブルのデータライフサイクルを 86,400 秒 (1 日) に変更する方法を示しています。

alter --ttl 86400 --ts

SDK

SDK を使用して、時系列データまたは時系列メタデータのデータライフサイクルを変更できます。

データライフサイクル

次の例では、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);

メタデータのライフサイクル

次の例は、指定されたテーブルの時系列メタデータの TTL を 3 年に更新する方法を示しています。

private static void updateTimeseriesMetaTableTTL(TimeseriesClient client) {
    // 時系列テーブルの名前を指定します。
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // TTL を 3 年に更新します。
    TimeseriesMetaOptions options = new TimeseriesMetaOptions();
    options.setMetaTimeToLive(86400 * 365 * 3);
    updateTimeseriesTableRequest.setTimeseriesMetaOptions(options);
    client.updateTimeseriesTable(updateTimeseriesTableRequest);
}

よくある質問

時系列データを削除するにはどうすればよいですか。

関連ドキュメント

分析ストアは、時系列シナリオに最適化された低コストのストレージエンジンです。分析ストアを使用すると、時系列データをコスト効率よく保存し、高速なクエリと分析を実行できます。