初始化

确定Endpoint

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

1. 登录表格存储控制台。

2. 单击实例名称进入实例详情页。

   实例访问地址即是该实例的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. 使用方使用上述临时密钥访问表格存储服务。

配置环境变量

请根据使用的操作系统执行相应操作配置环境变量。

表格存储使用OTS_AK_ENV环境变量名表示阿里云账号或者RAM用户的AccessKey ID，使用OTS_SK_ENV环境变量名表示对应AccessKey Secret，请根据实际配置。

• Linux和macOS系统配置方法

  执行如下命令配置环境变量。其中<access_key_id>请替换为已准备好的AccessKey ID，<access_key_secret>请替换为对应的AccessKey Secret。

  export OTS_AK_ENV=<access_key_id>
  export OTS_SK_ENV=<access_key_secret>

• Windows系统配置方法

  新建环境变量文件，并在文件中添加环境变量OTS_AK_ENV和OTS_SK_ENV，然后环境变量分别配置为已准备好的AccessKey ID和AccessKey Secret，最后重启Windows系统使配置生效。

初始化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                   

• 示例

  access_key_id := os.Getenv("OTS_AK_ENV")
  access_key_secret := os.Getenv("OTS_SK_ENV")
  client = tablestore.NewClient("your_instance_endpoint",  "your_instance_name", access_key_id, access_key_secret)          

初始化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

• 示例

  access_key_id := os.Getenv("OTS_AK_ENV")
  access_key_secret := os.Getenv("OTS_SK_ENV")
  timeseriesClient = tablestore.NewTimeseriesClient("your_instance_endpoint",  "your_instance_name", access_key_id, access_key_secret)