物联网数据分析提供的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分析的状态变成已发布的状态，如下图所示。发布后显示