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

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

示例：

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

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

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

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

将 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    -- 仅更改 sslmode
=> \c postgresql://tom@localhost/mydb?application_name=myapp

设置作为查询结果打印的表的标题，或取消此类标题。该命令等价于\pset title title。（此命令的名称源自“caption”，因为它过去只用于设置 HTML 表的标题。）

将当前工作目录更改为 directory。如果没有参数，则切换到当前用户的主目录。

输出当前数据库连接的信息。

执行前端（客户端）复制。该操作会运行一个 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 或默认值。还显示相关的索引、约束、规则和触发器。对于外部表，还显示关联的外部服务器。（“匹配模式”的定义在下面的模式中。）

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

命令形式\d+与前者相同，但会显示更多信息：表列关联的注释、表是否包含 OID、当关系为视图时的视图定义、非默认的复制标识设置，以及当关系具有访问方法时的访问方法名称。

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

列出聚合函数，以及它们的返回类型和所作用的数据类型。如果指定了 pattern，则只显示名称与模式匹配的聚合。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。

列出访问方法。如果指定了 pattern，则只显示名称与模式匹配的访问方法。如果在命令名后追加 +，则每个访问方法都会连同其关联的处理器函数和描述一起列出。

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

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

列出与操作符族关联的操作符（见第 36.16.2 节）。如果指定了 access-method-pattern，则只列出关联访问方法的名称匹配该模式的操作符族成员。如果指定了 operator-family-pattern，则只列出名称匹配该模式的操作符族成员。如果在命令名后附加+，还会列出每个操作符的排序操作符族（如果它是一个排序操作符）。

列出与操作符族关联的支持函数（参见第 36.16.3 节）。如果指定了 access-method-pattern，则只列出与名称匹配该模式的访问方法所关联的操作符族函数。如果指定了 operator-family-pattern，则只列出名称与该模式匹配的操作符族函数。如果在命令名后追加 +，函数会以详细形式显示，并带有其实际参数列表。

列出表空间。如果指定了 pattern，则只显示名称与模式匹配的表空间。如果在命令名后追加 +，则每个表空间都会连同其关联选项、磁盘大小、权限和描述一起列出。

列出字符集编码之间的转换。如果指定了 pattern，则只列出名称与模式匹配的转换。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。如果在命令名后追加 +，则每个对象都会连同其相关描述一起列出。

列出服务器配置参数及其值。如果指定了 pattern，则只列出名称与模式匹配的参数。不带 pattern 时，只列出被设置为非默认值的参数。（使用 \dconfig * 可查看所有参数。）如果在命令名后追加 +，则每个参数都会连同其数据类型、该参数可设置的上下文以及访问权限（如果已授予非默认访问权限）一起列出。

列出类型转换。如果指定了 pattern，则只列出源类型或目标类型匹配该模式的类型转换。如果在命令名后附加+，还会列出每个对象关联的描述。

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

\dd 显示与 pattern 匹配的对象描述；如果没有给出参数，则显示相应类型的可见对象的描述。但无论哪种情况，只列出那些已有描述的对象。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。

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

列出域。如果指定了 pattern，则只显示名称与模式匹配的域。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。如果在命令名后追加 +，则每个对象都会连同其相关权限和描述一起列出。

列出默认访问权限设置。对于每个默认权限设置已偏离内置默认值的角色（以及适用时的模式），都会显示一条记录。如果指定了 pattern，则只列出角色名或模式名与模式匹配的记录。

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

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

列出外部服务器（助记词：“external servers”）。如果指定了 pattern，则只列出名称匹配该模式的服务器。如果使用\des+形式，则显示每个服务器的完整说明，包括服务器的访问权限、类型、版本、选项和描述。

列出外部表（助记词：“external tables”）。如果指定了 pattern，则只列出表名或模式名匹配该模式的条目。如果使用\det+形式，还会显示通用选项和外部表描述。

列出用户映射（助记词：“external users”）。如果指定了 pattern，则只列出用户名匹配该模式的映射。如果使用\deu+形式，还会显示每个映射的附加信息。

列出外部数据包装器（助记词：“external wrappers”）。如果指定了 pattern，则只列出名称匹配该模式的外部数据包装器。如果使用\dew+形式，还会显示外部数据包装器的访问权限、选项和描述。

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

列出全文检索配置。如果指定了 pattern，则只显示名称匹配该模式的配置。如果使用\dF+形式，则显示每个配置的完整说明，包括底层全文检索解析器和每种解析器词元类型的词典列表。

列出全文检索词典。如果指定了 pattern，则只显示名称匹配该模式的词典。如果使用\dFd+形式，还会显示每个选中词典的附加信息，包括底层全文检索模板和选项值。

列出全文检索解析器。如果指定了 pattern，则只显示名称匹配该模式的解析器。如果使用\dFp+形式，则显示每个解析器的完整说明，包括底层函数和可识别的词元类型列表。

列出全文检索模板。如果指定了 pattern，则只显示名称匹配该模式的模板。如果使用\dFt+形式，还会显示每个模板的附加信息，包括底层函数名。

列出数据库角色。（由于“用户”和“组”的概念已经统一为“角色”，此命令现在等价于\du。）默认只显示用户创建的角色；提供 S 修饰符可包含系统角色。如果指定了 pattern，则只列出名称匹配该模式的角色。如果使用\dg+形式，还会显示每个角色的附加信息；目前会增加每个角色的注释。

这是 \lo_list 的别名，后者会显示大对象列表。如果在命令名后追加 +，则会列出每个大对象的相关权限（如果有）。

列出过程语言。如果指定了 pattern，则只列出名称与模式匹配的语言。默认情况下，只显示用户创建的语言；提供 S 修饰符可包括系统对象。如果在命令名后追加 +，则每种语言都会连同其调用处理器、验证器、访问权限以及它是否为系统对象一起列出。

列出模式（命名空间）。如果指定了 pattern，则只列出名称与模式匹配的模式。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。如果在命令名后追加 +，则每个对象都会连同其相关权限和描述（如果有）一起列出。

列出操作符及其操作数类型和结果类型。如果指定了 pattern，则只列出名称与模式匹配的操作符。如果指定了一个 arg_pattern，则只列出其右参数类型名称与该模式匹配的前缀操作符。如果指定了两个 arg_pattern，则只列出参数类型名称与这些模式匹配的二元操作符。（对于一元操作符未使用的参数，也可以写成 -。）默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。如果在命令名后追加 +，则会显示每个操作符的附加信息，目前仅包括底层函数名。

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

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

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

列出分区关系。如果指定了 pattern，则只列出名称匹配该模式的条目。可以在命令后附加修饰符 t（表）和 i（索引），筛选要列出的关系类型。默认会列出分区表和分区索引。

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

如果在命令名后附加+，还会显示每个关系的各个分区的大小之和，以及该关系的描述。如果将 n 与+结合使用，则显示两个大小：一个是直接附加的叶子分区的总大小，另一个是所有分区的总大小，包括间接附加的子分区。

列出已定义的配置设置。这些设置可以特定于角色、特定于数据库，或同时特定于两者。role-pattern 和 database-pattern 分别用于选择要列出的角色和数据库。省略某个模式参数或将其指定为* 时，不会按该参数筛选，还会分别包含不特定于角色或不特定于数据库的设置。

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

列出每个被授予角色成员身份的信息，包括被授予的选项（ADMIN、INHERIT 和/或 SET）以及授予者。关于角色成员身份，参见 GRANT 命令。

默认情况下，只显示授予用户创建角色的成员身份；提供 S 修饰符可包括系统角色。如果指定了 pattern，则只列出授予名称与模式匹配的角色的成员身份。

列出逻辑复制发布。如果指定了 pattern，则只列出名称与模式匹配的发布。如果在命令名后追加 +，则还会显示与每个发布关联的表和模式。

列出逻辑复制订阅。如果指定了 pattern，则只列出名称与模式匹配的订阅。如果在命令名后追加 +，则会显示订阅的其他属性。

列出数据类型。如果指定了 pattern，则只列出名称与模式匹配的类型。如果在命令名后追加 +，则每个类型都会连同其内部名称、大小以及相关权限一起列出；对于 enum 类型，还会显示其允许值。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符可包括系统对象。

列出数据库角色。（由于“用户”和“组”的概念已经统一为“角色”，此命令现在等价于\dg。）默认只显示用户创建的角色；提供 S 修饰符可包含系统角色。如果指定了 pattern，则只列出名称匹配该模式的角色。如果使用\du+形式，还会显示每个角色的附加信息；目前会增加每个角色的注释。

列出已安装的扩展。如果指定了 pattern，则只列出名称匹配该模式的扩展。如果使用\dx+形式，则列出属于每个匹配扩展的所有对象。

列出扩展统计信息。如果指定了 pattern，则只列出名称与模式匹配的扩展统计信息。

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

列出事件触发器。如果指定了 pattern，则只列出名称与模式匹配的事件触发器。如果在命令名后追加 +，则每个对象都会连同其相关描述一起列出。

如果指定了 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，不同之处在于它强制为此查询启用扩展输出模式，就好像在\pset 选项列表中包含了 expanded=on 一样。另请参见\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 命令的参数就不再求值，而是被视为假。只有前面所有匹配的\if 和\elif 测试都未成功时，才会处理\else 后面的行。

与其他反斜线命令的参数一样，\if 或\elif 命令的 expression 参数会经过变量插值和反引号扩展。随后，按开/关选项变量值的规则对结果求值。因此，有效值是以下值的不区分大小写且无歧义的匹配：true、false、1、0、on、off、yes、no。例如，t、T 和 tR 都会被视为 true。

不能正确求值为真或假的表达式会产生警告，并被视为假。

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

同一个条件块的所有反斜线命令必须出现在同一个源文件中。如果主输入文件或通过\include 引入的文件到达 EOF 时，仍有本地\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，则只列出名称与模式匹配的数据库。如果在命令名后追加 +，则还会显示数据库大小、默认表空间和描述。当前用户对其拥有 CONNECT 权限的数据库可以显示大小信息；如果当前用户是超级用户或具有 pg_read_all_stats 角色的权限，也可以显示大小信息。

从数据库中读取具有 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 大对象列表，以及为它们提供的任何注释。如果在命令名后追加 +，则会列出每个大对象的相关权限（如果有）。

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

将后续查询结果保存到文件 filename，或通过管道传给 shell 命令 command。如果没有指定参数，查询输出将恢复为标准输出。

如果参数以|开头，则该行剩余的全部内容会被视为要执行的 command，其中不会进行变量插值或反引号扩展。该行剩余的内容只会原样传递给 shell。

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

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

更改指定用户（默认为当前用户）的密码。此命令提示输入新密码，对其进行加密，并将其作为 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 的参数，参数中不进行变量插值或反引号扩展。

切换输出中的列名标题和行数页脚的显示状态。这个命令等价于\pset tuples_only，提供它是为了使用方便。

指定在 HTML 输出格式中放在 table 标签内的属性。这个命令等价于\pset tableattr table_options。

带参数时，开启或关闭每条 SQL 语句执行耗时的显示。不带参数时，切换显示的开关状态。耗时以毫秒显示；超过 1 秒的时间间隔还会以分钟:秒的格式显示，必要时添加小时和天字段。

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

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

与大多数其他元命令不同，整个剩余行始终被视为\unrestrict 的参数，并且不会执行变量插值或反引号扩展。

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

大多数控制 psql 行为的变量不能取消设置；对于这些变量，\unset 命令会被解释为将其设置为默认值。参见下面的变量。

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

如果参数以|开头，则该行剩余的全部内容会被视为要执行的 command，其中不会进行变量插值或反引号扩展。该行剩余的内容只会原样传递给 shell。

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

重复执行当前查询缓冲区（如同 \g 一样），直到被中断、查询失败、达到执行次数上限（如果给定）或查询返回的行数低于最小要求。两次执行之间等待指定的秒数（默认 2 秒）。为保持向后兼容，seconds 可以带或不带 interval= 前缀。每次查询结果都会带有一个头部，其中包含 \pset title 字符串（如果有）、查询开始时的时间以及延迟间隔。

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

设置或切换扩展表格格式模式。它等价于\pset expanded。

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

这是\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 命令将其分成多个事务。（有关服务器如何处理多查询字符串的更多详细信息，请参见第 53.2.2.1 节。）