如果当前表格输出格式为不对齐，则切换为对齐。如果它不是不对齐，则设置为不对齐。此命令保留用于向后兼容性。参见\pset以获取更通用的解决方案。

为下一次查询执行设置查询参数，使用指定的参数传递给任何参数占位符 ($1 等)。

示例：

INSERT INTO tbl1 VALUES ($1, $2) \bind 'first value' 'second value' \g

这同样适用于除了\g之外的查询执行命令，例如 \gx和\gset。

此命令会使用扩展查询协议（参见 第 54.1.2 节），与正常的 psql 操作不同，后者使用简单 查询协议。因此，此命令可以用于测试来自 psql 的扩展查询协议。 （即使查询没有参数，此命令也会指定零个参数，仍会使用扩展查询协议。） 此命令仅影响下一个执行的查询；所有后续查询将默认使用简单查询协议。

\bind_named 等同于 \bind， 不同之处在于它将现有准备语句的名称作为第一个参数。 空字符串表示未命名的准备语句。

示例：

INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1
\bind_named stmt1 'first value' 'second value' \g

此命令会使用扩展查询协议（参见 第 54.1.2 节），与正常的 psql 操作不同，后者使用简单 查询协议。因此，此命令可以用于测试来自 psql 的扩展查询协议。

建立到PostgreSQL服务器的新连接。可以使用位置语法（数据库名称、用户、主机和端口中的一个或多个）指定要使用的连接参数，也可以使用详细说明在第 32.1.1 节中的conninfo连接字符串。如果没有给出参数，则使用与之前相同的参数建立新连接。

指定任何dbname、 username、 host或 port为 -等同于省略该参数。

新连接可以重用前一个连接的连接参数；不仅包括数据库名称、用户、主机和端口，还包括其他设置，如sslmode。 默认情况下，参数在位置语法中被重用，但在给定conninfo字符串时不会被重用。 传递-reuse-previous=on或-reuse-previous=off作为第一个参数将覆盖该默认设置。 如果参数被重用，则任何未明确指定为位置参数或在conninfo字符串中的参数将从现有连接的参数中获取。 一个例外是，如果使用位置语法将host设置更改为其先前值，则现有连接参数中存在的任何hostaddr设置将被删除。 此外，仅当用户、主机和端口设置未更改时，才会重用现有连接使用的任何密码。 当命令既不指定也不重用特定参数时，将使用libpq的默认值。

如果新连接成功建立，则关闭先前的连接。 如果连接尝试失败（用户名错误，访问被拒绝等），且psql处于交互模式，则保留先前的连接。 但在执行非交互脚本时，旧连接将被关闭并报告错误。 这可能会或可能不会终止脚本；如果没有终止，直到成功执行另一个\connect命令之前，所有访问数据库的命令都将失败。 选择这种区别是为了用户方便避免打字错误，同时也是脚本不会意外操作错误数据库的安全机制。 请注意，每当\connect命令尝试重新使用参数时，重新使用的值是最后一个成功连接的值，而不是随后的任何失败尝试的值。 但是，在非交互\connect失败的情况下，不允许稍后重新使用参数，因为脚本可能期望从失败的\connect中重新使用值。

示例：

=> \c mydb myuser host.dom 6432
=> \c service=foo
=> \c "host=localhost port=5432 dbname=mydb connect_timeout=10 sslmode=disable"
=> \c -reuse-previous=on sslmode=require    -- changes only sslmode
=> \c postgresql://tom@localhost/mydb?application_name=myapp

设置作为查询结果打印的任何表格的标题，或取消任何这样的标题。此命令等效于 \pset title title。（此命令的名称源自“caption”， 因为它以前仅用于设置HTML表格中的标题。）

将当前工作目录更改为 directory。如果没有参数，则更改为 当前用户的主目录。有关如何查找主目录的详细信息，请参见 第 32.16 节。

关闭指定的准备语句。空字符串表示未命名的准备语句。 如果没有具有此名称的准备语句，则该操作无效。

示例：

SELECT $1 \parse stmt1
\close_prepared stmt1

此命令会使用扩展查询协议， 与正常的 psql 操作不同， 后者使用简单查询协议。因此，此命令可以用于测试来自 psql 的扩展查询协议。

输出有关当前数据库连接的信息， 包括如果使用 SSL 则相关的 SSL 信息。

请注意，Client User 字段显示 连接时的用户，而 Superuser 字段指示 当前用户（在当前执行上下文中）是否具有超级用户权限。 这些用户通常是相同的，但它们可能不同，例如，如果当前用户 是通过 SET ROLE 命令更改的。

执行前端（客户端）复制。这是一个操作，运行一个SQL COPY命令， 但是服务器不读取或写入指定的文件， psql读取或写入文件， 并在服务器和本地文件系统之间路由数据。 这意味着文件的可访问性和权限属于本地用户，而不是服务器， 也不需要SQL超级用户权限。

当指定program时，由psql执行command， 并在服务器和客户端之间传递从command传递的数据。 再次强调，执行权限是本地用户的权限，而不是服务器的权限，不需要SQL超级用户权限。

对于 \copy ... from stdin，数据行从发出命令的同一 源读取，直到读取到仅包含 \. 的行或流达到 EOF。此选项对于在 SQL 脚本文件中 内联填充表非常有用。 对于 \copy ... to stdout，输出发送到与 psql 命令输出相同的位置，并且 COPY count 命令状态不会被打印 （因为它可能与数据行混淆）。 要读取/写入 psql 的标准输入或 输出，而不管当前命令源或 \o 选项，写入 from pstdin 或 to pstdout。

该命令的语法与 SQL COPY 命令类似。 除了数据源/目的地之外的所有选项都与 COPY 指定的一样。 因此，特殊的解析规则适用于 \copy 元命令。 与大多数其他元命令不同，整个剩余行始终被视为 \copy 的参数， 参数中不执行变量插值或反引号扩展。

显示 PostgreSQL 的版权和分发条款。

执行当前查询缓冲区（类似于 \g）并在交叉表格中显示结果。 查询必须返回至少三列。 由 colV 标识的输出列成为垂直标题， 由 colH 标识的输出列成为水平标题。 colD 标识要在网格中显示的输出列。 sortcolH 标识水平标题的可选排序列。

每个列规范可以是列号（从 1 开始）或列名。列名遵循通常的 SQL 大小写折叠和引用规则。如果省略， colV 被视为第 1 列， colH 被视为第 2 列。 colH 必须与 colV 不同。 如果未指定 colD，则查询结果中必须恰好有三列， 并且既不是 colV 也不是 colH 的列被视为 colD。

垂直标题显示为最左侧的列，包含在列 colV 中找到的值， 与查询结果中的顺序相同，但删除了重复项。

水平标题作为第一行显示，包含在列colH中找到的值，去除重复项。 默认情况下，这些值按照查询结果中的顺序显示。但是，如果给定可选的sortcolH参数， 它标识一个列，其值必须是整数，colH中的值将按照相应的 sortcolH值排序后显示在水平标题中。

在交叉表格中，对于每个colH列的不同值x， 和每个colV列的不同值y， 位于交点(x,y)的单元格包含查询结果行中colD列的值， 其中colH列的值为x， colV列的值为y。 如果没有这样的行，则单元格为空。如果有多个这样的行，则报告错误。

对于每个与pattern匹配的关系（表、视图、物化视图、索引、序列或外部表）或复合类型， 显示所有列、它们的类型、表空间（如果不是默认的）以及任何特殊属性，如NOT NULL或默认值。 还显示相关的索引、约束、规则和触发器。对于外部表，还显示关联的外部服务器。 （“匹配模式”的定义在下面的Patterns中。）

对于某些类型的关系，\d显示每列的附加信息：序列的列值，索引的索引表达式， 外部表的外部数据包装器选项。

命令形式\d+与相同，只是显示更多信息：显示与表列相关的任何注释， 表中的OID的存在，如果关系是视图，则显示视图定义，非默认的 复制标识设置以及 如果关系具有访问方法，则显示 访问方法名称。

默认情况下，只显示用户创建的对象；提供一个模式或S修饰符以包括系统对象。

列出聚合函数，以及它们的 返回类型和它们操作的数据类型。如果指定了 pattern ，则仅显示名称与模式匹配的聚合。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包含系统 对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。

列出访问方法。如果指定了 pattern，则仅显示名称与模式匹配的访问 方法。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个访问 方法将与其关联的处理函数和描述一起列出。

列出运算符类 （见 第 36.16.1 节）。 如果指定了 access-method-pattern ，则仅列出与名称匹配该模式的访问方法相关的运算符类。 如果指定了 input-type-pattern ，则仅列出与名称匹配该模式的输入类型相关的运算符类。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个运算符 类将与其关联的运算符族和拥有者一起列出。

列出运算符族 （见 第 36.16.5 节）。 如果指定了 access-method-pattern ，则仅列出与名称匹配该模式的访问方法相关的运算符族。 如果指定了 input-type-pattern ，则仅列出与名称匹配该模式的输入类型相关的运算符族。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个运算符 家将与其拥有者一起列出。

列出与运算符族相关的运算符 （见 第 36.16.2 节）。 如果指定了 access-method-pattern ，则仅列出与名称匹配该模式的访问方法相关的运算符族成员。 如果指定了 operator-family-pattern ，则仅列出与名称匹配该模式的运算符族成员。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个运算符 将与其排序运算符族（如果它是排序运算符）以及其底层函数是否是防泄漏的标志一起列出。

列出与运算符族相关的支持函数 （见 第 36.16.3 节）。 如果指定了 access-method-pattern ，则仅列出与名称匹配该模式的访问方法相关的运算符族的函数。 如果指定了 operator-family-pattern ，则仅列出与名称匹配该模式的运算符族的函数。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则函数将以详细方式显示，包含其实际参数列表。

列出表空间。如果指定了 pattern，则仅显示名称与模式匹配的表空间。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个表空间 将与其关联的选项、磁盘大小、权限和描述一起列出。

列出字符集编码之间的转换。 如果指定了 pattern ，则仅列出名称与模式匹配的转换。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包含系统 对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个对象 将与其关联的描述一起列出。

列出服务器配置参数及其值。 如果指定了 pattern， 则仅列出名称与模式匹配的参数。没有 pattern 时，仅列出设置为非默认值的参数。 （使用 \dconfig * 查看所有参数。） 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则每个 参数将与其数据类型、可以设置参数的上下文和访问权限（如果已授予非默认访问 权限）一起列出。

列出类型转换。 如果指定了 pattern ，则仅列出源类型或目标类型与模式匹配的转换。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示每个转换的附加信息， 包括其底层函数是否是防泄漏的，以及转换的描述。

显示 constraint、operator class、 operator family、rule 和 trigger 类型对象的描述。所有其他注释可以通过相应的反斜杠命令查看这些对象类型。

\dd 显示与 pattern 匹配的对象描述， 或者在未给出参数的情况下显示适当类型的可见对象。 但在任何情况下，仅列出具有描述的对象。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包含系统对象。 如果在命令名称后附加 x，则结果 以扩展模式显示。

可以使用 COMMENT SQL 命令创建对象的描述。

列出域。如果 pattern 被指定，则仅显示名称与模式匹配的域。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包含系统对象。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则每个对象 以其相关权限和描述列出。

列出默认访问权限设置。每个角色（如果适用，还包括模式） 的条目会显示出默认权限设置已从内置默认值更改的情况。 如果 pattern 被 指定，则仅列出角色名称或模式名称与模式匹配的条目。 如果在命令名称后附加 x，则结果 以扩展模式显示。

ALTER DEFAULT PRIVILEGES 命令用于设置默认访问权限。权限显示的含义在 第 5.8 节 中有解释。

在这一组命令中，字母 E、 i、m、s、 t 和 v 分别代表外部表、索引、物化视图、 序列、表和视图。 您可以以任何顺序指定这些字母中的任何一个或全部， 以获取这些类型对象的列表。例如，\dti 列出 表和索引。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +， 则每个对象会列出其持久性状态（永久、临时或未记录）， 磁盘上的物理大小，以及相关描述（如果有）。 如果 pattern 被 指定，则仅列出名称与模式匹配的对象。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包含系统对象。

列出外部服务器（助记符： “外部 服务器”）。 如果 pattern 被 指定，则仅列出名称与模式匹配的服务器。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示每个服务器的完整描述， 包括服务器的访问权限、类型、版本、选项和描述。

列出外部表（助记符： “外部表”）。 如果 pattern 被 指定，则仅列出表名称或模式名称与模式匹配的条目。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +， 则还会显示通用选项和外部表描述。

列出用户映射（助记符： “外部 用户”）。 如果 pattern 被 指定，则仅列出名称与模式匹配的映射。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示每个映射的附加信息。

列出外部数据包装器（助记符： “外部 包装器”）。 如果 pattern 被 指定，则仅列出名称与模式匹配的外部数据包装器。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则还会显示外部数据包装器的 访问权限、选项和描述。

列出函数，以及它们的结果数据类型、参数数据 类型和函数类型，这些类型被分类为 “聚合” （aggregate）、“普通”、“过程”、“触发器” 或 “窗口”。 要仅显示特定类型的函数，请将相应的字母 a、 n、p、t 或 w 添加到命令中。 如果 pattern 被指定，则仅 显示名称与模式匹配的函数。 任何附加参数都是类型名称模式，与函数的第一个、第二个等参数的 类型名称匹配。（匹配的函数可以有比您指定的更多参数。 为了防止这种情况，请在最后一个 arg_pattern 处写一个短横线 -。） 默认情况下，仅显示用户创建的 对象；提供一个模式或 S 修饰符以包含系统对象。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示每个函数的附加信息， 包括波动性、并行安全性、拥有者、安全分类、是否是 防泄漏的、访问权限、语言、内部名称（仅适用于 C 和 内部函数）以及描述。 可以使用 \sf 查看特定函数的源代码。

列出文本搜索配置。 如果 pattern 被指定， 则仅显示名称与模式匹配的配置。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示每个配置的完整描述， 包括底层文本搜索解析器和每个解析器令牌类型的字典列表。

列出文本搜索字典。 如果 pattern 被指定， 则仅显示名称与模式匹配的字典。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，则显示每个选定字典的附加信息， 包括底层文本搜索模板和选项值。

列出文本搜索解析器。 如果指定了 pattern， 仅显示名称匹配该模式的解析器。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，将显示 每个解析器的完整描述，包括底层函数和 识别的标记类型列表。

列出文本搜索模板。 如果指定了 pattern， 仅显示名称匹配该模式的模板。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，将显示 每个模板的附加信息，包括底层函数名称。

列出数据库角色。 （由于 “用户” 和 “组” 的概念已统一为 “角色”，因此此命令现在等同于 \du。） 默认情况下，仅显示用户创建的角色；提供 S 修饰符以包括系统角色。 如果指定了 pattern， 仅列出名称匹配该模式的角色。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，将显示 每个角色的附加信息；目前这将添加每个 角色的注释。

这是 \lo_list 的别名，它显示一个 大对象的列表。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +， 每个大对象将列出其相关权限（如果有）。

列出过程语言。如果指定了 pattern ，仅列出名称匹配该模式的语言。 默认情况下，仅显示用户创建的语言； 提供 S 修饰符以包括系统 对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，每个 语言将列出其调用处理程序、验证器、访问权限， 以及它是否是系统对象。

列出模式（命名空间）。如果指定了 pattern ，仅列出名称匹配该模式的模式。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包括系统对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，每个对象 将列出其相关权限和描述（如果有）。

列出运算符及其操作数和结果类型。 如果指定了 pattern， 仅列出名称匹配该模式的运算符。 如果指定了一个 arg_pattern， 仅列出右操作数类型名称匹配该模式的前缀运算符。 如果指定了两个 arg_pattern， 仅列出参数类型名称匹配这些模式的二元运算符。 （或者，对于未使用的运算符参数，写 -。） 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包括系统 对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +， 将显示每个运算符的附加信息，包括 底层函数的名称，以及它是否是防泄漏的。

列出排序规则。 如果指定了 pattern， 仅列出名称匹配该模式的排序规则。 默认情况下，仅显示用户创建的对象； 提供一个模式或 S 修饰符以 包括系统对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +， 每个排序规则将列出其相关描述（如果有）。 请注意，仅显示与当前数据库编码兼容的排序规则， 因此在同一安装的不同数据库中，结果可能会有所不同。

列出表、视图和序列及其 相关的访问权限。 如果指定了 pattern， 仅列出名称匹配该模式的表、视图和序列。 默认情况下，仅显示用户创建的对象； 提供一个模式或 S 修饰符以包括 系统对象。 如果在命令名称后附加 x，结果 将以扩展模式显示。

GRANT和 REVOKE 命令用于设置访问权限。权限显示的含义在 第 5.8 节中有解释。

列出分区关系。 如果 pattern 被指定， 则只列出名称与模式匹配的条目。 修饰符 t（表）和 i（索引） 可以附加到命令，过滤要列出的关系类型。默认情况下，列出分区表和索引。

如果使用修饰符 n（“nested”）， 或指定了模式，则将包括非根分区关系，并显示一列，显示每个 分区关系的父级。

如果在命令名称后附加 x，结果 将以扩展模式显示。 如果在命令名称后附加 +，将显示 每个关系的分区大小总和，以及 关系的描述。 如果将 n 与 + 结合使用，将显示两个 大小：一个包括直接附加的 叶分区的总大小，另一个显示所有分区的总大小， 包括间接附加的子分区。

列出已定义的配置设置。这些设置可以是 特定于角色、特定于数据库，或两者皆是。 role-pattern 和 database-pattern 用于选择 要列出的特定角色和数据库。如果省略，或者如果 指定了 *，将列出所有设置，包括那些 不特定于角色或数据库的设置。 如果在命令名称后附加 x，结果 将以扩展模式显示。

ALTER ROLE和 ALTER DATABASE 命令用于定义每个角色和每个数据库的配置设置。

列出每个已授予角色成员资格的信息，包括分配的选项 (ADMIN、INHERIT和/或SET)以及授予者。 请参阅GRANT 命令以获取有关角色成员资格的信息。

默认情况下，仅显示对用户创建角色的授权；提供 S 修饰符以包括系统角色。 如果指定了 pattern， 仅列出对名称匹配该模式的角色的授权。 如果在命令名称后附加 x，结果 将以扩展模式显示。

列出复制发布。 如果指定了 pattern， 则仅列出名称匹配该模式的发布。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则还会显示与每个发布相关的表和模式。

列出复制订阅。 如果指定了 pattern， 则仅列出名称匹配该模式的订阅。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示订阅的附加属性。

列出数据类型。 如果指定了 pattern， 则仅列出名称匹配该模式的类型。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则每个类型将 以其内部名称和大小列出，如果它是 enum 类型，则列出其允许值， 以及其相关权限。 默认情况下，仅显示用户创建的对象；提供一个 模式或 S 修饰符以包括系统 对象。

列出数据库角色。 （由于 “用户” 和 “组” 的概念已统一为 “角色”，因此此命令现在等同于 \dg。） 默认情况下，仅显示用户创建的角色；提供 S 修饰符以包括系统角色。 如果指定了 pattern， 则仅列出名称匹配该模式的角色。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则显示每个角色的附加信息； 当前这会为每个角色添加注释。

列出已安装的扩展。 如果指定了 pattern， 则仅列出名称匹配该模式的扩展。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则列出所有属于 每个匹配扩展的对象。

列出扩展统计信息。 如果指定了 pattern， 则仅列出名称匹配该模式的扩展统计信息。 如果在命令名称后附加 x，则结果 以扩展模式显示。

每种扩展统计信息的状态显示在以其统计类型命名的列中（例如Ndistinct）。 defined表示在创建统计信息时请求了该信息，NULL表示未请求。 如果您想知道是否运行了ANALYZE并且统计信息对规划器可用，可以使用pg_stats_ext。

列出事件触发器。 如果指定了 pattern， 则仅列出名称匹配该模式的事件触发器。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +，则每个对象 将与其相关描述一起列出。

如果指定了filename，则编辑该文件；编辑器退出后，文件内容将被复制到当前查询缓冲区。 如果没有给出filename，则将当前查询缓冲区复制到临时文件中，然后以相同方式进行编辑。 或者，如果当前查询缓冲区为空，则将最近执行的查询复制到临时文件中，并以相同方式进行编辑。

如果您编辑文件或上一个查询，并在不修改文件的情况下退出编辑器，则查询缓冲区将被清除。 否则，查询缓冲区的新内容将根据psql的正常规则重新解析， 将整个缓冲区视为单行。任何完整的查询将立即执行；也就是说，如果查询缓冲区包含或以分号结尾， 则执行并从查询缓冲区中删除到该点的所有内容。查询缓冲区中剩余的内容将重新显示。 输入分号或\g发送它，或输入\r通过清除查询缓冲区来取消。

将缓冲区视为单行主要影响元命令：在元命令后的缓冲区将被视为元命令的参数， 即使它跨越多行。(因此，您不能以这种方式创建使用元命令的脚本。请使用\i。)

如果指定了行号，psql将光标定位在文件或查询缓冲区的指定行上。 请注意，如果给出一个全是数字的参数， psql会假定它是一个行号，而不是文件名。

打印评估后的参数到标准输出，用空格分隔，并在末尾加上换行符。这对于在脚本的输出中插入信息很有用。例如:

=> \echo `date`
Tue Oct 26 21:40:57 CEST 1999

如果第一个参数是未引用的-n，则不会写入尾随的换行符（也不会写入第一个参数）。

这个命令获取并编辑指定函数或过程的定义，形式为CREATE OR REPLACE FUNCTION或 CREATE OR REPLACE PROCEDURE命令。 编辑方式与\edit相同。 如果您在不保存的情况下退出编辑器，则该语句将被丢弃。 如果您保存并退出编辑器，则如果添加了分号，则更新的命令将立即执行。 否则它将重新显示；键入分号或\g发送它，或\r取消。

目标函数可以仅通过名称指定，也可以通过名称和参数指定，例如foo(integer, text)。 如果有多个同名函数，则必须给出参数类型。

如果未指定函数，则会呈现一个空的CREATE FUNCTION模板供编辑。

如果指定了行号，psql将光标定位在函数体的指定行上。 （请注意，函数体通常不会从文件的第一行开始。）

与大多数其他元命令不同，整个行的剩余部分始终被视为\ef的参数， 参数中不进行变量插值或反引号扩展。

设置客户端字符集编码。没有参数时，此命令显示当前编码。

以最大的详细程度重复最近的服务器错误消息，就好像VERBOSITY被设置为verbose， SHOW_CONTEXT被设置为always一样。

这个命令获取并编辑指定视图的定义，形式为CREATE OR REPLACE VIEW命令。 编辑方式与\edit相同。 如果您在不保存的情况下退出编辑器，则该语句将被丢弃。 如果您保存并退出编辑器，则更新后的命令将立即执行， 如果您在其中添加了一个分号。否则将重新显示； 输入分号或\g发送它，或\r取消。

如果未指定视图，则会呈现一个空的CREATE VIEW模板供编辑。

如果指定了行号，psql将光标定位在视图定义的指定行上。

与大多数其他元命令不同，整个行的剩余部分始终被视为\ev的参数， 参数中不进行变量插值或反引号扩展。

设置未对齐查询输出的字段分隔符。默认值是竖线（|）。 它等同于\pset fieldsep。

将当前查询缓冲区发送到服务器以执行。

如果在\g后面出现括号，则括号中包围着一个空格分隔的option=value格式选项子句的列表，这些选项子句的解释方式与\psetoptionvalue命令相同，但仅在此查询的持续时间内生效。在此列表中，不允许在=符号周围有空格，但在选项子句之间需要空格。 如果省略了=value，则命名的option将以与\psetoption没有显式value时相同的方式更改。

如果提供了一个filename或|command参数， 查询的输出将被写入到指定的文件或通过给定的shell命令进行传输，而不是像通常那样显示出来。只有在查询成功返回零个或多个元组时，文件或命令才会被写入，而不是在查询失败或是非数据返回的SQL命令时。

如果当前查询缓冲区为空，则最近发送的查询将被重新执行。除此之外，没有任何参数的\g基本上等同于一个分号。 带有参数的\g提供了一个“一次性”替代\o命令的选择，并且还允许一次性调整通常由\pset设置的输出格式选项。

当最后一个参数以|开头时，整行剩余部分被视为要执行的command， 在其中不进行变量插值或反引号扩展。其余部分将被直接传递给shell。

显示当前查询缓冲区结果的描述（即列名和数据类型）。 查询不会实际执行；但是，如果包含某种语法错误，该错误将以正常方式报告。

如果当前查询缓冲区为空，则描述最近发送的查询。

获取环境变量env_var的值，并将其赋给psql变量psql_var。 如果env_var在psql进程的环境中未定义，psql_var不会被改变。示例：

=> \getenv home HOME
=> \echo :home
/home/postgres

将当前查询缓冲区发送到服务器，然后将查询输出的每行每列视为要执行的SQL语句。 例如，要在my_table的每一列上创建索引：

=> SELECT format('create index on my_table(%I)', attname)
-> FROM pg_attribute
-> WHERE attrelid = 'my_table'::regclass AND attnum > 0
-> ORDER BY attnum
-> \gexec
CREATE INDEX
CREATE INDEX
CREATE INDEX
CREATE INDEX

生成的查询按照返回的行的顺序执行，并在每行内从左到右执行，如果有多个列。NULL字段将被忽略。生成的查询文字 直接发送到服务器进行处理，因此它们不能是psql元命令，也不能包含psql 变量引用。如果任何单个查询失败，剩余查询的执行将继续，除非设置了ON_ERROR_STOP。每个查询的执行 都受ECHO处理的影响。（通常在使用\gexec时，将ECHO设置为 all或queries是明智的。）查询记录、单步模式、计时和其他查询执行功能也适用于每个生成的查询。

如果当前查询缓冲区为空，则重新执行最近发送的查询。

将当前查询缓冲区发送到服务器，并将查询的输出存储到psql变量中 (参见下面的Variables)。 要执行的查询必须返回一行。该行的每一列都存储在一个单独的变量中，变量名与列名相同。例如：

=> SELECT 'hello' AS var1, 10 AS var2
-> \gset
=> \echo :var1 :var2
hello 10

如果您指定一个prefix， 该字符串将被添加到查询的列名前，以创建要使用的变量名：

=> SELECT 'hello' AS var1, 10 AS var2
-> \gset result_
=> \echo :result_var1 :result_var2
hello 10

如果列的结果为NULL，则相应的变量将被取消设置，而不是被设置。

如果查询失败或者没有返回一行结果， 则不会改变任何变量。

如果当前查询缓冲区为空，则重新执行最近发送的查询。

\gx 等同于 \g，不同之处在于它强制为此查询启用扩展输出模式， 就好像在\pset选项列表中包含了expanded=on一样。另请参见\x。

给出指定SQL命令的语法帮助。如果未指定command， 则psql将列出所有可用语法帮助的命令。如果command是星号 (*)，则显示所有SQL命令的语法帮助。

与大多数其他元命令不同，整个行的剩余部分始终被视为\help的参数， 参数中不进行变量插值或反引号扩展。

打开HTML查询输出格式。如果HTML格式已经打开， 则切换回默认的对齐文本格式。此命令用于兼容性和便利性，但请参阅\pset 有关设置其他输出选项。

从文件filename中读取输入，并将其执行为 好像它是在键盘上键入的一样。

如果filename是- （连字符），那么标准输入将被读取，直到EOF指示或\q元命令。 这可用于将交互式输入与文件输入交错使用。请注意，仅当在最外层级别处于活动状态时，Readline行为才会被使用。

这组命令实现了可嵌套的条件块。条件块必须以\if开始，并以\endif结束。 在两者之间可以有任意数量的\elif子句，后面可以选择性地跟着一个\else子句。 在形成条件块的命令之间通常会出现普通查询和其他类型的反斜杠命令。

\if和\elif命令读取它们的参数，并将其作为布尔表达式进行评估。 如果表达式为true，则处理将继续进行；否则，直到达到匹配的\elif、 \else或\endif为止，将跳过行。一旦\if或 \elif测试成功，同一块中后续\elif命令的参数不会被评估，而是被视为false。 在\else之后的行只有在没有早期匹配的\if或\elif成功时才会被处理。

expression参数 是\if或\elif命令的参数， 受变量插值和反引号扩展的影响，就像任何其他反斜杠命令参数一样。 之后，它被评估为一个开/关选项变量的值。因此，有效值是以下任何一个不 含糊的不区分大小写匹配之一： true, false, 1, 0, on, off, yes, no。例如， t, T和tR 都将被视为true。

不正确评估为真或假的表达式将生成警告，并被视为false。

被跳过的行会被正常解析以识别查询和反斜杠命令，但查询不会发送到服务器， 而且除了条件命令（\if，\elif， \else，\endif）之外的反斜杠命令会被忽略。 仅检查跳过行中条件命令的有效嵌套。跳过行中的变量引用不会被展开， 也不会执行反引号扩展。

所有给定条件块的反斜杠命令必须出现在同一个源文件中。如果在主输入文件或一个 \include的文件上达到文件结束之前，所有本地 \if块都没有关闭， 那么psql将会引发错误。

这里是一个例子：

-- check for the existence of two separate records in the database and store
-- the results in separate psql variables
SELECT
    EXISTS(SELECT 1 FROM customer WHERE customer_id = 123) as is_customer,
    EXISTS(SELECT 1 FROM employee WHERE employee_id = 456) as is_employee
\gset
\if :is_customer
    SELECT * FROM customer WHERE customer_id = 123;
\elif :is_employee
    \echo 'is not a customer but is an employee'
    SELECT * FROM employee WHERE employee_id = 456;
\else
    \if yes
        \echo 'not a customer or employee'
    \else
        \echo 'this will never print'
    \endif
\endif

\ir命令类似于\i，但是解析 相对文件名的方式不同。在交互模式下执行时，这两个命令的行为是相同的。 然而，在脚本中调用时，\ir会将文件名解释为相对于 脚本所在目录，而不是当前工作目录。

列出服务器中的数据库，并显示它们的名称、拥有者、 字符集编码和访问权限。如果指定了 pattern， 则仅列出名称匹配该模式的数据库。如果在命令名称后附加 x， 则结果以扩展模式显示。如果在命令名称后附加 +， 则还会显示数据库大小、默认表空间和描述。 （大小信息仅适用于当前用户可以连接的数据库。）

从数据库中读取具有OID loid的大对象，并将其写入filename。请注意，这与服务器函数 lo_export略有不同，后者使用数据库服务器运行的用户权限， 并在服务器的文件系统上操作。

将文件存储到一个PostgreSQL大对象中。可选地，它将给定的注释与对象关联起来。例如:

foo=> \lo_import '/home/peter/pictures/photo.xcf' 'a picture of me'
lo_import 152801

响应表明大对象收到了对象ID 152801，这个ID可以用来在将来访问新创建的大对象。为了可读性起见，建议始终将一个可读的注释与每个对象关联起来。OID和注释都可以用\lo_list命令查看。

请注意，此命令与服务器端的lo_import略有不同，因为它作为本地用户在本地文件系统上操作，而不是服务器的用户和文件系统。

显示当前存储在数据库中的所有 PostgreSQL 大对象的列表，以及为它们提供的任何注释。 如果在命令名称后附加 x，则结果 以扩展模式显示。 如果在命令名称后附加 +， 则每个大对象将与其相关权限一起列出， 如果有的话。

从数据库中删除具有OID为loid的大对象。

安排将未来的查询结果保存到文件filename， 或将未来的结果传输到shell命令command。 如果未指定参数，则查询输出重置为标准输出。

如果参数以|开头，则整个剩余部分的行被视为要执行的command， 在其中不进行变量插值或反引号扩展。其余部分的行会被直接传递给 shell。

“查询结果”包括从数据库服务器获取的所有表、命令响应和通知，以及查询数据库的各种反斜杠命令的输出（例如\d）；但不包括错误消息。

将当前查询缓冲区打印到标准输出。 如果当前查询缓冲区为空，则打印最近执行的查询。

从当前查询缓冲区创建一个预处理语句，基于 目标预处理语句对象的名称。空字符串 表示未命名的预处理语句。

示例：

SELECT $1 \parse stmt1

此命令会使用扩展查询协议，与正常的 psql操作不同，后者使用简单查询协议。 此命令将发出一个 Parse (F) 消息，因此可以用于测试来自 psql的扩展查询协议。此命令仅影响下一个 执行的查询；所有后续查询将默认使用简单查询协议。

更改指定用户（默认为当前用户）的密码。此命令提示输入新密码，对其进行加密， 并将其作为ALTER ROLE命令发送到服务器。这样可以确保新密码 不会以明文形式出现在命令历史记录、服务器日志或其他地方。

提示用户提供文本，将其赋值给变量name。 可以指定一个可选的提示字符串text。 （对于多个单词的提示，用单引号括起文本。）

默认情况下，\prompt使用终端进行输入和输出。然而，如果使用了 -f命令行开关，\prompt将使用标准输入和标准输出。

这个命令设置影响查询结果表输出的选项。 option 指示要设置哪个选项。根据所选选项，value的语义会有所不同。 对于某些选项，省略value会导致该选项被切换或取消设置，具体描述在特定选项下。 如果没有提到这样的行为，那么省略value只会显示当前设置。

\pset不带任何参数时，显示所有打印选项的当前状态。

可调整的打印选项包括：

这些不同格式的示例可以在下面的Examples中看到。

退出psql程序。 在脚本文件中，只有该脚本的执行被终止。

这个命令与\echo命令相同，只是输出将被写入查询输出通道，由\o设置。

重置（清除）查询缓冲区。

使用提供的密钥进入“受限”模式。在此模式下，唯一允许的元命令是 \unrestrict，用于退出受限模式。密钥只能包含字母数字字符。

此命令主要用于由 pg_dump、 pg_dumpall 和 pg_restore 生成的纯文本转储，但在其他地方也可能有用。

打印psql的命令行历史记录到filename。 如果省略filename，历史记录将被写入标准输出（如果适用，将使用分页器）。 此命令在psql未启用Readline支持时不可用。

设置psql变量name为value，如果给出多个值，则设置为所有值的连接。 如果只给出一个参数，则将变量设置为空字符串值。要取消变量设置，请使用\unset命令。

\set没有任何参数时，显示当前设置的所有psql变量的名称和值。

有效的变量名可以包含字母、数字和下划线。有关详细信息，请参见下面的Variables。 变量名区分大小写。

某些变量是特殊的，它们控制psql的行为或者自动设置以反映连接状态。 这些变量在下面的Variables中有文档记录。

设置环境变量name为value，或者如果未提供value， 则取消设置环境变量。示例：

testdb=> \setenv PAGER less
testdb=> \setenv LESS -imx4F

这个命令获取并显示指定函数或过程的定义，以CREATE OR REPLACE FUNCTION或 CREATE OR REPLACE PROCEDURE命令的形式呈现。 定义将打印到当前查询输出通道，由\o设置。

目标函数可以仅通过名称指定，也可以通过名称和参数指定，例如foo(integer, text)。 如果有多个同名函数，则必须给出参数类型。

如果在命令名称后添加+，则输出的行将被编号，函数体的第一行将被标记为第1行。

与大多数其他元命令不同，整个行的剩余部分始终被视为\sf的参数， 参数中不进行变量插值或反引号扩展。

这个命令获取并显示指定视图的定义，以CREATE OR REPLACE VIEW命令的形式。 定义将打印到当前查询输出通道，由\o设置。

如果在命令名称后添加+，那么输出行将从1开始编号。

与大多数其他元命令不同，整个行的剩余部分始终被视为\sv的参数， 参数中不进行变量插值或反引号扩展。

这一组命令实现了 SQL 语句的管道化。 管道必须以 \startpipeline 开始，并以 \endpipeline 结束。在这之间可以有任意数量的 \syncpipeline 命令，它会发送一个 同步消息 而不结束正在进行的管道并刷新发送缓冲区。 在管道模式下，语句会在不等待前一个语句结果的情况下发送到服务器。 有关更多详细信息，请参见 第 32.5 节。

在管道进行时执行的所有查询都使用扩展查询协议。 当以分号结束时，查询会附加到管道中。 在进行中的管道中，可以使用元命令 \bind、 \bind_named、\close_prepared 或 \parse。在管道进行时，\sendpipeline 将 当前查询缓冲区附加到管道中。其他元命令如 \g、\gx 或 \gdesc 在管道模式下是不允许的。

\flushrequest 将一个刷新命令附加到管道， 允许使用 \getresults 读取结果，而无需发出同步或结束管道。 \getresults 将自动将未发送的数据推送到服务器。 \flush 可用于手动推送未发送的数据。

\getresults 接受一个可选的 number_results 参数。 如果提供，则仅读取前 number_results 个待处理结果。 如果未提供或 0，则读取所有待处理结果。

当管道模式处于活动状态时，提供一个专用的提示变量以报告管道状态。 有关更多详细信息，请参见 %P。

在管道模式下不支持 COPY。

示例：

\startpipeline
SELECT * FROM pg_class;
SELECT 1 \bind \sendpipeline
\flushrequest
\getresults
\endpipeline

切换显示输出列名标题和行数页脚。此命令等效于 \pset tuples_only，仅为方便起见提供。

指定在 table 标签中放置的属性，在 HTML 输出格式中。 该命令等效于 \pset tableattr table_options。

使用参数，打开或关闭显示每个SQL语句执行时间的功能。没有参数时，切换显示开关。 显示的时间单位为毫秒；超过1秒的时间间隔也以分钟:秒的格式显示，如有必要还会显示小时和天。

退出“受限”模式（即，所有其他元命令被阻止的模式）， 前提是指定的密钥与进入受限模式时提供给 \restrict 的密钥匹配。

此命令主要用于由 pg_dump、 pg_dumpall 和 pg_restore 生成的纯文本转储，但在其他地方也可能有用。

取消设置（删除）psql变量name。

大多数控制psql行为的变量不能被取消设置；相反，\unset命令被解释为将它们设置为默认值。 请参见下面的Variables。

将当前查询缓冲区写入文件filename或将其传输到shell命令command。 如果当前查询缓冲区为空，则写入最近执行的查询。

如果参数以|开头，则整个剩余部分的行被视为要执行的command， 在其中不进行变量插值或反引号扩展。其余部分的行会被直接传递给shell。

这个命令与\echo命令相同，只是输出将被写入psql的标准错误通道，而不是标准输出。

重复执行当前查询缓冲区（如 \g 所做的那样）， 直到被中断、查询失败、达到执行计数限制（如果给定）， 或查询不再返回最小行数。每次执行之间等待指定的秒数（默认 2 秒）。 默认等待时间可以通过变量 WATCH_INTERVAL 更改。 为了向后兼容， seconds 可以在有或没有 interval= 前缀的情况下指定。 每个查询结果都将显示一个包含 \pset title 字符串（如果有）、查询开始时的时间和延迟间隔的标题。

如果当前查询缓冲区为空，则重新执行最近发送的查询。

设置或切换扩展表格格式模式。因此，它等同于\pset expanded。

列出表、视图和序列及其相关的访问权限。 如果指定了一个 pattern， 则仅列出名称匹配该模式的表、视图和序列。默认情况下，仅显示用户创建的对象； 提供一个模式或 S 修饰符以包含系统对象。 如果在命令名称后附加 x，则结果将以扩展模式显示。

这是\dp的别名（“显示权限”）。

不带参数时，转义到一个子shell；psql在子shell退出时恢复。 带参数时，执行shell命令command。

与大多数其他元命令不同，整个行的剩余部分始终被视为\!的参数， 在参数中不执行变量插值或反引号扩展。行的其余部分被直接传递给shell。

显示帮助信息。可选的topic参数 （默认为commands）选择要解释的psql的哪个部分： commands描述psql的反斜杠命令； options描述可以传递给psql的命令行选项； 而variables显示关于psql配置变量的帮助。

反斜杠分号不像前面的命令那样是一个元命令；相反，它只是在不进行进一步处理的情况下将一个分号添加到查询缓冲区中。

通常，psql会在到达命令结束的分号时立即将SQL命令发送到服务器，即使当前行还有更多输入。因此，例如输入

select 1; select 2; select 3;

将导致三个SQL命令分别发送到服务器，每个命令的结果在继续下一个命令之前显示。然而，输入为\;的分号不会触发命令处理，因此它之前和之后的命令实际上被合并并作为一个请求发送到服务器。因此，例如

select 1\; select 2\; select 3;

在到达非反斜杠分号时将三个SQL命令发送到服务器的单个请求中。 服务器将执行此类请求作为单个事务，除非字符串中包含明确的BEGIN/COMMIT命令将其分成多个事务。(有关服务器如何处理多查询字符串的更多详细信息，请参见第 54.2.2.1 节。)