自定义SQL创建数据集

约束与限制

• 当前一个数据集中最多只有一个SQL语句。
• 创建自定义数据集的SQL语法仅支持SELECT，FROM，WHERE，GROUP BY，ORDER BY，SET，LIMIT。

前提条件

• 已开通DataArts Insight服务。
• 已创建管理数据源的项目，参考创建项目完成项目创建。

• 您已获取数据源，参考新建数据源。

SQL创建数据集

1. 登录智能数据洞察控制台。
2. 单击管理控制台左上角的，选择区域。
3. 单击左下角的企业项目选择企业项目。
4. 选择项目，单击项目名称进入项目。
5. 单击数据集，进入数据集管理界面
6. 单击页面右上角“新建数据集”，进入创建数据集页面。

7. 单击数据集创建页面右上方的“SQL编辑”进入SQL编辑页面。
8. 单击SQL编辑页面的对自定义数据表命名，如果未对自定义数据表进行命名则数据表名默认为“sql”。
   

   输入不能为空，且数据集名称只能由英文、数字、下划线（_）组成，且不能超过64个字符。

9. 按业务需求输入SQL语句，支持通过SQL参数进行动态查询，编写完成单击“运行”。
   样例：将data数据表中data1、data2、data3数据整理成一个数据集

   SELECT
     *
   FROM
     data
   WHERE
     city IN ('data1', 'data2', 'data3') 
     and date > ${param}

10. 运行成功后，您可以在运行页签看到运行后的数据。
11. 单击“完成并退出”，保存自定义数据集。

设置SQL参数

在分析数据的过程中，当您在查看仪表板、大屏时需要把参数传到SQL中，可以按照需求进行SQL参数设置，本章节介绍如何设置SQL参数。

1. SQL脚本中使用SQL参数进行动态SQL编写：
   • 参数的格式为${param}，param为参数名称，支持通过序号获取指定参数值。示例：${params[0]}可以获取params参数列表中第一个值。
   • 参数为空时，执行SQL时默认会把相关条件设为1=1，从而可以正常查询数据。另外支持通过<if test="param != null">动态语句</if>的方式灵活控制参数为空时最终的SQL语句。
2. 在SQL编辑页单击右上方的“参数设置”，进入参数设置页面。
   图1 参数设置页面
   

   表1 参数说明

   参数名称	说明
   变量名	变量名称。
   变量类型	支持文本、数值和日期3种变量类型。
   默认值生效范围	支持全局生效和仅编辑页生效范围。 全局生效：查询默认值在仪表板、大屏、SQL编辑页面都生效。 仅编辑页生效：查询默认值只在sql编辑页面有效。
   查询默认值	可选项。当数据集数据量过大，导致数据集保存失败或仪表板查询过长时，推荐您配置查询默认值。

修改SQL代码

根据分析场景的改变，存在需要对SQL代码进行修改。

1. 登录智能数据洞察控制台。
2. 单击管理控制台左上角的，选择区域。
3. 单击左下角的企业项目选择企业项目。
4. 选择项目，单击项目名称进入项目。
5. 在项目中选择数据集。
6. 在数据集列表选择由自定义SQL创建的数据集，单击操作列的“编辑”进入数据编辑页面。
   

   由自定义SQL创建的数据集，在数据集页面名称列，数据集名称后会有“SQL”字样。

7. 单击“SQL编辑”，在SQL编辑页可以对SQL语句进行编辑修改。
   • SQL编辑器提供了格式化工具，可以对您输入的SQL语句格式化。
   • 支持设置SQL参数。参数说明参考设置SQL参数。
   图2 配置字段
   
8. 单击“运行”，测试运行成功后，您可以在运行页签看到运行后的数据。
9. 单击“完成并退出”，保存修改后的数据集。