Python 用 Tablestore SDK を使用して時系列テーブルの構成を更新する - Tablestore

UpdateTimeseriesTable 操作を呼び出すことで、時系列テーブルまたは時系列メタデータの構成情報 (Time to Live (TTL) 構成など) を更新できます。

使用上の注意

TimeSeries モデルは、Python 用 Tablestore SDK V6.1.0 以降でサポートされています。正しいバージョンの Python 用 Tablestore SDK を取得していることを確認してください。
説明
詳細については、「Python 用 Tablestore SDK のバージョン履歴」をご参照ください。
時系列テーブルの構成情報 (timeseries_table_options) と時系列メタデータ (timeseries_meta_options) を同時に変更することはできません。1 回の呼び出しで変更できるのは、どちらか一方のみです。

前提条件

Tablestore クライアントが初期化されていること。詳細については、「Tablestore クライアントの初期化」をご参照ください。

パラメータ

パラメータ

説明

table_meta (必須)

時系列テーブルのスキーマ情報。スキーマ情報は、以下の項目で構成されます。

timeseries_table_name (必須): 時系列テーブルの名前。
timeseries_table_options (オプション): 時系列テーブルの構成情報。以下の項目で構成されます。
- time_to_live (必須): 時系列テーブルのデータの保持期間。単位: 秒。
  時系列テーブルのデータの最小保持期間は 86,400 秒 (1 日) です。 time_to_live を -1 に設定することもできます。これは、時系列テーブルのデータが期限切れにならないことを指定します。
timeseries_meta_options (オプション): 時系列メタデータの構成情報。以下の項目で構成されます。
- meta_time_to_live (必須): 時系列メタデータの保持期間。単位: 秒。
  時系列メタデータの最小保持期間は 604,800 秒 (7 日) です。 meta_time_to_live を -1 に設定することもできます。これは、時系列メタデータが期限切れにならないことを指定します。
  重要
  時系列メタデータの TTL 値は、時系列テーブルのデータの TTL 値以上である必要があります。
- allow_update_attributes (必須): 時系列メタデータの属性の更新を許可するかどうかを指定します。有効な値:
  重要
  - meta_time_to_live が -1 以外の値に設定されている場合、allow_update_attributes を False に設定する必要があります。これは、時系列メタデータの属性の更新が許可されないことを意味します。
  - allow_update_attributes を True に設定する場合は、meta_time_to_live の値が -1 であることを確認する必要があります。
  - True: 時系列メタデータの属性の更新を許可します。
  - False: 時系列メタデータの属性の更新を許可しません。

例

次のサンプルコードは、時系列テーブルの TTL を更新する方法の例を示しています。

try:
    # 時系列テーブルのデータの TTL を 604,800 秒 (7 日間) に設定します。
    tableOption = TimeseriesTableOptions(604800)
    tableMeta = TimeseriesTableMeta("", tableOption)

    # 時系列テーブルを更新する操作を呼び出します。
    otsClient.update_timeseries_table(tableMeta)
    print("update timeseries table success.")
except Exception as e:
    # 例外がスローされた場合、更新は失敗します。例外を処理します。
    print("update timeseries table failed. %s" % e)