物联网数据分析提供的SQL分析功能,支持分析设备上报云端的数据,或通过SQL将分析后的决策结果下发至设备进行远程控制。您也可以将SQL数据分析任务封装成数据API,方便开发者调用,既可直接响应设备端请求,也可用来做服务端数据对接。

数据分析

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

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

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

  2. 单击新建SQL分析,在新建SQL分析对话框输入分析名称和描述信息。
    新建文件夹
  3. 单击确认
    您可进入SQL数据分析工作台,默认选择数据表设备数据源,可修改为外部数据源
    说明 本文图片所示为默认主题(亮色)。物联网数据分析支持设置工作台主题样式功能,您可单击工作台右上角的设置按钮设置,修改主题为暗色主题
    SQL分析工作台

    您也可以单击物标签,选择目标产品后,根据物标签进行SQL数据分析。本文以数据表示例介绍SQL分析过程。

    物标签
  4. SQL数据分析工作台,编写SQL语句。
    编辑SQL语句

    如果需要使用系统数据表(平台系统表、平台设备表)或外部数据源(用户数据)相关信息,您可从相应表目录下找到并将鼠标移动到目标数据表,单击右侧的复制表名称预览数据表图标,可获取表相应信息。

    有关系统数据表和外部数据表详细说明,请参见如何使用数据表

    如果需要查询表数据,您可选中目标数据表后,在页面左下方列信息表格中,选中需要查询的字段,单击下方的生成查询SQL,在右侧SQL编辑框中快速生成相应的SQL语句。

    SQL数据分析工作台提供了多种SQL语句模板,单击SQL编辑框右上角的模板导入,可查看或导入SQL语句。如下图所示。

    SQL模板
  5. 编写完成SQL语句后,可根据需要对SQL语句执行如下操作。
    操作 说明
    保存 保存已编写的SQL语句。保存不检验语法错误,会直接保存内容。
    运行 运行已编写的SQL语句。
    说明 保证语句成功运行,建议您在运行语句前进行语法校验
    • 如果SQL语法正确并且存在查询结果时,结果信息将会在结果框中展示,其中字段名会展示在第一行。
    • 如果SQL语法存在错误,则系统提示执行失败。
    停止 取消已运行的SQL语句。此按钮在运行SQL语句后可生效。
    定时任务 定时执行SQL,运行离线任务。单击定时任务图标后,在弹出窗口中打开定时开关。
    • 生效日期:定时运行的生效日期区间。
    • 调度周期:定时运行的调度周期,可以选择分钟、小时、周、月。
      您可根据设置的周期单位,进行以下设置。
      • 指定时间:指定定时运行具体在哪个时间运行。
      • 具体时间:定时运行任务在指定时间的具体哪个时间段运行。
    SQL校验 对已编写的SQL语句进行语法校验。
    执行SQL语句后:
    • 可在运行日志页面查看SQL语句运行信息。
      运行日志示例和每一行信息说明如下。
      2019-04-30 17:59:23 -- startPoint:[]   #执行参数信息
      2019-04-30 17:59:23 -- updatePipelineToActive:success   #Pipeline激活状态
      2019-04-30 17:59:23 -- checkWorkFlow:workflow is INTERACTIVE   #检查WorkFlow类型
      2019-04-30 17:59:23 -- checkTransformer:transformer is 99d*****724b1a5   #执行的TransformerUid
      2019-04-30 17:59:23 -- dispatchToTaskExecutor:success   #获取对应计算平台的执行器
      2019-04-30 17:59:23 -- addMaxLimit:success   #补全分页限制
      2019-04-30 17:59:23 -- callType:sync   #同步执行/异步执行
      2019-04-30 17:59:25 -- updateWorkflowToStandBy:success   #成功后更新WorkFlow状态
    • 若执行成功,可在结果页面查看语句执行结果。结果框中最多返回200条查询结果,如果您有更多数据查询需求,请单击右侧CSV下载,下载任务的1000条查询结果。
      说明 如果您有更多的数据查询需求(超过1000条查询结果),请提交工单申请需求。
    • 若执行失败,可在错误日志页面查看错误信息。

      错误日志示例和每一行信息说明如下。

      2019-04-30 15:31:33 -- startPoint:[]   #执行参数信息
      2019-04-30 15:31:33 -- updatePipelineToActive:success   #Pipeline激活状态
      2019-04-30 15:31:33 -- checkWorkFlow:workflow is INTERACTIVE   #检查WorkFlow类型
      2019-04-30 15:31:33 -- checkTransformer:transformer is 426*****5286502   #执行的TransformerUid
      2019-04-30 15:31:33 -- dispatchToTaskExecutor:success   #获取对应计算平台的执行器
      2019-04-30 15:31:33 -- addMaxLimit:success   #补全分页限制
      2019-04-30 15:31:33 -- callType:sync   #同步执行/异步执行
      2019-04-30 15:31:33 -- taskExecuted:engine error, traceId 644*****03d05dd   #提示执行错误并输出了此次调用的traceId
      2019-04-30 15:31:33 -- taskExecuted:INSERT statement has mismatched column types   #具体错误原因

生成一个数据API

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

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