启动并配置接入信息

前提条件

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

• 获取AccessKey信息。您需要在命令行工具中配置AccessKey信息来使用表格存储服务，请使用阿里云账号的AccessKey进行配置。获取AccessKey的具体操作，请参见创建AccessKey。

  重要

  出于安全考虑，除了开通表格存储服务操作，强烈建议您通过RAM用户使用表格存储功能。您可以创建RAM用户、授予该用户管理表格存储权限（AliyunOTSFullAccess）并为该RAM用户创建AccessKey。具体操作，请参见创建RAM用户、为RAM用户授权和创建AccessKey。

操作步骤

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

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

   2. 对于Linux和macOS平台，执行./ts命令。

   说明

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

   如果macOS系统提示无法打开“ts”，因为Apple无法检查其是否包含恶意软件，您需要在隐私与安全性中设置允许打开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获取的临时访问凭证访问表格存储时，需要设置此参数。 如果您需要将token配置为空，可以通过--token ""进行设置。

相关文档

• 如果您想了解什么是RAM用户以及如何使用RAM用户进行企业身份和权限管理，请参见什么是RAM用户。

• 如果您需要开通表格存储服务，请参见开通表格存储服务。

• 如果您需要创建表格存储实例，请参见实例操作。

• 如果您已经创建了表格存储实例并在命令行工具中配置了实例的接入信息，您可以根据业务所需的数据模型使用表格存储功能。

  数据模型	相关操作
  宽表模型	创建数据表及表相关操作，请参见数据表操作。 使用索引加速数据查询，请参见二级索引和多元索引。 使用SQL查询数据，请参见SQL查询。 如果要迁移数据或者使用计算引擎处理数据，请使用通道服务实现。更多信息，请参见通道服务。
  时序模型	创建时序表及表相关操作，请参见时序表操作。 使用SQL查询数据，请参见SQL查询。