OTSClient 是表格存储服务的客户端,它为调用者提供了一系列的方法,可以用来操作表、单行数据、多行数据等。

确定 Endpoint

Endpoint 是阿里云表格存储服务在各个区域的域名地址,目前支持下列形式。

Endpoint 类型 解释
区域地址 使用表格存储实例(Instance)所在的区域地址,如 https://instance.cn-hangzhou.ots.aliyuncs.com

表格存储的区域地址

使用表格存储实例所在的区域地址,可以通过以下方式查询 Endpoint:

  1. 登录表格存储控制台
  2. 进入实例详情页,实例访问地址即是该实例的 Endpoint。

配置密钥

要接入表格存储服务,您需要拥有一个有效的 Access Key(包括 AccessKeyId 和 AccessKeySecret)用来进行签名认证。可以通过如下步骤获得:
  1. 在阿里云官网注册阿里云帐号
  2. 登录AccessKey管理控制台创建 AccessKeyId 和 AccessKeySecret。

在获取到 AccessKeyId 和 AccessKeySecret 之后,您可以使用表格存储的 Endpoint 进行初始化对接,如下所示:

接口:

        """
        初始化``OTSClient``实例。
        ``end_point``是表格存储服务的地址(例如 'https://instance.cn-hangzhou.ots.aliyun.com:80'),必须以'https://'开头。
        ``access_key_id``是访问表格存储服务的 AccessKeyID,通过官方网站申请或通过管理员获取。
        ``access_key_secret``是访问表格存储服务的AccessKeySecret,通过官方网站申请或通过管理员获取。
        ``instance_name``是要访问的实例名,通过官方网站控制台创建或通过管理员获取。
		``sts_token``是访问表格存储服务的STS token,从阿里云STS服务获取,具有有效期,过期后需要重新获取。
        ``encoding``请求参数的字符串编码类型,默认是 utf8。
        ``socket_timeout``是连接池中每个连接的 Socket 超时,单位为秒,可以为 int 或 float。默认值为 50。
        ``max_connection``是连接池的最大连接数。默认为 50。
        ``logger_name``用来在请求中打 DEBUG 日志,或者在出错时打 ERROR 日志。
        ``retry_policy``定义了重试策略,默认的重试策略为 DefaultRetryPolicy。你可以继承 RetryPolicy 来实现自己的重试策略,请参考 DefaultRetryPolicy 的代码。
        """
		class OTSClient(object):
			def __init__(self, endpoint, access_key_id, access_key_secret, instance_name, **kwargs):

示例:

	#########    设置日志文件名称和重试策略     #########
	# 日志文件名称为 table_store.log,重试策略是 WriteRetryPolicy,会对写重试。
	ots_client = OTSClient('endpoint', 'access_key_id', 'access_key_secret', 'instance_name', logger_name = 'table_store.log',  retry_policy = WriteRetryPolicy())
	
	
	#########    使用STS     #########
	ots_client = OTSClient('endpoint', 'STS.K8h*******GB77', 'CkuDj******Wn6', 'instance_name', sts_token = 'CAISjgJ1q6Ft5B2y********OFcsLLuw==')

HTTPS

  • 从 2.0.8 版本开始支持 HTTPS。

  • openssl 版本最少为 0.9.8j,推荐 OpenSSL 1.0.2d。

  • python 2.0.8 发布包中包含了 certifi 包直接安装使用。如果需要更新根证书请从根证书下载最新的根证书。