Python SDK for Tablestore を使用してテーブルの設定を更新する - Tablestore

このトピックでは、パラメーターとサンプルコードを使用して、Python SDK for Tablestore を使用してテーブルの設定を更新する方法について説明します。データテーブルの有効期限 (TTL)、最大バージョン数、および最大バージョンオフセットを更新できます。また、ハイパフォーマンスインスタンスのデータテーブルの予約済み読み取りおよび書き込みスループットを更新することもできます。

前提条件

OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスを初期化するを参照してください。
データテーブルが作成されていること。詳細については、データテーブルを作成するを参照してください。

API 操作

"""
table_options または reserved_throughput を使用してデータテーブルの設定を更新します。
"""
def update_table(self, table_name, table_options, reserved_throughput):

パラメーター

詳細については、パラメーターを参照してください。

例

データテーブルの設定を更新する

次のサンプルコードは、データテーブルの設定を更新する方法の例を示しています。

# table_options インスタンスを作成します。テーブル内のデータの TTL を 31,536,000 秒に設定します。テーブル内のデータの保存期間が TTL 値を超えると、データは自動的に削除されます。テーブルの各属性列に最大 5 つのバージョンのデータを保持できること、およびデータの書き込み時に現在のシステム時刻と指定されたデータバージョンの最大差が 1 日であることを指定します。
table_options = TableOptions(31536000, 5, 86400)

try:
    # UpdateTable 操作を呼び出して、テーブルの予約済み読み取りまたは書き込みスループットを更新します。
    ots_client.update_table('SampleTable', table_options, None)
    # 例外がスローされない場合、更新は成功です。
    print("update table succeeded")
except Exception:
    # 例外がスローされた場合、更新は失敗です。例外を処理します。
    print("update table failed")

ハイパフォーマンスインスタンスのデータテーブルの予約済みスループットを更新する

次のサンプルコードは、ハイパフォーマンスインスタンスのデータテーブルの予約済みスループットを更新する方法の例を示しています。

# 新しい予約済み読み取りスループットを 1 に、新しい予約済み書き込みスループットを 1 に設定します。容量インスタンスのデータテーブルの場合、予約済み読み取りおよび書き込みスループットを 0 にのみ設定できます。
reserved_throughput = ReservedThroughput(CapacityUnit(1, 1))

try:
    client.update_table('<TABLE_NAME>', None, reserved_throughput)
    print("update table succeeded.")
except Exception:
    print("update table failed.")

参照

API 操作の詳細については、UpdateTableを参照してください。
テーブルの設定を更新した後、次の操作を実行できます。
- テーブルに対する操作。詳細については、テーブルに対する操作を参照してください。
- データに対する操作。詳細については、データに対する基本操作を参照してください。