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

确定Endpoint

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

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

配置密钥

要接入表格存储服务,需要创建Access Key(包括AccessKeyId和AccessKeySecret),并使用Access Key进行签名认证。

获取到AccessKeyId和AccessKeySecret后,使用表格存储的Endpoint进行初始化对接,示例如下。

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