文档

步骤一:创建SQL分析任务

更新时间:

本文介绍创建SQL分析任务的操作流程,以及SQL分析工作台的查询对象、SQL语句编写区域和操作栏的功能。

前提条件

已购买物联网平台的企业版实例,具体操作,请参见购买企业版实例

背景信息

您可以使用SQL分析工作台,配置SQL分析任务。更多信息,请参见SQL分析概述

创建SQL分析任务

  1. 物联网平台控制台实例概览页面,单击目标企业版实例ID或备注名称。

  2. 在左侧导航栏,选择数据服务 > 分析洞察

  3. 分析洞察页面,单击新建SQL分析

  4. 在弹出的对话框中,输入SQL分析任务的数据开发名称描述信息后,单击确定

    重要

    数据开发名称支持中文、数字、字母、下划线,长度不超过32个字符。

进入SQL数据服务工作台

  1. 物联网平台控制台实例概览页面,单击目标企业版实例ID或备注名称。

  2. 在左侧导航栏,选择数据服务 > 分析洞察

  3. 分析洞察页面,找到要配置的SQL分析任务后,单击右侧操作列的开发工作台

    进入SQL数据服务工作台后,各功能分布如下。
    SQL分析工作台

以下为工作台的详情信息。

工作台左侧:查询对象区域

双击以下各个页签下的数据表,可将其作为查询对象。

表类型

可选数据表

说明

相关文档

产品存储表

产品属性时序表

存储了设备上报至物联网平台的物模型属性、事件数据。

重要

数据归档存储成功后,在分析洞察的SQL数据服务工作台,无法再查询到对应的归档数据进行分析。如果需要在分析洞察中对已归档的数据进行查询和分析,可以撤销归档。具体操作,请参见下文撤销归档

时序和快照表

产品属性快照表

产品事件表

IoT孪生引擎时序表

存储了IoT孪生引擎对应孪生空间中孪生实体图中孪生节点的物模型属性数据。

IoT孪生引擎快照表

自定义存储表

事务表

存储了已完成自定义初始化配置的数据。即数据解析或SQL分析任务,调度任务后,输出至自定义存储表的数据。

重要

数据归档存储成功后,在分析洞察的SQL数据服务工作台,无法再查询到对应的归档数据进行分析。如果需要在分析洞察中对已归档的数据进行查询和分析,可以撤销归档。具体操作,请参见下文撤销归档

分区表

时序表

平台系统表

存储了产品、设备、设备分组、设备标签和设备位置等基本信息。

平台系统表

工作台右侧:SQL语句编写区域

功能

说明

运行按钮

单击此图标,运行编写的SQL语句。

  • 如果运行成功,可在编辑区域下方的运行日志结果输出结构页签下,分别查看运行SQL语句的日志、结果和输出字段的结构。

  • 如果运行失败,可在运行日志页签下,根据报错信息,解决问题后,重新运行。

停止

在运行SQL的过程中,单击此图标,可停止正在运行的SQL语句。

验证SQL

单击此图标,验证编写的SQL语句是否满足基本规范。

代码格式化

单击此图标,将编写的SQL语句格式化。例如:

  • 格式化前:

    SELECT `description`, `gmt_create` AS `gmt_create_alias`, `gmt_modified` AS `gmt_modified_alias`, `group_id`, `group_type`, `name` FROM ${system.device_group} LIMIT 5
  • 格式化后:

    SELECT `description`, `gmt_create` AS `gmt_create_alias`, `gmt_modified` AS `gmt_modified_alias`, `group_id`, `group_type`
        , `name`
    FROM ${system.device_group}
    LIMIT 5

运行日志

运行SQL语句后:

  • 如果运行失败,默认在此页签展示运行日志。

  • 如果运行成功,单击此处,查看运行日志。

结果

运行SQL语句成功后,默认在此页签展示查询结果。

说明

此处最多仅展示200条满足查询条件的数据。

工作台顶部:操作区域

功能

说明

image.png

完成SQL语句编写后,单击发布执行图标,设置SQL分析任务的执行策略并发布。

执行策略包括:

  • 结果存储表:将查询结果输出至指定的自定义存储表。

  • 数据写入策略:SQL分析任务在调度生产数据过程中,写入数据时的策略,默认主键覆盖,不支持修改。

  • 主键:数据的主键字段,显示自定义存储表的主键字段。

  • 调度策略生效日期:调度SQL分析任务的时间范围。

  • 调度周期:调度SQL分析任务的频率。

具体操作,请参见步骤三:设置任务调度策略并发布

撤销

单击撤销图标,撤销已发布的SQL分析任务。

保存

单击保存图标,保存当前配置的SQL分析任务。

快捷键

单击快捷键图标,查看快捷键。

Windows环境下,快捷键如下。如果环境为Mac,则将Ctrl替换为Command

  • 保存Ctrl+S

  • 运行Ctrl+Enter

  • 格式化Ctrl+F

  • 验证SQLCtrl+I

帮助

单击帮助图标,进入物联网数据服务帮助文档。

image.png
  • 提供SQL模板,帮助您快速编写SQL分析语句。

具体说明,请参见编写SQL语句

后续步骤

步骤二:编写SQL分析语句