OTSClient是表格存储服务的客户端,它为调用者提供了一系列的方法,可以用来操作表、读写单行数据、读写多行数据等。
确定Endpoint
Endpoint是阿里云表格存储服务各个实例的域名地址,目前支持下列形式。
示例 | 解释 |
---|---|
http://sun.cn-hangzhou.ots.aliyuncs.com | HTTP协议,公网网络访问杭州区域的sun实例。 |
https://sun.cn-hangzhou.ots.aliyuncs.com | HTTPS协议,公网网络访问杭州区域的sun实例。 |
注意 除了公网可以访问外,也支持私网地址。更多请参见服务地址。
请按照如下步骤获取实例的Endpoint:
配置密钥
要接入阿里云的表格存储服务,您需要拥有一个有效的访问密钥进行签名认证。目前支持下面三种方式:
- 主帐号的AccessKey ID和AccessKey Secret。创建步骤如下:
- 在阿里云官网注册阿里云账号。
- 登录AccessKey管理控制台创建AccessKey ID和AccessKey Secret。
- 被授予访问表格存储权限的子帐号的AccessKey ID和AccessKey Secret。创建步骤如下:
- 使用主帐号前往访问控制RAM,创建一个新的子帐号或者使用已经存在的子帐号。
- 使用主帐号授予子帐号访问表格存储的权限。
- 子帐号被授权后,即可使用自己的AccessKey ID和AccessKey Secret访问。
- 从STS获取的临时访问凭证。获取步骤如下:
- 应用的服务器通过访问RAM/STS服务,获取一个临时的AccessKey ID、AccessKey Secret和SecurityToken发送给使用方。
- 使用方使用上述临时密钥访问表格存储服务。
初始化对接
- 接口
""" 初始化``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包直接安装使用。如果需要更新根证书请从根证书下载最新的根证书。