前言

前提条件

• 已获取AccessKey（包括AccessKey ID和AccessKey Secret）。具体操作，请参见获取AccessKey。
• 已开通表格存储服务。具体操作，请参见开通表格存储服务。

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。