Tablestore SDK for Python を使用してテーブルの構成を更新する方法 - Tablestore

Tablestore SDK for Python を使用して、生存時間 (TTL)、最大バージョン数、予約スループットなどのテーブル構成を更新します。

前提条件

作業を開始する前に、次の要件を満たしていることを確認してください。

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

メソッドの説明

def update_table(self, table_name, table_options=None, reserved_throughput=None)

パラメーター

table_name (必須) str：データテーブルの名前。

table_options (オプション) TableOptions：テーブルの構成。以下のパラメーターを含みます。

パラメーター	型	説明
time_to_live (オプション)	int	データの生存時間 (TTL)。単位は秒。デフォルト値：-1。 -1 を設定すると、データは無期限に保持されます。その他の値は 86400（1 日）以上である必要があります。TTL を超過したデータは自動的に削除されます。多次元インデックスまたはセカンダリインデックス機能を使用する場合は、このパラメーターを -1 に設定するか、allow_update を False に設定してください。
max_version (オプション)	int	最大バージョン数。デフォルト値：1。多次元インデックスまたはセカンダリインデックス機能を使用する場合は、このパラメーターを 1 に設定してください。
max_time_deviation (オプション)	int	最大タイムスタンプオフセット。単位は秒。デフォルト値：86400（1 日）。現在のシステム時刻と書き込まれたデータのタイムスタンプとの差が、このオフセット範囲内である必要があります。範囲外の書き込みは失敗します。属性列データの有効バージョン範囲は、`[max(データ書き込み時刻 - 最大バージョンオフセット, データ書き込み時刻 - TTL), データ書き込み時刻 + 最大バージョンオフセット)` です。
allow_update (オプション)	bool	行の更新を許可するかどうかを指定します。デフォルト値：True。 False を設定すると、`UpdateRow()` メソッドによる行の更新が禁止されます。

reserved_throughput (オプション) ReservedThroughput：予約読み取り/書き込みスループット。単位は容量単位 (CU)。デフォルト値：0。CU モードの高性能インスタンスでのみ適用されます。

説明

update_table() を呼び出す際には、table_options または reserved_throughput のいずれか少なくとも一方を指定する必要があります。

サンプルコード

次の例では、test_table の構成を更新します。

# テーブル構成を設定：TTL 1 日、最大バージョン数 3、最大タイムスタンプオフセット 1 日、更新を無効化
table_options = TableOptions(time_to_live=86400, max_version=3, max_time_deviation=86400, allow_update=False)

# 予約読み取り/書き込みスループットを 0 CU に設定
# 非ゼロ値は、CU モードの高性能インスタンスでのみサポートされます
reserved_throughput = ReservedThroughput(CapacityUnit(0, 0))

try:
    client.update_table('test_table', table_options, reserved_throughput)
    print("Update table succeeded.")
except Exception as e:
    print("Update table failed. %s" % e)

参照

時系列テーブルの更新