本文介紹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()方法實現。

  • 對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。