文档

Python前言

更新时间:

本文介绍表格存储Python SDK的使用流程、下载和版本兼容性。

使用流程

表格存储提供了宽表模型、时序模型、消息模型等多种数据模型,表格存储Python SDK只支持使用宽表模型的功能操作。

宽表模型的一般使用流程如下:

  1. 初始化客户端用于配置访问的表格存储实例。更多信息,请参见Python初始化客户端

  2. 创建数据表用于存储数据。更多信息,请参见表操作

  3. 读写表中数据。更多信息,请参见基础数据操作

  4. 使用索引加速数据查询。更多信息,请参见多元索引二级索引

  5. 使用SQL查询数据。更多信息,请参见SQL查询

SDK下载

通过GitHub下载,具体下载地址请参见SDK包

关于SDK版本迭代的更多信息,请参见Python SDK历史迭代版本

版本兼容性

当前最新版本为5.x.x版本,新版本对历史版本的兼容性如下:

  • 对5.x.x系列的SDK兼容。

    5.4.x版本、5.3.x版本和5.2.x版本兼容。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值。

关于SDK版本迭代的更多信息,请参见Python SDK历史迭代版本

参考文档

  • 本页导读 (1)
文档反馈