启动并配置接入信息

前提条件

• 当要配置AccessKey信息用于进行开通表格存储服务时，请使用阿里云账号的AccessKey进行操作。具体操作，请参见创建AccessKey。

• 当要使用AccessKey配置接入的实例进行功能操作时，请确保已创建RAM用户并为RAM用户授予管理表格存储权限（AliyunOTSFullAccess）以及已为RAM用户创建AccessKey。具体操作，请参见创建RAM用户、为RAM用户授权和创建AccessKey。

  警告

  阿里云账号AccessKey泄露会威胁您所有资源的安全。建议您使用RAM用户AccessKey进行操作，可以有效降低AccessKey泄露的风险。

• 已下载命令行工具。具体操作，请参见下载命令行工具。

操作步骤

1. 解压缩下载的工具包，进入命令行工具根目录后，根据所用平台选择相应方式启动命令行工具。

   • 对于Windows平台，双击ts.exe文件。

   • 对于Linux和Mac平台，执行./ts命令。

     说明

     如果在Linux系统或者Mac系统下无可执行权限，请执行chmod 755 ts命令赋权后再启动命令行工具。

   启动界面如下所示。

   # Welcome to use Command Line Tool for Aliyun Tablestore. Current Version is '2021-11-11'.
   #    _______      _      _              _
   #   |__   __|    | |    | |            | |
   #      | |  __ _ | |__  | |  ___   ___ | |_   ___  _ __    ___
   #      | | / _' || '_ \ | | / _ \ / __|| __| / _ \ | '__| / _ \
   #      | || (_| || |_) || ||  __/ \__ \| |_ | (_) || |   |  __/
   #      |_| \__,_||_.__/ |_| \___| |___/ \__| \___/ |_|    \___|
   #
   # Please visit our product website: https://www.aliyun.com/product/ots
   # You can also join our DingTalk Chat Group (ID: 11789671 or 23307953) to discuss and ask Tablestore related questions.
   #
   tablestore>

2. 配置接入信息。

   • 如果开通表格存储服务或者未创建实例，则只需配置AccessKey信息即可。

     配置示例如下：

     config --id NTS********************** --key 7NR2****************************************

   • 如果已创建实例，则可以在配置AccessKey的同时配置要接入的实例信息。

     配置示例如下：

     config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id NTS********************** --key 7NR2****************************************

     如果要通过临时授权访问表格存储，您可以使用从STS服务获取的临时访问凭证进行接入信息配置。配置示例如下：

     config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id NTS********************** --key 7NR2**************************************** --token STS.6MC2****************************************

   配置项说明请参见下表。

   配置项	是否必填	示例值	说明
   --endpoint	否	https://myinstance.cn-hangzhou.ots.aliyuncs.com	实例的服务地址。更多信息，请参见服务地址。如果使用已存在的实例时，才需要配置此项。
   --instance	否	myinstance	实例名称。如果使用已存在的实例时，才需要配置此项。
   --id	是	NTS**********************	阿里云账号或者RAM用户的AccessKey ID和AccessKey Secret。 说明 当使用从STS获取的临时访问凭证访问表格存储时，请设置为临时访问凭证的AccessKey ID和AccessKey Secret。
   --key	是	7NR2****************************************
   --token	否	STS.6MC2****************************************	临时访问令牌。当使用从STS获取的临时访问凭证访问表格存储时，需要设置此参数。

相关文档

• 如果未开通表格存储服务，则在使用表格存储功能前开通表格存储服务。具体操作，请参见开通表格存储服务。

• 如果未创建实例，则需要先创建实例，然后配置实例的接入信息。具体操作，请参见实例操作。

• 如果已配置实例的接入信息，您可以根据业务所需的数据存储模型使用表格存储功能。

  数据模型	使用流程
  宽表模型	创建数据表用于存储数据。具体操作，请参见数据表操作。 读写表中数据。具体操作，请参见数据表操作。 使用索引加速数据查询。具体操作，请参见二级索引和多元索引。 使用SQL查询数据。具体操作，请参见SQL查询。 如果要迁移数据或者使用计算引擎处理数据，请使用通道服务实现。更多信息，请参见通道服务。
  时序模型	创建时序表用于存储数据。具体操作，请参见时序表操作。 读写表中数据以及根据需要检索时间线。具体操作，请参见时序表操作。 使用SQL查询数据。具体操作，请参见SQL查询。