---
id: tablestore
version: "6.4.8"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# tablestore — Aliyun TableStore(OTS) SDK

License: permissive · Maintenance: active · Downloads: 107.6K/mo

## What it is and what it does

Tablestore is the official Python client for Aliyun Tablestore (OTS), a cloud-hosted NoSQL database built on Aliyun's distributed infrastructure. It provides a full-featured API for creating and managing tables, performing single-row and batch read/write operations, scanning ranges of data, managing transactions, and executing advanced queries including full-text search and vector retrieval. The SDK abstracts the HTTP protocol layer and handles serialization via protobuf and flatbuffers, making it straightforward to integrate Tablestore into Python applications.

The package is designed for applications that need to store and query large volumes of structured data with real-time access patterns. It supports modern Python versions (3.8 through 3.14) and includes both synchronous and asynchronous HTTP clients. Common use cases include time-series data ingestion, user profile storage, event logging, and search-enabled data retrieval. The SDK is actively maintained and carries no known security vulnerabilities.

Use it for:

- Store and query time-series metrics or event logs at scale with range-scan and aggregation capabilities.
- Implement full-text search over product catalogs or document collections using the multi-element index feature.
- Perform vector similarity search for recommendation or semantic-matching workloads.
- Batch ingest or export large datasets with multi-table batch read/write operations.
- Build transactional workflows with local transaction support for multi-row consistency.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for Aliyun Tablestore (OTS), a managed NoSQL database service, enabling read, write, batch operations, range scans, transactions, and full-text or vector search on structured data.

Yes, if you are already committed to Aliyun Tablestore as your data store. The SDK is actively maintained, permissively licensed, has low install friction, and carries no known vulnerabilities. It is the canonical way to access Tablestore from Python. However, it is only useful if you have an Aliyun account and an active Tablestore instance; it is not a general-purpose database client.

## Install

pip install tablestore
uv add tablestore
poetry add tablestore

## Installing tablestore

Before you install: Low install friction with a pure-wheel distribution. Actively maintained as of 35 days ago. Depends on common, stable libraries (protobuf, urllib3, certifi, numpy, aiohttp) with no known compiled-extension blockers beyond what aiohttp and numpy typically require.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and redistribution with minimal restrictions—no copyleft obligations or proprietary constraints.

Quickstart:

pip install tablestore

from tablestore import OTSClient

client = OTSClient(
    endpoint='http://your-instance.cn-hangzhou.ots.aliyuncs.com',
    access_key_id='your_key_id',
    access_key_secret='your_key_secret',
    instance_name='your_instance'
)
response = client.get_row('table_name', [('pk_col', 'value')])

Requires valid Aliyun account credentials and an active Tablestore instance endpoint; Python 3.8 or later.

Verify before relying:

- Whether the SDK supports async operations natively or only via aiohttp integration
- Performance characteristics and throughput limits for batch operations at scale
- Whether vector search requires additional setup beyond the SDK (e.g., index configuration in Aliyun console)

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 107.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aliyun tablestore sdk, nosql database python client, aliyun ots python, managed table storage api, batch write read operations, full-text vector search, distributed data storage, aliyun-cloud, nosql, managed-service

[View on SkillFed](https://skillfed.io/packages/tablestore) · [View on PyPI](https://pypi.org/project/tablestore/)