// 免费工具

Oracle SQL 格式化工具

在浏览器中格式化 Oracle SQL。替代引号字符串、绑定变量、数据库链接和 SQL*Plus 斜杠行都按 Oracle 的方式解读。

把 .sql 文件拖到此处即可打开。文件只在你的浏览器中读取,不会上传。

格式化的 SQL
SELECT
    e.employee_id,
    e.last_name,
    d.department_name,
    q'[O'Brien's team]' AS note
FROM
    employees e
    JOIN departments@hq d ON d.department_id = e.department_id
WHERE
    e.hire_date >= ADD_MONTHS(TRUNC(sysdate), -12)
    AND e.manager_id = :mgr
ORDER BY
    e.last_name
FETCH FIRST 10 ROWS ONLY

Loading the formatter…

编辑器中的快捷键: Ctrl+输入 格式,以及 Ctrl+Shift+输入 压缩(⌘ 代替 Ctrl 在 Mac 上)。你的设置会记在这个浏览器里,也保留在页面地址中,因此分享链接时带出的是你的样式 – 而不是你的 SQL。

格式化器如何处理 Oracle SQL

  • Oracle 字符串。 q'[O'Brien's team]' 替代引用和 N'…' Unicode 字符串是单个字面量,因此其中的引号绝不会让格式化器困惑。
  • 绑定和命名参数。 :mgr 绑定变量和 => 命名表示法保持原样。
  • 链接和属性始终保持相连。 departments@hq 数据库链接和 %TYPE, %ROWTYPE 和 SQL%ROWCOUNT 属性从不分开。
  • 斜杠行单独占一行。 这 / 在 SQL*Plus 或 SQLcl 脚本中结束 PL/SQL 块的斜杠保持在它自己的行上,Minify 也会保持它的位置。
  • Oracle 关键字遵循你输入的大小写,包括 FETCH FIRST … ROWS ONLY, CONNECT BY, START WITH 和 PRIOR.
  • 大小写安全引用。 Oracle 会把未加引号的名称转为大写,因此 移除不必要的引号 只对本身已是大写的名称去引号。Minify 会保留 /*+ … */ 和 --+ 优化器提示。

值得了解

  • PL/SQL 块保持有效,其中的 SQL 语句会重新排版,但 IF, LOOP 和其他块结构不会重新缩进。

示例

Oracle 格式化前后对比

之前
select e.employee_id,e.last_name,d.department_name,q'[O'Brien's team]' as note from employees e join departments@hq d on d.department_id=e.department_id where e.hire_date>=add_months(trunc(sysdate),-12) and e.manager_id=:mgr order by e.last_name fetch first 10 rows only
之后
SELECT
    e.employee_id,
    e.last_name,
    d.department_name,
    q'[O'Brien's team]' AS note
FROM
    employees e
    JOIN departments@hq d ON d.department_id = e.department_id
WHERE
    e.hire_date >= ADD_MONTHS(TRUNC(sysdate), -12)
    AND e.manager_id = :mgr
ORDER BY
    e.last_name
FETCH FIRST 10 ROWS ONLY

输出采用 Standard 样式和 4 空格缩进,与上方格式化器生成的结果完全一致。可将样式切换为 紧凑 用于更紧凑的 SQL,或 已展开 用于前置逗号和每行一项。该 格式化工具文档 涵盖详细信息。

Oracle 格式化工具常见问题

它可以格式化 PL/SQL 吗?

它保持 PL/SQL 有效,并整理块内的 SQL 语句,%TYPE 属性和斜杠终止行保持不变。它不会重新缩进 IF、LOOP 或其他块结构。

它会保留 PL/SQL 块末尾的 / 行吗?

会。单独成行的斜杠经 Format 和 Minify 处理后仍会独占一行,因此脚本照样能在 SQL*Plus 或 SQLcl 里运行。

它会改动我加引号的标识符吗?

除非你选择了引号相关选项,否则不会。“移除不必要的引号”只会为本来就是大写的名称去掉引号,因为 Oracle 会把不带引号的名称转换为大写。

我的 SQL 会被发送到服务器吗?

不会。格式化工具编译成了 WebAssembly,在你的浏览器标签页中运行。你的 SQL 绝不会被上传、记录或存储;页面加载后,断网也能继续使用。

格式化会破坏我的查询吗?

它的设计目标就是不破坏。格式化后,SQLly 会逐个令牌地把输出与你的输入比对。如果除空白和你要求的大小写之外还有任何变化,它会把你原本的 SQL 原样返回,并告诉你原因。无法顺利解析的 SQL,例如未终止的字符串,也会原样保留,并附上问题所在的行和列。

我可以与团队共享我的格式化设置吗?

是的。包括高级设置在内的每一项设置都保存在页面地址 # 号之后,因此复制地址或点击“复制设置链接”,对方得到的就是和你完全相同的样式。链接只包含设置,绝不含你的 SQL。

// 格式化只是最次要的部分

喜欢这个格式化工具?来认识一下 SQLly 的其他功能

适用于 macOS、Windows 和 Linux 的原生 SQL 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。