tablestore 5.5.1

Aliyun TableStore(OTS) SDK

概述

• 此 Python SDK 基于 阿里云表格存储服务 API 构建。

• 阿里云表格存储是构建在阿里云飞天分布式系统之上的 NoSQL 数据存储服务，提供海量结构化数据的存储和实时访问。

运行环境

• 安装 Python 即可运行，支持 python3.8、Python3.9、python3.10、python3.11、python3.12。

安装方法

PIP安装

$ pip install tablestore

Github安装

1. 下载源码

$ git clone https://github.com/aliyun/aliyun-tablestore-python-sdk.git

2. 安装

$ python setup.py install

源码安装

1. 下载 SDK 发布包并解压

2. 安装

$ python setup.py install

示例代码

表（Table）示例：

• 表操作（表的创建、获取、更新和删除）

• 单行写（向表内写入一行数据）

• 单行读（从表内读出一样数据）

• 更新单行（更新某一行的部分字段）

• 删除某行（从表内删除某一行数据）

• 批量写（向多张表，一次性写入多行数据）

• 批量读（从多张表，一次性读出多行数据）

• 范围扫描（给定一个范围，扫描出该范围内的所有数据）

• 主键自增列（主键自动生成一个递增ID）

• 全局二级索引

• 局部事务（提交事务）

• 局部事务（舍弃事务）

多元索引（Search）示例：

• 基础搜索

• 并发圈选数据

• 全文检索

• 向量检索

• Max/Min/Sum/Avg/Count/DistinctCount 等

• GroupBy/Histogram 等

执行测试

注意：测试 case 中会有清理某个实例下所有表的动作，所以请使用专门的测试实例来测试。

1. 测试前准备

$ /bin/bash tests_setup.sh

2. 安装nosetests

$ pip install nose

3. 设置执行Case的配置

$ export OTS_TEST_ACCESS_KEY_ID=<your access key id>
$ export OTS_TEST_ACCESS_KEY_SECRET=<your access key secret>
$ export OTS_TEST_ENDPOINT=<tablestore service endpoint>
$ export OTS_TEST_INSTANCE=<tablestore instance name>

4. 运行case

python3.8、Python3.9、python3.10、python3.11可使用以下命令

$ export PYTHONPATH=$(pwd)/tests:$PYTHONPATH; nosetests tests/

python3.12可使用以下命令

$ /bin/bash tests_run.sh

编译proto文件

$ /bin/bash protoc.sh

贡献代码

• 我们非常欢迎大家为 Tablestore Python SDK 以及其他 Tablestore SDK 贡献代码。

• 非常感谢 @Wall-ee 对 4.3.0 版本的贡献。

联系我们

• 阿里云 Tablestore 官方网站

• 阿里云官网联系方式

• 阿里云 Tablestore 官方文档