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

确定Endpoint

Endpoint是阿里云表格存储服务在各个区域的域名地址,您可以通过以下方式查询Endpoint:

  1. 登录表格存储管理控制台。
  2. 单击实例名称进入实例详情页。
    实例访问地址即是该实例的Endpoint。
说明 关于Endpoint的详情请参见服务地址

配置密钥

要接入阿里云的表格存储服务,您需要拥有一个有效的访问密钥进行签名认证。目前支持下面三种方式:

  • 主帐号的AccessKey ID和AccessKey Secret。创建步骤如下:
    1. 在阿里云官网注册阿里云帐号
    2. 登录AccessKey管理控制台创建AccessKey ID和AccessKey Secret。
  • 被授予访问表格存储权限的子帐号的AccessKey ID和AccessKey Secret。创建步骤如下:
    1. 使用主帐号前往访问控制RAM,创建一个新的子帐号或者使用已经存在的子帐号。
    2. 使用主帐号授予子帐号访问表格存储的权限。
    3. 子帐号被授权后,即可使用自己的AccessKey ID和AccessKey Secret访问。
  • 从STS获取的临时访问凭证。获取步骤如下:
    1. 应用的服务器通过访问RAM/STS服务,获取一个临时的AccessKey ID、AccessKey Secret和SecurityToken发送给使用方。
    2. 使用方使用上述临时密钥访问表格存储服务。

初始化对接

获取到AccessKey ID和AccessKey Secret后,您可以按照下如下步骤进行初始化对接。

  • 接口
        //初始化``TableStoreClient``实例。
        //endPoint是表格存储服务的地址(例如'https://instance.cn-hangzhou.ots.aliyun.com:80'),必须以'https://'开头。
        //accessKeyId是访问表格存储服务的AccessKeyID,通过官方网站申请或通过管理员获取。
        //accessKeySecret是访问表格存储服务的AccessKeySecret,通过官方网站申请或通过管理员获取。
        //instanceName是要访问的实例名,通过官方网站控制台创建或通过管理员获取。
    func NewClient(endPoint, instanceName, accessKeyId, accessKeySecret string, options ...ClientOption) *TableStoreClient
                        
  • 示例
        client = NewClient("your_instance_endpoint",  "your_instance_name", "your_user_id", "your_user_key")