表格存储：初始化

确定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. 使用方使用上述临时密钥访问表格存储服务。

初始化对接

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

• 接口

      /// <summary>
      /// OTSClient的构造函数。
      /// </summary>
      /// <param name="endPoint">OTS服务的地址（例如'https://instance.cn-hangzhou.ots.aliyun.com:80'），必须以'https://'开头。</param>
      /// <param name="accessKeyID">OTS的Access Key ID，通过官方网站申请。</param>
      /// <param name="accessKeySecret">OTS的Access Key Secret，通过官方网站申请。</param>
      /// <param name="instanceName">OTS实例名，通过官方网站控制台创建。</param>
  public OTSClient(string endPoint, string accessKeyID, string accessKeySecret, string instanceName);
  
      /// <summary>
      /// 通过客户端配置OTSClientConfig的实例来创建OTSClient实例。
      /// </summary>
      /// <param name="config">客户端配置实例</param>
      public OTSClient(OTSClientConfig config);
                      

• 示例
  说明

  • OTSClientConfig中还可以设置ConnectionLimit。如果不设置，默认值为300。
  • OTSClientConfig中的OTSDebugLogHandler和OTSErrorLogHandler控制日志行为，可以自定义。
  • OTSClientConfig中的RetryPolicy控制重试逻辑，目前有默认重试策略，也可以自定义重试策略。

      // 构造一个OTSClientConfig对象。
      var config = new OTSClientConfig(Endpoint, AccessKeyId, AccessKeySecret, InstanceName);
  
      // 禁止输出日志，默认是打开的。
      config.OTSDebugLogHandler = null;
      config.OTSErrorLogHandler = null;
  
      // 使用OTSClientConfig创建一个OtsClient对象。
      var otsClient = new OTSClient(config);
  
      // 使用otsClient插入或者查询数据。
                      

多线程

• 支持多线程。
• 使用多线程时，建议共用一个OTSClient对象。