可视化分析可以对物联网设备上报的属性、事件生成一个可视化分析表格。您可以编辑物分析表格,也可以根据物分析表格生成一个数据API,供其他应用程序调用。

前提条件

背景信息

物标签数据存储在物联网数据分析中,您无需自行接入。如果需要针对物联网设备数据进行全面的分析操作,可视化物分析很适合您。

有关物标签相关信息,请参见如何使用物标签

创建可视化物分析

  1. 登录数据分析控制台,在顶部导航栏上选择分析透视,单击可视化分析页签,进入可视化分析列表页,如下图所示。
    物分析列表页

    可视化分析列表页的搜索功能,支持模糊搜索历史创建好的可视化分析。

    单击列表中可视化分析卡片右上角的编辑图标,可执行克隆修改信息删除功能。

  2. 单击新建可视化分析,在新建可视化分析弹框中配置参数,如下图所示。
    新建物分析弹框
  3. 单击确认
    根据上一步选择的数据源,进入对应的可视化分析工作台。 本文以选择物标签为例。
    说明 本文图片所示为默认主题(亮色)。物联网数据分析支持设置工作台主题样式功能,您可单击工作台右上角的设置按钮设置,修改主题为暗色主题
    • 物标签物标签分析工作台
    • 数据表数据表分析工作台
  4. 单击选择产品,在添加产品对话框中选择需要添加的产品,如下图所示。
    物分析选择产品
    说明 产品下拉框最多显示最近创建的50个产品,您可以通过搜索产品名称,搜索到所有已创建的产品。
    产品添加完成后,您可以在下图所示的位置看到已选择产品的物标签,示例图如下所示。物分析标签显示区
    说明 基础标签(快照)、复合标签、基础标签(时序),这三类标签是系统自带的物标签,选择产品后,将展现在物标签列表中。勾选产品物标签后,可显示完整的可视化分析表格。

    标签列表上会显示已勾选的标签,并且在数据展示区显示该标签的物分析表格。

  5. 在左侧标签选择区中选择一个或多个物标签,如下图所示。
    查看物分析表格
    说明
    • 在标签选择区中,设备属性标签(时序)和设备属性标签(快照)不能同时被分析。
    • 在数据展示区中的可视化分析表格最多展示200条记录。如果想获取更多记录,请使用数据开发异步下载获得。
    • 参与可视化分析的标签数量越多,可能会影响查询耗时,如果分析任务超过一分钟未完成将被结束。
    • 重新选择或者取消标签后,筛选、重命名、数据聚合、排序及历史操作记录将被清空。

    在上图中1的位置,即标签列表上会显示已勾选的标签,并且在数据展示区显示该标签的物分析表格。您可以对物分析表格做以下的编辑操作。

    1. 在上图中2的位置,设置该物分析表格的时间区域。
    2. 在上图中3的位置,编辑物分析表格。
      • 单击重命名,可以重命名该列名称。
        说明
        • 重命名操作不支持对单个属性重命名两次。
        • 重命名操作不支持对多个属性重名成相同名字。
        • 重命名时,必须以字母(A_Z, a_z),且不包含特殊字符。
      • 单击筛选,在右侧弹框中输入筛选条件,可以筛选数据。

        示例:where t0_PM25 > ${quest}

        1. 输入筛选条件,示例:where t0_PM25 > ${quest},表示在该列(t0_PM25)中筛选出比请求参数(quest:您可以自定义设置)值大的所有数值。筛选参数配置
        2. 单击配置参数,在弹框中设置参数类型及默认值,如下图所示。设置筛选参数默认值
        3. 单击应用,可视化分析表格即可筛选出PM值大于200的所有数据。

        更多筛选操作表达式请参见MySQL WHERE

        说明
        • 筛选操作添加条件设置时必须以where开头。
        • 筛选操作添加了动态参数(动态参数名必须使用${}包裹,例如${quest})。
        • 筛选操作添加过动态参数后,必须指定默认参数,物分析才能展示表格数据。
        • 筛选操作不支持添加相同的动态参数名。
      • 单击数据聚合,可以将表格中的属性进行聚合,如下图所示。数据聚合参数配置
        聚合后,效果如下图所示:聚合后效果
        参数 说明
        请选择聚合列 选择聚合列,用以确定聚合的维度,可以根据需要选择多维度进行聚合。
        输入表达式,表达式的括号中填写需要聚合的列名,表示对某列进行聚合计算。

        可以是以下四种表达式:

        • sum(列名),对需要聚合的列在同一维度上进行求和。
        • max(列名),对需要聚合的列在同一维度上求最大值。
        • min(列名),对需要聚合的列在同一维度上求最小值。
        • avg(列名),对需要聚合的列在同一维度上求平均值。
        列名 填写您期望生成的列的名称,填写完成后会新生成一个包含该列数据的物分析表格。
        说明 属性参与聚合后默认属性不展示(如iot_id、product_key、event_time等),即会生成一个新的物分析表格。
      • 单击排序,可以将表格中的某一列进行正序或倒序的排列。
    3. 在上图中4的位置,可以查看以下内容。
      • 单击SQL预览,可以在“SQL预览”看到重命名、筛选、聚合、排序操作的历史记录,如下图所示。SQL预览效果
      • 单击显示操作历史记录,可以查看所有已生效的历史操作记录,如下图所示。历史操作记录预览效果
        说明 操作历史记录中支持编辑和删除功能,其中重命名的操作不支持修改和应用。
  6. 步骤 5图中5的位置,单击保存图标,保存该可视化分析表格。

生成一个数据API

数据API即数据服务,通过SDK调用数据API,可以方便地将数据嵌入到其他应用程序中进行可视化展现。关于更多数据API的信息请参见如何使用数据服务

  1. 参见创建可视化物分析中的步骤,在可视化分析工作台选择产品,并在物标签列表中勾选一个或多个设备属性。
  2. 在页面右上角单击配置图标,如下图所示。
    物分析API配置
  3. 在右侧弹框中,配置相关参数后单击应用
    物分析配置API
    参数 说明
    请求参数
    参数名 即在步骤5的子步骤2做筛选操作时您自己设定的请求参数。
    参数类型 筛选操作时设定的参数类型。
    是否必填 是,请勾选。
    示例值 筛选操作时设定的默认值。
    描述 可以描述该参数的作用,此项可填,也可不填。
    返回参数
    参数名 所有返回参数都可以在物分析工作台右上角SQL预览中看到。
    参数类型 根据返回值的类型,选填合适的数据类型。
    是否必填 可选,默认不勾选。
    示例值 可选,默认不需要设置。
    描述 以描述该参数的作用,此项可填,也可不填。
    高级设置 高级设置默认不展开。展开后,可选择是否开启返回结果分页
    • 选中开启返回结果分页复选框,当数据量很大时,可以分页显示。
    • 清除开启返回结果分页复选框,则默认返回2000条记录。
  4. 单击可视化分析工作台右上角的测试API图标测试,在测试数据服务页面配置请求参数的值后单击开始测试,测试成功后如下图所示。
    物分析测试API
  5. 测试成功后,单击右下角关闭,返回可视化分析工作台页面。您可以单击页面右上角的发布按钮发布,并单击确定,即可生成一个数据API。
    • 发布成功后,可视化分析工作台右上角显示如下图所示。物分析API发布后界面
      • 您可以单击查看图标查看跳转到数据资产 > 数据服务 > 数据服务详情页查看具体的API信息。
        说明 API发布成功后,调用API的详细操作指导请参见JAVA SDK调用示例Python SDK调用示例
      • 您也可以单击撤销发布,重新编辑该可视化分析表格。
    • 发布成功后 ,可视化分析列表页上,该可视化分析的状态变成已发布的状态,如下图所示。发布后物分析列表工作台效果

后续步骤

关于可视化分析的案例,可参见可视化分析应用