SuperAPI AI 工具集

sql-formatter

数据与分析

查看项目

更新于 10-16 08:41

技能介绍

用途:格式化、美化并整理 SQL 代码,遵循 Oracle Database 19 的最佳实践,统一风格、提升可读性,适用于查询、DDL 与 DML 语句。适合处理 .sql 文件、改进查询可读性、跨项目统一 SQL 风格、记录复杂查询以及审查或重构现有 SQL。

主要能力:规定关键字大写、标识符小写;使用 4 空格缩进(禁用制表符);子查询比父查询多缩进一级;对齐 SELECT、FROM、WHERE 等子句位置;每个字段、条件或表单独换行并纵向对齐;运算符两侧留一个空格、逗号后留一个空格;对 CTE、JOIN、CASE、INSERT、UPDATE 等给出明确排版规范。

使用方式:用户提供未格式化 SQL 时,先判断语句类型,再套用格式规则,确保关键字大写、标识符小写、缩进与纵向对齐正确,返回格式化结果。处理复杂查询时读取 references/sql-formatting-rules.md 获取全部 13 条规则。处理 .sql 文件时读取内容、逐条格式化、保留原注释,再写回或展示,建议保持 UTF-8 编码。示例文件见 examples/unformatted.sql、examples/formatted.sql、examples/complex-query.sql。

适用场景:SQL 查询美化、.sql 文件整理、项目 SQL 风格统一、复杂查询文档化与代码审查前格式化。

限制:该技能专注于格式与风格,不负责查询优化;格式化后需测试以确保功能不变;超过 1000 行的 SQL 文件建议分段处理。价格、平台要求等暂未提供。