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

确定 Endpoint

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

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

配置密钥

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

获取到 AccessKeyId 和 AccessKeySecret 后,您可以使用表格存储的 Endpoint 进行初始化对接。

使用表格存储的 Endpoint 新建 Client。

  • 接口
        /// <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对象
        var config = new OTSClientConfig(Endpoint, AccessKeyId, AccessKeySecret, InstanceName);
    
        // 禁止输出日志,默认是打开的
        config.OTSDebugLogHandler = null;
        config.OTSErrorLogHandler = null;
    
        // 使用OTSClientConfig创建一个OtsClient对象
        var otsClient = new OTSClient(config);
    
        // 使用otsClient插入或者查询数据
    					
说明
  • OTSClientConfig 中还可以设置 ConnectionLimit。如果不设,默认值是 300。
  • OTSClientConfig 中的 OTSDebugLogHandler 和 OTSErrorLogHandler 控制日志行为,可以自定义。
  • OTSClientConfig 中的 RetryPolicy 控制重试逻辑,目前有默认重试策略,也可以自定义重试策略。

多线程

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