全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
表格存储

初始化

更新时间:2017-11-14 16:37:08

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

确定 Endpoint

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

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

表格存储的区域地址

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

  1. 登录阿里云表格存储控制台

  2. 进入 Instance 概览页,实例访问地址即是该实例的 Endpoint。

配置密钥

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

  1. 在阿里云官网注册阿里云帐号

  2. 登录 AccessKey 的管理控制台申请 AccessKey。

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

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

    接口:

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

    示例:

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

    提示:

    • OTSClientConfig 中还可以设置 ConnectionLimit。如果不设,默认值是 300。

    • OTSClientConfig 中的 OTSDebugLogHandler 和 OTSErrorLogHandler 控制日志行为,用户可以自定义。

    • OTSClientConfig 中的 RetryPolicy 控制重试逻辑,目前有默认重试策略,用户也可以自定义重试策略。

多线程

  • 支持多线程。

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

本文导读目录