前提條件

• 已下載命令行工具。具體操作，請參見下載命令行工具。

• 獲取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獲取的臨時訪問憑證訪問表格存儲時，需要設置此參數。

相關文檔

• 如果您想了解什么是RAM用戶以及如何使用RAM用戶進行企業身份和權限管理，請參見什么是RAM用戶。

• 如果您需要開通表格存儲服務，請參見開通表格存儲服務。

• 如果您需要創建表格存儲實例，請參見實例操作。

• 如果您已經創建了表格存儲實例并在命令行工具中配置了實例的接入信息，您可以根據業務所需的數據模型使用表格存儲功能。

  數據模型	相關操作
  寬表模型	創建數據表及表相關操作，請參見數據表操作。 使用索引加速數據查詢，請參見二級索引和多元索引。 使用SQL查詢數據，請參見SQL查詢。 如果要遷移數據或者使用計算引擎處理數據，請使用通道服務實現。更多信息，請參見通道服務。
  時序模型	創建時序表及表相關操作，請參見時序表操作。 使用SQL查詢數據，請參見SQL查詢。