本文介紹Tablestore Python SDK的安裝和使用。
前提條件
- 已擷取AccessKey(包括AccessKey ID和AccessKey Secret)。具體操作,請參見擷取AccessKey。
- 已開通Tablestore服務。具體操作,請參見開通Tablestore服務。
SDK下載
通過GitHub下載,具體下載地址請參見SDK包。
關於SDK版本迭代的更多資訊,請參見Python SDK歷史迭代版本。
相容性
- 5.3.x版本和5.2.x版本相容。
- 對5.x.x系列的SDK相容。5.2.1和5.1.0在如下情況不相容:
- Search介面返回結果的類型。
5.1.0及以前版本的返回結果預設為Tuple類型。從5.2.0開始預設返回結果為SearchResponse對象,SearchResponse已實現__iter__方法,支援遍曆;如果需要返回Tuple類型的結果,請使用SearchResponse.v1_response()方法實現。
- 新增ParallelScan介面。
預設返回結果為ParallelScanResponse對象。如果需要返回Tuple類型的結果,請使用ParallelScanResponse.v1_response()方法實現。
- Search介面返回結果的類型。
- 對4.x.x系列的SDK相容。
- 對2.x.x系列的SDK不相容,原因是2.0系列版本中支援主鍵亂序,而4.0.0版本開始不允許主鍵亂序,涉及的不相容點包括:
- 包名稱由ots2變更為tablestore。
- Client.create_table介面新增TableOptions參數。
- put_row、get_row、update_row等介面的primary_key參數由dict類型變更為list類型,目的是保證主鍵的順序性。
- put_row、update_row等介面的attribute_columns參數由dict類型變更為list類型。
- put_row、update_row等介面的attribute_columns參數新增timestamp。
- get_row、get_range等介面新增max_version、time_range參數,這兩個參數必須存在一個。
- put_row、update_row、delete_row等介面新增return_type參數,目前僅支援RT_PK,表示傳回值中包含當前行PK值。
- put_row、update_row、delete_row等介面傳回值新增return_row,如果在請求中指定了return_type為RT_PK,則return_row中包含此行的PK值。
版本
當前最新版本為5.3.0。