如果当前表输出格式未对齐，则切换为对齐。如果未对齐，则将其设置为未对齐。此命令保留是为了向后兼容。有关更通用的解决方案，请参阅 \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 传递或传递给 command。同样，执行权限是本地用户的，而不是服务器的，并且不需要 SQL 超级用户权限。

对于 \copy ... from stdin，数据行从发出命令的同一源读取，直到读取到只包含 \. 的行或流到达文件结束。此选项对于在 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 或默认值。还显示相关的索引、约束、规则和触发器。对于外部表，还显示相关的外部服务器。（“匹配模式”的定义见下面的 模式。）

对于某些类型的关系，\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，则结果以扩展模式显示。如果命令名称后附加了+，则还显示外部数据包装器的访问权限、选项和描述。

列出函数，以及它们的返回数据类型、参数数据类型和函数类型，函数类型分类为“agg”（聚合）、“normal”（普通）、“procedure”（过程）、“trigger”（触发器）或“window”（窗口）。要只显示特定类型的函数，请向命令添加相应的字母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（“嵌套”），或指定了模式，则包含非根分区关系，并显示一列以显示每个分区关系的父级。

如果命令名称后附加了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格式化选项子句列表，这些子句的解释方式与\pset option value命令相同，但仅在此查询期间生效。在此列表中，等号=周围不允许有空格，但选项子句之间必须有空格。如果省略=value，则命名option的更改方式与\pset option没有明确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 变量中（参见下面的 变量）。要执行的查询必须恰好返回一行。行的每一列都存储在一个单独的变量中，变量名与列名相同。例如

=> 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，不同之处在于它强制对该查询使用扩展输出模式，就像 expanded=on 包含在 \pset 选项列表中一样。另请参见 \x。

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

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

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

从文件 filename 读取输入并执行它，就像它是在键盘上输入的一样。

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

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

\if 和 \elif 命令读取其参数并将其评估为布尔表达式。如果表达式产生 true，则处理正常继续；否则，跳过行直到达到匹配的 \elif、\else 或 \endif。一旦 \if 或 \elif 测试成功，同一块中后续 \elif 命令的参数将不进行评估，并被视为 false。只有在没有先前的匹配 \if 或 \elif 成功的情况下，才处理 \else 后面的行。

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

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

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

给定条件块的所有反斜杠命令必须出现在同一源文件中。如果在所有本地 \if 块关闭之前，主输入文件或 \include-ed 文件达到 EOF，则 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 操作不同。此命令将发出 解析 (F) 消息，因此测试 psql 中的扩展查询协议可能很有用。此命令仅影响下一个执行的查询；默认情况下，所有后续查询都将使用简单查询协议。

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

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

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

此命令设置影响查询结果表输出的选项。option 指示要设置哪个选项。value 的语义因所选选项而异。对于某些选项，省略 value 会导致选项被切换或取消设置，如特定选项下所述。如果没有提到这种行为，则省略 value 只会导致显示当前设置。

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

可调整的打印选项是

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

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

此命令与 \echo 相同，不同之处在于输出将写入到由 \o 设置的查询输出通道。

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

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

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

将 psql 的命令行历史记录打印到 filename。如果省略 filename，则历史记录将写入标准输出（如果适用，使用寻呼机）。如果 psql 未在 Readline 支持下构建，则此命令不可用。

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

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

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

某些变量是特殊的，因为它们控制 psql 的行为或自动设置以反映连接状态。这些变量在下面的变量中进行了说明。

将环境变量 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 将一个 flush 命令附加到管道中，允许使用 \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 命令被解释为将它们设置为其默认值。请参阅下面的变量。

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

如果参数以 | 开头，则行的其余部分将被视为要执行的 command，并且其中不执行变量插值或反引号扩展。行的其余部分只是按字面意思传递给 shell。

此命令与 \echo 相同，不同之处在于输出将写入 psql 的标准错误通道，而不是标准输出。

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

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

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

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

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

不带参数时，转义到子 shell；当子 shell 退出时，psql 恢复。带参数时，执行 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 节。）