Table Store Python SDK 寫入單行資料 - Tablestore

本文介紹如何通過 Python SDK 在Table Store的資料表中寫入單行資料。

前提條件

方法說明

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。資料版本號碼即時間戳記，預設由系統自動產生，也可以自行指定，詳情請參見資料版本和生命週期。
condition（可選）	Condition	寫入條件，詳情請參見條件更新。
return_type（可選）	ReturnType	傳回型別。 RT_NONE：預設值，不返回資料。 RT_PK：返回主鍵列，可以用於主鍵列自增。
transaction_id（可選）	str	局部事務ID，用於唯一標識局部事務，詳情請參見局部事務。

範例程式碼

以下範例程式碼在 test_table 表中寫入一行資料，該行資料的主索引值為 row1。

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('* Read CU Cost: %s' % consumed.read)
    print('* Write CU Cost: %s' % consumed.write)
except Exception as e:
    print("Put row failed with error: %s" % e)

添加屬性列。
```
attribute_columns = [('col1','val1')]
```
指定資料版本號碼，您可以為每個屬性列指定單獨的版本號碼。
```
attribute_columns = [('col1','val1', int(time.time() * 1000))]
```

Tablestore：寫入單行資料

前提條件

方法說明

範例程式碼

相關文檔