表格存储Tablestore提供了管理控制台、命令行工具(Tablestore CLI)和Tablestore SDK三种访问方式。通过命令行工具,您可以使用简单的命令快速体验表格存储服务。本文介绍了如何通过Tablestore CLI管理时序模型。

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

  1. 根据所用平台下载命令行工具。
    平台 下载地址
    Windows Windows10
    Linux
    Mac Mac
  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;命令。