1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.1.6.1 | 用户可在 FDL 内进行SQL的编写/调试、查看新建表效果、删除表、清空表、复制表等操作 |
| 4.1.9.2 | 「已存SQL文件」记录中,展示创建人、编辑记录;支持修改SQL文件的名称 |
| 4.2.14.1 | 4.2.14.1 及之后版本,对 SQL 编辑器进行全新升级,历史版本请参考文档:历史文档 SQL 编辑优化升级:
|
| 4.2.16.4 | 4.2.16.4 及之后版本,SQL 脚本独立管理,展示在数据连接下的「调试SQL」分组中。历史版本请参考:历史文档
|
1.2 功能简介
在数据开发过程中,支持数据开发人员在 FDL 中编写和调试 SQL,并预览 SQL 执行结果,无需切换工具即可完成开发和验证。
1.3 使用前提
2. 功能介绍
2.1 新建 SQL 编辑器
4.2.16.4 及之后版本,SQL 编辑器作为一个独立的工作区,不再受左侧数据源影响,允许用户同时打开并管理多个归属不同数据连接的脚本。
在库表管理中,每个数据连接下的「调试SQL」分组下,展示此连接下的所有 SQL 脚本;用户可在列表中查看其权限下所有数据源的 SQL 脚本。
「调试SQL」分组右侧,会显示 SQL 脚本数量。如下图所示:

点击「+」,会在此数据连接下新建一个 SQL 脚本。如下图所示:

支持同一数据连接内的跨库查询,但不支持 SQL 脚本中跨数据连接查询和操作。
在 SQL 脚本功能栏会显示归属的数据连接名称。如下图所示:

支持在右侧打开并管理多个归属不同数据连接的脚本,各脚本完全独立,点击标签页即可切换查看;切换左侧数据连接,也不会影响到右侧的编辑区。如下图所示:

2.2 编辑 SQL 文件
支持在选择的数据连接下写 SQL 语句,并进行调试 。如下图所示:

完成编辑后保存,SQL 脚本将会保存在对应的数据连接下。如下图所示:

在编辑 SQL 时,编辑框内支持下表中的操作:
| 功能 | 说明 |
|---|---|
| SQL 提示与自动补全 | 开启「补全增强」,支持表和字段等信息的联想补全,但开启可能会影响性能。如下图所示:
支持提示与补全:
|
| 语法检查与错误高亮 | 支持语法检查,若使用错误则标红,鼠标悬浮提示对应的错误类型。如下图所示:
支持检查的错误类型:
|
| SQL 语句部分调试与运行 | 允许执行脚本中的部分语句 选择部分语句,点击顶部的「执行」或鼠标右击选择「执行所选语句」,均可执行部分语句
|
| SQL 语句折叠 | 支持折叠长语句,可以隐藏非关键代码块,提升编写和维护的效率
|
| 局部底色高亮 | 支持编辑行底色高亮、双括号底色高亮
|
2.3 标签页操作
鼠标右键点击标签页,支持:关闭、关闭其他、关闭全部、重命名。
当标签页打开过多,切换标签页时形成干扰,可以快捷地批量关闭标签页;重命名 SQL 文件。

2.4 工具栏操作
工具栏支持保存、执行语句、查看执行记录等操作,详细说明见下表:

| 按钮 | |
|---|---|
| 保存 | 将文件保存在「已存SQL文件」中,以便后续使用 |
| 执行/执行记录 | 执行 SQL 语句,在下方展示执行记录,支持查看执行的 SQL、日志和结果
4.2.14.1 及之后版本支持一个脚本运行多条 select 查询语句,将展示多个结果 tab
|
| 格式美化 | 支持一键美化格式,支持自动缩进、排版优化等等,让 SQL 结构更清晰易读
|
| 复制 | 复制当前 SQL |
| 补全增强 | 开启「补全增强」,支持表和字段的联想补全,但开启可能会影响性能 详情请参见本文 4.5.3 节 |
2.5 导出查询结果
4.2.16.4 及之后版本,使用 SQL 语句进行库表查询后,支持将查询结果数据导出。如下图所示:

支持选择文件类型,导出为 Excel 或 CSV 文件。配置说明可参考文档:文件输出算子功能说明

2.6 管理 SQL 脚本
选择某一 SQL 脚本,支持修改名称或删除。如下图所示:

