SQL 数据集

1 新建 SQL 数据集

如下图所示，点击【添加数据集】并选择【 SQL 数据集】。

支持两种连接方式：直连和定时同步。

【序号1】位置选择数据库并输入数据集名称；
【序号2】位置为 SQL 语句输入区，在此区域输入正确的 SQL 语句；
【序号3】点击可展示预览数据；
注意事项： 此处只支持查询语句。

DataEase v1.12.0 版本，直连模式下 SQL 数据集支持参数传递，如下图所示。

在直连模式的 SQL 数据集中编写带变量的 SQL 语句，变量定义格式为 ${xxx}，其中 xxx 为变量名；
在右上角【参数设置】里对变量进行相关设置，如变量类型、默认值（非必填），此处变量为系统根据 SQL 语句自动识别的，例如 province 会被自动带出来；
在仪表板的过滤组件中（文本下拉和数字下拉组件）勾选【参数选项】，并将下拉字段与 SQL 数据集中的变量关联，如下示例以 MySQL 数据库 SQL 语法为例，不同数据库请根据实际情况调整。

SQL 数据集带参数传递，根据过滤组件的不同，SQL 语法用法上有差异。
情况一：过滤组件为单选时，要用 = ：

SELECT ORDER_ID, ORDER_DATE, PROJ_ID FROM ORDERS WHERE ORDER_EMP = '${USER_NAME}'

情况二：过滤组件为多选时，要用 IN （用 IN 可单选也可多选，但相反地用 = 只能单选）：

SELECT ORDER_ID, ORDER_DATE, PROJ_ID FROM ORDERS WHERE ORDER_EMP IN ${USER_NAME}

情况三：有多个过滤组件时，要用括号包复成一个组，否则视图组件无法更新：

SELECT ORDER_ID, ORDER_DATE, PROJ_ID FROM ORDERS WHERE (ORDER_EMP IN ${USER_NAME} AND PROJ_ID IN ${USER_PROJ_ID})

如下图所示，点击【确认】，SQL 数据集添加成功。