Tablestore Python SDK を使用して 1 行のデータを書き込む方法 - Tablestore

Tablestore Python SDK を使用して、Tablestore のデータテーブルに 1 行のデータを書き込みます。

前提条件

メソッド

put_row(self, table_name, row, condition=None, return_type=None, transaction_id=None)

パラメーター

パラメーター	型	説明
table_name（必須）	str	データテーブルの名前です。
row（必須）	Row	書き込む行です。このパラメーターには以下の要素が含まれます。 primary_key（必須） `List[Tuple]`：プライマリキー列の名前と値。プライマリキー列のデータの型は、STRING、INTEGER、BINARY です。プライマリキー列の数およびデータの型は、データテーブルで定義されたものと一致している必要があります。プライマリキー列が自動インクリメント列の場合、その値にはプレースホルダーを指定します。詳細については、「自動採番主キー列」をご参照ください。 attribute_columns（必須） `List[Tuple]`：属性列の名前、値、およびデータバージョン。属性列のデータの型は、STRING、INTEGER、BINARY、DOUBLE、BOOLEAN です。データバージョンはタイムスタンプです。デフォルトでは Tablestore が自動的にバージョンを生成しますが、カスタムのバージョンを指定することもできます。詳細については、「データバージョンとデータライフサイクル」をご参照ください。
condition（任意）	Condition	書き込み操作の実行条件です。詳細については、「条件付き更新」をご参照ください。
return_type（任意）	ReturnType	返却するデータの種類です。 RT_NONE（デフォルト）：データは返却されません。 RT_PK：プライマリキー列を返却します。これは、自動採番主キー列の生成値を取得する際に有効です。
transaction_id（任意）	str	ローカルトランザクションの固有 ID です。詳細については、「ローカルトランザクション」をご参照ください。

サンプル

次のサンプルでは、プライマリキー値 row1 の行を test_table テーブルに書き込みます。

try:
    # プライマリキーおよび属性列を構築します。
    primary_key = [('id', 'row1')]
    attribute_columns = []

    # 書き込む行を構築します。
    row = Row(primary_key, attribute_columns)

    # put_row メソッドを呼び出して行を書き込みます。
    consumed, return_row = client.put_row('test_table', row)
    print('* 読み取り CU コスト: %s' % consumed.read)
    print('* 書き込み CU コスト: %s' % consumed.write)
except Exception as e:
    print("行の書き込みに失敗しました。エラー: %s" % e)

属性列を追加するには、以下のように記述します。
```
attribute_columns = [('col1','val1')]
```
データバージョンを指定するには、各属性列にバージョンを割り当てます。
```
attribute_columns = [('col1','val1', int(time.time() * 1000))]
```

参照

データの一括更新