時系列テーブル内の履歴データを自動的にクリーンアップするには、データライフサイクル (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 を使用して、既存のテーブルのデータライフサイクルを変更する方法を説明します。
-
テーブル作成時のデータライフサイクルの設定方法については、「時系列テーブルの管理」をご参照ください。
-
サポートされる機能は、使用する方法によって異なる場合があります。
コンソール
CLI
SDK
よくある質問
関連ドキュメント
分析ストアは、時系列シナリオに最適化された低コストのストレージエンジンです。分析ストアを使用すると、時系列データをコスト効率よく保存し、高速なクエリと分析を実行できます。
アイコンをクリックします。
アイコンをクリックします。