通过控制台使用分析存储

表格存储控制台创建时序模型实例后,您可以在实例下创建分析存储并使用 SQL 查询时序数据。

注意事项

  • 时序分析存储功能从 2023 年 12 月 20 日正式开始收费。

  • 目前支持使用时序分析存储功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)和华北3(张家口)。

  • 只支持在时序模型实例中使用分析存储功能。

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

步骤一:创建时序模型实例

创建时序模型实例时,表格存储会自动为实例开启分析存储功能。

  1. 登录表格存储控制台

  2. 在页面上方,选择资源组和地域。

  3. 概览页面,单击创建时序模型实例

  4. 创建时序模型实例对话框,选择实例规格高性能型,配置实例名称并根据业务需求填写实例注释。

    重要
    • 单个阿里云账号最多可以创建 10 个实例。

    • 实例名称在同一地域内必须唯一,不同地域间的实例名称可以相同。

    实例的命名规范如下:

    • 长度在 3~16 字符之间。

    • 由英文字母、数字或短划线(-)组成,大小写不敏感。

    • 首字符必须为英文字母,末尾字符不能为短划线(-)。

    • 不能包含 aliayotstaobaoadmin 这几个单词。

  5. 单击确定

    创建的实例会显示在概览页面的实例列表中。

步骤二:创建分析存储

为时序表创建分析存储后,您可以使用分析存储快速查询与分析时序数据。您可以在创建时序表时创建默认分析存储或者自定义分析存储,也可以为已有时序表创建分析存储,请根据实际选择。

创建时序表时创建分析存储

  1. 进入实例管理页面。

    1. 登录表格存储控制台

    2. 在页面上方,选择资源组和地域。

    3. 概览页面,单击实例名称或者单击实例操作实例管理

  2. 实例管理页面的实例详情页签,单击时序表列表页签。

  3. 时序表列表页签,单击创建时序表

  4. 创建时序表对话框,根据下表说明配置时序表信息。

    参数

    描述

    时序表名称

    时序表的名称,用于在实例中唯一标识一张时序表。

    时序表名称必须由大小写字母、数字或下划线(_)组成,且只能以字母或下划线(_)开头,长度在 1~128 个字符之间。

    重要

    时序表名称不能与已存在的数据表名称和时序表名称重复。

    数据生命周期

    时序表中数据的过期时间,单位为秒。当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时,系统会自动清理超过数据生命周期的数据。

    重要

    在时序表中,系统判断数据产生时间以用户传入的时间列为准,并非数据写入表中的时间。

    取值必须大于等于 86400 秒(一天)或者必须为 -1(数据永不过期)。

  5. 创建时序表对话框,创建分析存储。

    重要

    一个时序表只能创建一个分析存储。

    创建分析存储开关默认已开启,请根据需要创建默认分析存储或者自定义分析存储。在创建时序表时创建的分析存储会自动同步时序表中的全量数据。

    • 如果需要创建默认分析存储,直接单击确定即可。

      默认分析存储的名称默认为 default_analytical_store,生命周期默认为 -1。

    • 如果要创建自定义分析存储,请打开高级选项开关并根据下表说明配置分析存储信息,单击确定

      参数

      说明

      分析存储名称

      分析存储的名称。分析存储的命名规范与时序表的命名规范一致。

      生命周期

      分析存储中数据的过期时间,单位为秒。当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时,系统会自动清理超过数据生命周期的数据。

      重要
      • 在分析存储中,系统判断数据产生时间以用户传入的时间列为准,并非数据写入表中的时间。

      • 分析存储的生命周期与时序表的数据生命周期互不影响。

      取值必须为 -1(数据永不过期)或者必须大于等于 2592000 秒(即 30天)的 int32 正整数。

    创建的时序表会显示在时序表列表页签中。

    创建时序表后,您可以通过 SDK 批量写入数据到时序表。写入时序表的数据会同时写入分析存储中。具体操作,请参见写入时序数据

为已有时序表创建分析存储

  1. 进入实例管理页面。

    1. 登录表格存储控制台

    2. 在页面上方,选择资源组和地域。

    3. 概览页面,单击实例名称或者单击实例操作实例管理

  2. 实例管理页面的实例详情页签,单击时序表列表页签。

  3. 时序表列表页签,单击时序表名。

  4. 基本详情页签的分析存储区域,单击创建分析存储

  5. 在创建分析存储对话框,根据下表说明配置分析存储信息。

    参数

    说明

    分析存储名称

    分析存储的名称。分析存储的命名规范与时序表的命名规范一致。

    生命周期

    时序表中数据的过期时间,单位为秒。当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时,系统会自动清理超过数据生命周期的数据。

    重要

    在时序表中,系统判断数据产生时间以用户传入的时间列为准,并非数据写入表中的时间。

    取值必须为 -1(数据永不过期)或者必须大于等于 2592000 秒(即 30天)的 int32 正整数。

    同步方式

    分析存储同步时序表中数据的方式。取值范围如下:

    • 全量同步:同步时序表中的存量数据和增量数据。

    • 增量同步:同步分析存储创建后时序表中增量变化的数据。

    重要

    同步方式设置后不支持修改,请谨慎选择。

  6. 单击确定

步骤三:使用 SQL 查询数据

创建分析存储的绑定关系后,使用 SELECT 语句查询与分析时序。

说明

关于 SQL 查询的更多信息,请参见 SQL 查询

  1. 进入时序表管理页面。

    1. 登录表格存储控制台

    2. 在页面上方,选择资源组和地域。

    3. 概览页面,单击实例名称或者单击实例操作实例管理

    4. 实例管理页面的实例详情页签,单击时序表列表页签。

    5. 时序表列表页签,单击时序表名称。

  2. 创建分析存储的绑定关系。

    1. 时序表管理页面的 SQL 查询页签,输入创建映射关系的 SQL 语句。

      SQL 示例如下:

      CREATE TABLE `device::cpu` 
      (`_m_name` VARCHAR(1024),
       `_data_source` VARCHAR(1024),
       `_tags` VARCHAR(1024),
       `_time` BIGINT(20), 
       `usage_user` BIGINT(20), 
       `usage_system` BIGINT(20), 
       `usage_idle` BIGINT(20), 
       `usage_nice` BIGINT(20), 
       `usage_iowait` BIGINT(20), 
       `usage_irq` BIGINT(20), 
       `usage_softirq` BIGINT(20), 
       `usage_steal` BIGINT(20),
       `usage_guest` BIGINT(20), 
       `usage_guest_nice` BIGINT(20),
       `one_hour_stamp` BIGINT(20),
       `one_minute_stamp` BIGINT(20),
       PRIMARY KEY(`_m_name`,`_data_source`,`_tags`,`_time`)) ENGINE=AnalyticalStore;
    2. 单击执行 SQL(F8)

      在页面左侧区域会显示创建的时序表绑定关系。

  3. 查询数据。

    1. SQL 查询页签,输入 SELECT 语句查询所需数据。更多示例请参见数据查询示例

      • 示例一:查询所有设备在 2023-01-05 05:14:002023-01-07 09:14:00 时间段内每天的最大 usage_irq 和最大 usage_softirq。

        SELECT time_bin(_time,"1day"), max(usage_irq),max(usage_softirq) 
        FROM `device::cpu` 
        WHERE _time > unix_timestamp_micros("2023-01-05 05:14:00.000000") 
        AND _time < unix_timestamp_micros("2023-01-07 09:14:00.000000") 
        GROUP BY 1 ORDER BY 1;
      • 示例二:查询在 host_50625 且 cpu 架构为 x64 的设备所有时间平均 usage_nice。

        SELECT avg(usage_nice) 
        FROM `device::cpu` 
        WHERE _data_source = "host_50625" 
        AND tag_value_at(_tags,"arch") = "x64";
    2. 单击执行 SQL(F8)

      符合条件的数据会显示在执行结果区域。查询结果支持以列表、折线图和直方图形式展示。

附录:管理分析存储

创建分析存储后,请根据实际需要执行相应操作。

操作

说明

更新分析存储的生命周期

当需要清理分析存储中的历史数据或者希望延长数据保存时间时,您可以更新分析存储的生命周期。

  1. 实例管理页面的实例详情页签,单击时序表列表页签。

  2. 时序表列表页签,单击时序表名。

  3. 基本详情页签的分析存储区域,单击分析存储操作列的编辑

  4. 更新分析存储对话框,修改分析存储生命周期。

    取值必须为 -1(数据永不过期)或者必须大于等于 2592000 秒(即 30天)的 int32 正整数。

  5. 单击确定

删除分析存储

当不再需要使用分析存储来低成本存储以及查询与分析时序数据时,您可以删除分析存储节约费用。

  1. 实例管理页面的实例详情页签,单击时序表列表页签。

  2. 时序表列表页签,单击时序表名。

  3. 基本详情页签的分析存储区域,单击分析存储操作列的删除

  4. 在弹出的对话框中,配置删除分析存储 SQL 映射表项,单击确定

    • 如果未创建使用分析存储查询的 SQL 映射表,删除分析存储 SQL 映射表开关保持默认配置即可。

    • 如果已创建使用分析存储查询的 SQL 映射表,请确保打开删除分析存储 SQL 映射表开关。在删除分析存储时,系统自动级联删除相应的 SQL 映射表。