表格存储：通过命令行工具使用

步骤一：下载并启动命令行工具

1. 根据所用平台下载命令行工具。

   平台	下载地址
   Windows	Windows10
   Linux	Linux（AMD64） Linux（ARM64）
   macOS	macOS

2. 解压缩下载的工具包，进入命令行工具根目录后，根据所用平台选择相应方式启动命令行工具。
   • 对于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>

步骤二：开通表格存储服务

如果已经开通表格存储服务，请跳过此操作。服务仅需开通一次，开通过程免费。

1. 通过config命令配置AccessKey信息。
   重要 此处必须使用阿里云账号的AccessKey（包括AccessKey ID和AccessKey Secret）。关于获取AccessKey的具体操作，请参见获取AccessKey。

   config --id NTSVLeBHzgX2iZfcaXXPJ**** --key 7NR2DiotscDbauohSq9kSHX8BDp99bjs7eNpCR7o****

2. 执行enable_service命令，开通表格存储服务。

步骤三：创建时序模型实例

具体操作，请参见创建时序模型实例。

步骤四：配置接入信息

通过config命令配置接入信息。

执行以下命令，使用已创建的myinstance实例配置接入信息。

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

步骤五：创建并使用时序表

创建时序表后，选择要进行操作的时序表，用于后续表操作或者数据操作。

1. 执行以下命令，创建mytable时序表。

   create -m timeseries -t mytable --ttl -1

2. 执行use --ts -t mytable命令，使用mytable时序表。

步骤六：数据操作

根据需要进行数据操作，您可以写入时序数据、导入时序数据、查询时序数据、检索时间线、扫描时间线以及更新时间线。

• 写入时序数据

  插入一行时序数据。

  putts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --field '[{"c":"fieldname","v":"fieldvalue"},{"c":"bool_field","v":true},{"c":"double_field","v":1.1},{"c":"int_value","v":10,"isint":true}]' --time 1635162859000000

• 导入时序数据

  导入import_timeseries.txt文件中的时序数据到时序表中。

  import_timeseries --input /temp/import_timeseries.txt

  配置文件的示例如下：

  cpu,hostname=host_0,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000
  cpu,hostname=host_1,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000

• 查询时序数据

  查询度量名称为cpu，数据源标识为localhost，且标签为"region=hangzhou"和"os=ubuntu"的时间线中1667638230000000之前产生的所有时序数据。

  getts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --time_start 0 --time_end 1667638230000000 --limit 100

• 检索时序线
  检索度量名称为cpu且数据源标识为localhost的时间线。

  query_ts_meta --measurement cpu --datasource localhost --limit 10

• 扫描时间线

  query_ts_meta --limit 10

• 更新时间线

  更新指定时间线的属性为"city=nanjing"和"region=jiangning"。

  update_ts_meta --k '["cpu","localhost",["city=hangzhou","region=xihu"]]' --attrs '["city=nanjing","region=jiangning"]' 

步骤七：使用SQL查询数据

如果要使用SQL语句快速查询表中数据，请执行以下步骤：

1. 执行sql命令，进入SQL模式。
2. 执行以下命令，查询mytable表中所有数据。

   SELECT * FROM mytable;

如果要退出SQL模式，请执行exit;命令。