SQL查询

1 概述

1.1 版本

1.2 功能简介

通过SQL查询可以查询JDBC连接的数据库数据库中的数据，提供给乐创者服务进行使用。

2 功能入口

进入数据模型管理界面，点击全局“+”或某目录的“+”选择新建模型“SQL查询”，如下图：

3 功能说明

SQL查询就是通过编写SQL语句进行数据查询，适合熟悉SQL的用户，可进行复杂的数据查询和处理。

支持的功能主要包括：选择数据连接、SQL编辑、查询参数、执行。

3.1 数据连接选择

首先需要选择查询的数据所在数据连接，目前仅支持选择当前应用下的DBC类型连接。

选择之后，下方将自动获取当前数据连接下的表、视图和函数，SQL编辑时可以直接引用。

3.1 SQL编写

可以在SQL编辑器中直接录入SQL语句，如下图：

如果需要引用左侧的表、字段、视图、函数等资源，直接双击或拖拽即可添加到编辑器中。

3.3 查询参数

查询数据时如果需要引用系统变量或自定义参数，则编写SQL时编写规则需按照下方“查询参数”中的“参数识别模式”配置进行编写，支持两种模式：{参数名}和${参数名}。
SQL语句中设置的符合参数规则的则视为参数，将显示在查询参数列表中，可设置参数默认值。
当SQL查询模式的文件属性“禁止SQL注入”开启时，可按需选择防SQL注入的方式（具体参考文档：SQL注入），可根据是否启用“预处理SQL模式”进行切换：

• 开启时将通过预处理的方式对参数进行占位处理，执行sql时转换为具体的类型达到防注入效果，开启时还可设置参数值类型，默认会自动识别。
  

  注：上图中未显示“自动识别参数值类型”功能，因为数据连接类型为MySQL不支持该功能。

• 不开启时对参数值进行引号和关键字的转义处理。
  

3.4 执行

模型设计好之后，可点击“运行”进行调试，如果存在参数，可设置对应的参数值进行查询，为空表示禁用该参数，如下图：

点击“确定”即可在下方“执行结果”Tab中查询到对应的数据，最多显示1000条数据，如下图：

点击“导出Excel”可将所有数据导出Excel（非前1000条数据）。
切换到“日志信息”可查看QL执行日志，包括执行的SQL和执行时间，如下图：

除了设计时运行，还可以在左侧模型树的菜单上点击“运行”进行当前模型的执行。

执行结果如下：