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

为下一次查询执行设置查询参数，指定的参数会被传递给任何参数占位符（$1 等）。

Example:

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

这也适用于 \g 之外的其他查询执行命令，例如 \gx 和 \gset。

这个命令会让扩展查询协议（见 Section 54.1.2）被使用，而正常的 psql 操作使用的是简单查询协议。因此，这个命令对于从 psql 测试扩展查询协议很有用。（即使查询没有参数且此命令指定了零个参数，也会使用扩展查询协议。）这个命令只影响下一次执行的查询；所有后续查询默认仍会使用简单查询协议。

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

Example:

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

这个命令会让扩展查询协议（见 Section 54.1.2）被使用，而正常的 psql 操作使用的是简单查询协议。因此，这个命令对于从 psql 测试扩展查询协议很有用。

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

把 dbname、username、host 或 port 指定为 - 等价于省略该参数。

新连接可以复用上一个连接的连接参数；不仅是数据库名、用户、主机和端口，还包括诸如 sslmode 之类的其他设置。默认情况下，位置语法会复用参数，但给定 conninfo 字符串时则不会。传递第一个参数 -reuse-previous=on 或 -reuse-previous=off 将覆盖该默认行为。如果复用参数，那么任何没有作为位置参数或在 conninfo 字符串中显式指定的参数都将取自现有连接的参数。一个例外是，如果使用位置语法把 host 设置改成了与之前不同的值，那么现有连接参数中存在的任何 hostaddr 设置都会被丢弃。另外，只有当用户、主机和端口设置都没有改变时，现有连接使用的密码才会被复用。当命令既不指定也不复用某个特定参数时，将使用 libpq 的默认值。

如果新连接成功建立，上一个连接就会被关闭。如果连接尝试失败（用户名错误、访问被拒绝等），在 psql 处于交互模式时会保留上一个连接。但在执行非交互式脚本时，旧连接会被关闭并报告一个错误。这可能会也可能不会终止脚本；如果没有终止，那么在另一个 \connect 命令成功执行之前，所有访问数据库的命令都会失败。这种区别的选定是出于用户便利的考虑：一方面防止拼写错误，另一方面作为一种安全机制，防止脚本意外地作用于错误的数据库。注意，每当 \connect 命令尝试复用参数时，被复用的值是上一次成功连接的值，而不是其后任何失败尝试的值。但是，在非交互式的 \connect 失败的情况下，之后不允许复用任何参数，因为脚本很可能期望复用失败的 \connect 所使用的值。

Examples:

=> \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。

关闭指定的预备语句。空字符串表示未命名的预备语句。如果不存在具有该名称的预备语句，则该操作是一个空操作。

Example:

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 值排序后出现在水平表头中。

在交叉表网格内，对于每个不同的 x 值（来自 colH）和每个不同的 y 值（来自 colV），位于交叉点 (x,y) 处的单元格包含 colD 列在该查询结果行中的值，该行满足 colH 的值为 x 且 colV 的值为 y。如果不存在这样的行，该单元格为空。如果存在多个这样的行，则会报告一个错误。

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

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

命令形式 \d+ 与之相同，但会显示更多信息：会显示与表的列相关联的任何注释，以及表中是否存在 OID；如果该关系是视图，还会显示视图定义；以及非默认的 replica identity（复制标识）设置和 access method（访问方法）名称（如果该关系有访问方法）。

默认情况下只显示用户创建的对象；提供一个模式或 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 修饰符可以包含系统对象。

列出外部服务器（助记：“外部服务器”）。如果指定了 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 命令用于设置访问特权。特权显示的含义在 Section 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 表示未请求它。你可以使用 pg_stats_ext 来了解是否运行过 ANALYZE 以及统计信息是否可供规划器使用。

列出事件触发器。如果指定了 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 处理。（把 ECHO 设置为 all 或 queries 在使用 \gexec 时通常是明智的。）查询日志记录、单步模式、计时以及其他查询执行特性也同样适用于每个生成的查询。

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

把当前查询缓冲区发送到服务器，并把查询的输出存储到 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，不同之处在于它强制这个查询使用扩展输出模式，就像 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。跟在 \else 之后的行仅在没有更早的匹配 \if 或 \elif 成功时才会被处理。

expression 参数（属于某个 \if 或 \elif 命令）会像任何其他反斜杠命令参数一样接受变量插值和反引号展开。在此之后，它会像一个开/关选项变量的值那样被求值。因此，一个有效的值是对 true、false、1、0、on、off、yes、no 中某一个的无歧义的大小写不敏感匹配。例如，t、T 和 tR 都会被认为是 true。

不能正确求值为 true 或 false 的表达式会产生一个警告并被当作 false。

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

一个给定条件块的所有反斜杠命令必须出现在同一个源文件中。如果在主输入文件或某个被 \include 的文件中，在所有本地 \if 块被关闭之前到达了 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，结果将以扩展模式显示。如果在命令名后面附加了 +，还会显示数据库的大小、默认表空间和描述。大小信息仅适用于当前用户拥有 CONNECT 特权的数据库，或者当前用户是超级用户或拥有 pg_read_all_stats 角色的特权时才可用。

从数据库中读取具有 OID loid 的大对象，并将其写入 filename。注意，这与服务器函数 lo_export 有着细微的不同，后者以数据库服务器运行时所用的用户的权限进行操作，并且作用于服务器的文件系统。

把文件存储到一个 PostgreSQL 大对象中。可选地，它会把给定的注释与该对象关联起来。示例：

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

该响应表明这个大对象被赋予了对象 ID 152801，以后可以使用它来访问这个新创建的大对象。为了便于阅读，建议始终为每个对象关联一个人类可读的注释。OID 和注释都可以用 \lo_list 命令查看。

注意，这个命令与服务器端的 lo_import 有着细微的不同，因为它以本地用户的身份在本地文件系统上操作，而不是以服务器的用户和文件系统操作。

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

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

安排把未来的查询结果保存到文件 filename 中，或者把未来的结果通过管道传给 shell 命令 command。如果没有指定参数，查询输出会被重置为标准输出。

如果参数以 | 开头，那么该行其余的全部内容都会被视为要执行的 command，并且在其中既不进行变量插值，也不进行反引号展开。该行的其余部分会被原样传递给 shell。

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

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

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

Example:

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 命令，它们会发出一个 sync message，而不会结束正在进行的流水线，也不会冲刷发送缓冲区。在流水线模式中，语句被发送到服务器，而不需要等待之前语句的结果。更多细节请参见 Section 32.5。

在流水线进行期间执行的所有查询都使用扩展查询协议。以分号结尾的查询会被追加到流水线中。元命令 \bind、\bind_named、\close_prepared 或 \parse 可以在正在进行的流水线中使用。在流水线进行期间，\sendpipeline 会把当前查询缓冲区追加到流水线中。其他元命令（例如 \g、\gx 或 \gdesc）在流水线模式中是不允许使用的。

\flushrequest 会向流水线追加一个冲刷命令，使得可以用 \getresults 读取结果，而不必发出 sync 或结束流水线。\getresults 会自动把未发送的数据推送到服务器。\flush 可用于手动推送未发送的数据。

\getresults 接受一个可选的 number_results 参数。如果提供了该参数，则只会读取前 number_results 个待处理的结果。如果没有提供该参数或者它为 0，则会读取所有待处理的结果。

当流水线模式处于活动状态时，有一个专用的提示符变量可用于报告流水线状态。更多细节请参见 %P

在流水线模式中不支持 COPY。

Example:

\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 生成的纯文本转储中，但在其他地方也可能有用。

与大多数其他元命令不同，该行的其余内容总是被当作 \unrestrict 的参数，并且不会执行变量插值或反引号展开。

取消设置（删除）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；当子 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 命令把它划分成多个事务。（关于服务器如何处理多查询字符串的更多细节，请参见 Section 54.2.2.1。）