pgFormatter 1.31.0

新的介绍内容：

pgFormatter：Visual Studio Code的PostgreSQL SQL格式化工具

pgFormatter是由Gilles Darold开发的一款基于Perl的工具，专门用于在Visual Studio Code中格式化PostgreSQL SQL代码。它支持从SQL-92到SQL-2011的多种标准关键字，以及PostgreSQL特定的关键字。

主要功能：

• 支持SQL-92、SQL-99、SQL-2003、SQL-2008、SQL-2011以及PostgreSQL特定关键字
• 提供丰富的配置选项，允许用户自定义格式化风格

安装：

pgFormatter需要Perl环境，您可以将其添加到PATH中，或通过设置pgFormatter.perlBinPath来指定Perl可执行文件的路径。

安装步骤如下：

1. 按下Ctrl Shift X（macOS上为Cmd Shift X），等待扩展列表加载
2. 输入pgFormatter并点击“安装”

使用：

该扩展适用于在VS Code中被识别为SQL语言的文件，通常是.sql扩展名的文件。您可以通过files.associations设置来自定义哪些文件被识别为SQL文件。

使用pgFormatter，只需执行editor.action.formatDocument命令，默认快捷键为Ctrl K, Ctrl D（macOS上为Cmd K, Cmd D）。

pgFormatter还支持"editor.formatOnSave": true设置，这样在保存文件时会自动进行格式化。

配置：

pgFormatter提供以下配置选项：

• pgFormatter.spaces - 代码缩进的空格数（默认：2或从editor.tabSize选项中获取）
• pgFormatter.tabs - 使用制表符而非空格进行缩进（默认：false或从editor.insertSpaces配置中获取）
• pgFormatter.commaStart - 在参数列表中使用前置逗号（默认：false）
• pgFormatter.commaBreak - 在插入语句中，每个逗号后添加新行（默认：false）
• pgFormatter.commaEnd - 在参数列表中使用尾随逗号（默认：true）
• pgFormatter.noComment - 移除所有注释（默认：false）
• pgFormatter.noGrouping - 在事务重新组合中，语句之间添加新行（默认：false）
• pgFormatter.noExtraLine - 输出末尾不添加额外的空行（默认：false）
• pgFormatter.keepNewline - 保留空行（默认：false）
• pgFormatter.functionCase - 函数名称的大小写（选项：["unchanged", "lowercase", "uppercase", "capitalize"]；默认："unchanged"）
• pgFormatter.keywordCase - 保留关键字的大小写（选项：["unchanged", "lowercase", "uppercase", "capitalize"]；默认："uppercase"）
• pgFormatter.typeCase - 数据类型的大小写（选项：["unchanged", "lowercase", "uppercase", "capitalize"]；默认："lowercase"）
• pgFormatter.formatType - 为某些语句使用另一种格式化类型（默认：false）
• pgFormatter.wrapLimit - 在特定长度处换行查询
• pgFormatter.wrapComment - 当指定wrapLimit时，注释也会换行（默认：false）
• pgFormatter.placeholder - 用于查找不应更改的代码的正则表达式
• pgFormatter.extraFunction - 包含应使用与PostgreSQL内部函数相同格式的函数名称列表的文件路径
• pgFormatter.noSpaceFunction - 移除函数调用与后跟的左括号之间的空格字符（默认：true）
• pgFormatter.pgFormatterPath - 自定义pg_format版本的路径
• pgFormatter.perlBinPath - Perl可执行文件的路径（默认："perl"）
• pgFormatter.configFile - pg_format配置文件的绝对路径。您可以使用VS Code路径变量来帮助解析绝对路径（例如：${workspaceFolder}/pg_format.conf）。注意：此扩展的默认设置可能会覆盖此文件中的某些配置，但您可以通过将设置值指定为null来避免这一点。例如，如果您想使用pg_format.conf文件中的no-space-function配置，并且不想让扩展默认值覆盖它，您可以在VS Code设置中指定"pgFormatter.noSpaceFunction": null。

忽略文件：

要忽略某个文件并防止其被格式化，您可以在文件的第一行添加一个注释，其内容为“pgFormatter-ignore”。例如：

-- pgFormatter-ignore
select id from people;