TableStoreClient是表格存储服务的客户端,它为调用者提供了一系列的方法,可以用来操作表、读写单行数据、读写多行数据等。如果要使用时序模型,您需要初始化TimeseriesClient。

确定Endpoint

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

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

配置密钥

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

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

初始化TableStoreClient

获取到AccessKey ID和AccessKey Secret后,您可以按照如下示例代码初始化TableStoreClient。

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

初始化TimeseriesClient

获取到AccessKey ID和AccessKey Secret后,您可以按照如下示例代码初始化TimeseriesClient。

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