初始化

更新时间: 2023-07-20 16:04:12

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

确定Endpoint

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

  1. 登录表格存储控制台

  2. 单击实例名称进入实例详情页。

    实例访问地址即是该实例的Endpoint。

说明

关于Endpoint的更多信息,请参见服务地址

配置密钥

要接入阿里云的表格存储服务,您需要拥有一个有效的访问密钥进行签名认证。目前支持下面三种方式:

  • 阿里云账号的AccessKey ID和AccessKey Secret。创建步骤如下:

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

    2. 创建AccessKey ID和AccessKey Secret。具体操作,请参见获取AccessKey

  • 被授予访问表格存储权限的RAM用户的AccessKey ID和AccessKey Secret。创建步骤如下:

    1. 使用阿里云账号前往访问控制RAM,创建一个新的RAM用户或者使用已经存在的RAM用户。

    2. 使用阿里云账号授予RAM用户访问表格存储的权限。

    3. RAM用户被授权后,即可使用自己的AccessKey ID和AccessKey Secret访问。

  • 从STS获取的临时访问凭证。获取步骤如下:

    1. 应用的服务器通过访问RAM/STS服务,获取一个临时的AccessKey ID、AccessKey Secret和SecurityToken发送给使用方。

    2. 使用方使用上述临时密钥访问表格存储服务。

配置环境变量

请根据使用的操作系统执行相应操作配置环境变量。

表格存储使用OTS_AK_ENV环境变量名表示阿里云账号或者RAM用户的AccessKey ID,使用OTS_SK_ENV环境变量名表示对应AccessKey Secret,请根据实际配置。

  • Linux和macOS系统配置方法

    执行如下命令配置环境变量。其中<access_key_id>请替换为已准备好的AccessKey ID,<access_key_secret>请替换为对应的AccessKey Secret。

    export OTS_AK_ENV=<access_key_id>
    export OTS_SK_ENV=<access_key_secret>
  • Windows系统配置方法

    新建环境变量文件,并在文件中添加环境变量OTS_AK_ENV和OTS_SK_ENV,然后环境变量分别配置为已准备好的AccessKey ID和AccessKey Secret,最后重启Windows系统使配置生效。

初始化对接

获取到AccessKey ID和AccessKey Secret后,您可以按照下如下步骤进行初始化对接。

重要

阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。本示例以将AccessKey保存在环境变量中来实现身份验证为例介绍。

var OTS_AK_ENV = process.env.OTS_AK_ENV;
var OTS_SK_ENV = process.env.OTS_SK_ENV;
var client = new TableStore.Client({
    accessKeyId: OTS_AK_ENV,
    accessKeySecret: OTS_SK_ENV,
    endpoint: '<your endpoint>',
    instancename: '<your instance name>',
    maxRetries:20,//默认20次重试,可以省略此参数。
});
阿里云首页 表格存储 相关技术圈