全部产品
Search
文档中心

表格存储:通过命令行工具CLI使用时序模型

更新时间:Feb 04, 2024

表格存储提供了管理控制台、命令行工具(Tablestore CLI)和Tablestore SDK三种访问方式。通过Tablestore CLI使用表格存储时序模型(TimeSeries)时,您需要根据所用平台下载相应命令行工具,然后使用命令行工具进行开通表格存储服务、创建实例、配置接入实例信息、创建时序表、读写时序表中数据以及使用SQL查询数据的操作。

前提条件

已获取用于操作表格存储的阿里云账号或者RAM用户的登录信息。

如果未注册阿里云账号,您需要在阿里云官网注册阿里云账号

如果要使用RAM用户体验表格存储功能,您需要使用阿里云账号创建RAM用户并授予RAM用户访问表格存储的权限。具体操作,请参见通过RAM Policy为RAM用户授权

注意事项

  • 目前支持使用时序模型功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华北6(乌兰察布)、华南1(深圳)、中国香港、德国(法兰克福)、美国(弗吉尼亚)、印度(孟买)和新加坡。

  • 通过命令行工具只能创建按量模式下的高性能实例。如果要创建按量模式下的容量型实例,请通过控制台创建实例。具体操作,请参见创建实例或者创建时序模型实例

如果使用过程中遇到问题,请通过钉钉加入用户群44327024(物联网存储 IoTstore 开发者交流群)联系我们。

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

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

    平台

    下载地址

    Windows

    Windows10及之后版本

    Linux

    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 NTSVLeBHzgX2i************ --key 7NR2DiotscDbauohSq9kSHX8BDp9****************
  2. 执行enable_service命令,开通表格存储服务。

步骤三:创建实例

通过create_instance命令创建一个高性能实例。

执行以下命令,在华东1(杭州)地域创建myinstance实例,实例类型为高性能实例。

create_instance -d "First instance created by CLI." -n myinstance -r cn-hangzhou

步骤四:配置接入实例信息

通过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时序表。

步骤六:数据操作

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

  • 导入时序数据

    导入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,数据源标识为host_0,且标签为"hostname=host_0"和"region=cn-hangzhou"的时间线中1667638230000000之前产生的所有时序数据。

    getts --k '["cpu","host_0",["hostname=host_0","region=cn-hangzhou"]]' --time_start 0 --time_end 1667638230000000 --limit 100
  • 检索时序线

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

    query_ts_meta --measurement cpu --datasource host_0 --limit 10
  • 扫描时间线

    query_ts_meta --limit 10
  • 更新时间线

    更新指定时间线的属性为"hostname=host_1"和"region=cn-hangzhou"。

    update_ts_meta --k '["cpu","host_1",["hostname=host_1","region=cn-hangzhou"]]' --attrs '["hostname=host_1","region=cn-hangzhou"]' 

步骤七:使用SQL查询数据

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

  1. 执行sql命令,进入SQL模式。

  2. 根据需要查询mytable表中的数据。

    • 如果要检索时间线,选择时间线元数据映射表后,执行SELECT语句查询所需时间线。

      例如要查询时序元数据映射表mytable::meta中cpu度量类型下的时间线,SQL示例如下:

      SELECT * FROM `mytable::meta` WHERE _m_name = "cpu" LIMIT 100;
    • 如果要以单值模型查询时序数据,选择单值模型映射表后,执行SELECT语句查询满足条件的时序数据。

      例如要查询单值模型映射表mytable中cpu度量类型的数据,SQL示例如下:

      SELECT * FROM mytable WHERE _m_name = "cpu" LIMIT 10;
    • 如果要以多值模型查询时序数据,创建多值模型映射关系后,执行SELECT语句查询满足条件的时序数据。

      例如要查询多值模型映射表mytable::muti_model中cpu大于20.0的所有度量信息,SQL示例如下:

      SELECT usage_idle,usage_user,usage_system FROM `mytable::muti_model1` WHERE usage_idle > 20 LIMIT 10;

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

相关文档