Table Store Python SDK 建立資料表 - Tablestore

本文介紹如何通過Python SDK建立Table Store的資料表。

注意事項

建立資料表後，請等待資料表載入完成後再進行資料操作，否則資料操作會失敗，這個過程通常需要幾秒鐘。

前提條件

方法說明

def create_table(self, table_meta, table_options, reserved_throughput, secondary_indexes=[])

參數說明

table_meta（必選）TableMeta：表結構資訊，包含以下參數。

名稱	類型	說明
table_name（必選）	str	資料表名稱。
schema_of_primary_key（必選）	List[Tuple]	主鍵資訊。可以設定1~4個主鍵列，預設按升序進行排序，第一個主鍵列將作為分區鍵。主鍵資料類型包含STRING、INTEGER和BINARY，非分區鍵中整型的主鍵列可以設定主鍵列自增。
defined_columns（可選）	List[Tuple]	預定義列資訊。預定義列是預先定義的屬性列，可以用於建立二級索引和多元索引。預定義列資料類型包含STRING、INTEGER、BINARY、DOUBLE和BOOLEAN。

table_options（必選）TableOptions：表配置資訊，包含以下參數。

名稱	類型	說明
time_to_live（可選）	int	資料生命週期，單位為秒，預設值為-1。設定為-1時表示資料永不到期，否則取值最低為86400（1天），超出生命週期的資料將會被自動清除。如果要使用多元索引或二級索引功能，必須將資料生命週期設定為-1，或者將allow_update參數設定為False。
max_version（可選）	int	最大版本數，預設值為1。如果要使用多元索引或二級索引，最大版本數必須設定為1。
max_time_deviation（可選）	int	有效版本偏差，單位為秒，預設值為86400（1天）。寫入資料的時間戳記與系統目前時間的差值必須在有效版本偏差範圍內，否則寫入資料將會失敗。屬性列資料的有效版本範圍為`[max(資料寫入時間-有效版本偏差, 資料寫入時間-資料生命週期), 資料寫入時間+有效版本偏差)`。
allow_update（可選）	bool	是否允許更新，預設值為True。設定為False時，無法通過`update_row()`方法更新資料。

secondary_indexes（可選）List[SecondaryIndexMeta]：二級索引列表，每個索引包含以下參數。

名稱	類型	說明
index_name（必選）	str	索引名稱。
primary_key_names（必選）	List[str]	索引的主鍵列。可以由資料表的主鍵列和預定義列組成。使用本地二級索引時，索引第一個主鍵列必須是資料表的第一個主鍵列。
defined_column_names（可選）	List[str]	索引的預定義列。由資料表的預定義列組成。
index_type（可選）	SecondaryIndexType	索引類型，取值範圍： GLOBAL_INDEX（預設值）：全域二級索引。 LOCAL_INDEX：本地二級索引。

reserved_throughput（必選）ReservedThroughput：預留讀寫輸送量，單位為CU，預設值為0。僅CU模式的高效能型執行個體可以設定為非零值且有效。

範例程式碼

以下範例程式碼建立了一張test_table表，該表包含1個 String類型的主鍵。

# 建立資料表至少需要添加一個主鍵
schema_of_primary_key = [('id', 'STRING')]
# 構造資料表的結構資訊
table_meta = TableMeta('test_table', schema_of_primary_key)

# 構造資料表的配置資訊
table_options = TableOptions(time_to_live=-1, max_version=1, max_time_deviation=86400, allow_update=True)

# 建立資料表時必須設定預留讀寫輸送量，預設值為0（僅CU模式高效能執行個體支援設定資料表的預留讀寫輸送量為非零值）
reserved_throughput = ReservedThroughput(CapacityUnit(0,0))

try:
    # 發起請求
    client.create_table(table_meta, table_options, reserved_throughput)
    print("Create table succeeded.")
except Exception as e:
    print("Create table failed. %s" % e)

您也可以在建立資料表的同時參考範例程式碼進行以下設定。

添加預定義列

defined_columns = [('name', 'STRING')]
# 構建資料表的結構資訊
table_meta = TableMeta('test_table', schema_of_primary_key, defined_columns)

添加二級索引

# 構造二級索引列表
secondary_indexes = [
    # 設定索引名稱、索引主鍵列、索引預定義列、索引類型
    SecondaryIndexMeta('test_table_index', ['id', 'name'], [], index_type= SecondaryIndexType.LOCAL_INDEX)
]
# 發起請求
client.create_table(table_meta, table_options, reserved_throughput, secondary_indexes)

Tablestore：建立資料表

注意事項

前提條件

方法說明

範例程式碼

相關文檔