初始化
Client是表格存储服务的客户端,它为调用者提供了一系列的方法,可以用来操作表、单行数据、多行数据等。
确定Endpoint
Endpoint是阿里云表格存储服务在各个区域的域名地址,您可以通过以下方式查询Endpoint:
登录表格存储控制台。
单击实例名称进入实例详情页。
实例访问地址即是该实例的Endpoint。
关于Endpoint的更多信息,请参见服务地址。
配置密钥
要接入阿里云的表格存储服务,您需要拥有一个有效的访问密钥进行签名认证。目前支持下面三种方式:
阿里云账号的AccessKey ID和AccessKey Secret。创建步骤如下:
在阿里云官网注册阿里云账号。
创建AccessKey ID和AccessKey Secret。具体操作,请参见获取AccessKey。
被授予访问表格存储权限的RAM用户的AccessKey ID和AccessKey Secret。创建步骤如下:
使用阿里云账号前往访问控制RAM,创建一个新的RAM用户或者使用已经存在的RAM用户。
使用阿里云账号授予RAM用户访问表格存储的权限。
RAM用户被授权后,即可使用自己的AccessKey ID和AccessKey Secret访问。
从STS获取的临时访问凭证。获取步骤如下:
应用的服务器通过访问RAM/STS服务,获取一个临时的AccessKey ID、AccessKey Secret和SecurityToken发送给使用方。
使用方使用上述临时密钥访问表格存储服务。
配置环境变量
请根据使用的操作系统执行相应操作配置环境变量。
表格存储使用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次重试,可以省略此参数。
});