如果当前表格输出格式是不对齐，则切换为对齐；否则切换为不对齐。保留此命令是为了向后兼容。更通用的解决方案请参见\pset。

为下一次查询执行设置查询参数，并将指定参数传给任意参数占位符（$1 等）。

示例：

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

这对除 \g 之外的查询执行命令也有效，例如 \gx 和 \gset。

此命令会使用扩展查询协议（参见Section 51.1.2），不同于psql通常使用的简单查询协议。因此，可以用它在psql中测试扩展查询协议。（即使查询没有参数，而且此命令指定了零个参数，也会使用扩展查询协议。）此命令只影响下一条被执行的查询；之后的所有查询默认仍会使用简单查询协议。

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

示例：

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

此命令会使用扩展查询协议（参见 Section 51.1.2），不同于psql通常使用的简单查询协议。因此，可以用它在psql中测试扩展查询协议。

建立到PostgreSQL服务器的新连接。可以使用位置语法（数据库名称、用户、主机和端口中的一个或多个）指定要使用的连接参数，也可以使用详细说明在Section 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。如果没有参数，则切换到当前用户的主目录。关于如何确定主目录，请参见 Section 32.16。

关闭指定的预备语句。空字符串表示未命名的预备语句。如果不存在该名称的预备语句，则该操作不执行任何操作。

示例：

SELECT $1 \parse stmt1
\close_prepared stmt1

此命令会使用扩展查询协议，不同于psql通常使用的简单查询协议。因此，可以用它在psql中测试扩展查询协议。

输出当前数据库连接的信息；如果正在使用 SSL，也包括与 SSL 相关的信息。

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

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

当指定program时，command 由psql执行，传给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，结果会以扩展模式显示。如果在命令名后追加 +，则每个访问方法都会连同其关联的处理器函数和描述一起列出。

列出操作符类（参见 Section 36.16.1）。如果指定了 access-method-pattern，则只列出与名称匹配该模式的访问方法关联的操作符类。如果指定了 input-type-pattern，则只列出与名称匹配该模式的输入类型关联的操作符类。如果在命令名后追加 x，结果会以扩展模式显示。如果在命令名后追加 +，则每个操作符类都会连同其关联的操作符族和所有者一起列出。

列出操作符族（参见 Section 36.16.5）。如果指定了 access-method-pattern，则只列出与名称匹配该模式的访问方法关联的操作符族。如果指定了 input-type-pattern，则只列出与名称匹配该模式的输入类型关联的操作符族。如果在命令名后追加 x，结果会以扩展模式显示。如果在命令名后追加 +，则每个操作符族都会连同其所有者一起列出。

列出与操作符族关联的操作符（参见 Section 36.16.2）。如果指定了 access-method-pattern，则只列出与名称匹配该模式的访问方法所关联的操作符族成员。如果指定了 operator-family-pattern，则只列出名称与该模式匹配的操作符族成员。如果在命令名后追加 x，结果会以扩展模式显示。如果在命令名后追加 +，则每个操作符都会连同其排序操作符族（如果它是排序操作符）以及其底层函数是否防漏一起列出。

列出与操作符族关联的支持函数（参见 Section 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命令用于设置默认访问权限。权限显示的含义在Section 5.8中有解释。

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

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

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

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

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

列出函数，以及它们的结果数据类型、参数数据类型和函数类型，函数类型分为 “agg”（聚合）、“normal”、“procedure”、“trigger” 或 “window”。要只显示特定类型的函数，请在命令后添加相应的字母 a、n、p、t 或 w。如果指定了 pattern，则只显示名称与模式匹配的函数。任何附加参数都是类型名模式，分别与函数第一、第二等参数的类型名匹配。（匹配到的函数可以比你指定的参数更多；若要防止这种情况，可将破折号 - 写成最后一个 arg_pattern。）默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。如果在命令名后追加 x，结果会以扩展模式显示。如果在命令名后追加 +，则会显示每个函数的附加信息，包括易变性、并行安全性、所有者、安全分类、是否防漏、访问权限、语言、内部名称（仅适用于 C 和 internal 函数）以及描述。特定函数的源代码可通过 \sf 查看。

列出文本搜索配置。如果指定了 pattern，则只显示名称与模式匹配的配置。如果在命令名后追加 x，结果会以扩展模式显示。如果在命令名后追加 +，则会显示每个配置的完整描述，包括底层文本搜索解析器以及每种记号类型对应的词典列表。

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

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

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

列出数据库角色。（由于 “users” 和 “groups” 的概念已经统一为 “roles”，此命令现在等同于 \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 命令用于设置访问权限。权限显示的含义在 Section 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 修饰符可包括系统对象。

列出数据库角色。（由于 “users” 和 “groups” 的概念已经统一为 “roles”，此命令现在等同于 \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。

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

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

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

下面是一个示例：

-- 检查数据库中是否存在两条不同的记录，并将
-- 结果分别存入不同的 psql 变量
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，结果会以扩展模式显示。如果在命令名后追加 +，则还会显示数据库大小、默认表空间和描述。（只有当前用户能够连接的数据库才会显示大小信息。）

从数据库中读取具有OIDloid的大对象，并将其写入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不带任何参数时，显示所有打印选项的当前状态。

可调整打印选项有:

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

退出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 命令，它会发送一条同步消息，但不会结束当前管道，并会刷新发送缓冲区。在管道模式下，语句会被发送到服务器，而不等待前面语句的结果。更多细节见 Section 32.5。

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

\flushrequest 会向管道追加一条 flush 命令，使得可以在不发送 sync 或结束管道的情况下通过 \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命令将其分成多个事务。(有关服务器如何处理多查询字符串的更多详细信息，请参见Section 51.2.2.1。)