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

确定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后,您可以按照下如下步骤进行初始化对接。

  • 接口
        /// <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对象。