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

确定 Endpoint

Endpoint 是阿里云表格存储服务在各个区域的域名地址,目前支持下列形式。

Endpoint 类型 解释
区域地址 使用表格存储实例(Instance)所在的区域地址,如https://instance.cn-hangzhou.ots.aliyuncs.com

表格存储的区域地址

使用表格存储实例的所在区域地址,可以通过以下方式查询 Endpoint:

  1. 登录表格存储控制台
  2. 进入 Instance 概览页,实例访问地址即是该实例的 Endpoint。

配置密钥

要接入阿里云的表格存储服务,您需要拥有一个有效的 Access Key(包括 AccessKeyId 和 AccessKeySecret),用来进行签名认证。可以通过如下步骤获得:

  1. 在阿里云官网注册阿里云帐号
  2. 登录AccessKey管理控制台创建 AccessKeyId 和 AccessKeySecret。

在获取到 AccessKeyId 和 AccessKeySecret 之后,您可以按照下面步骤进行初始化对接。

使用表格存储的 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 对象。