psql

如果当前表格输出格式是非对齐，则切换为对齐；否则切换为非对齐。保留此命令是为了向后兼容。更通用的解决方案请参见\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服务器的新连接。可以使用位置语法（数据库名称、用户、主机和端口中的一个或多个）指定要使用的连接参数，也可以使用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    -- 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时，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) 的单元格保存查询结果中 colH=x 且 colV=y 那一行的 colD 值。没有匹配行时单元格为空；存在多行时会报错。

对于每个与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，结果会以扩展模式显示。如果在命令名后追加 +，则每个对象都会连同其持久性状态（永久、临时或不记录 WAL）、磁盘上的物理大小以及相关描述（如果有）一起列出。如果指定了 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，结果会以扩展模式显示。如果在命令名后追加 +，则会显示每个模板的附加信息，包括底层函数名。

列出数据库角色。（由于“用户”和“组”的概念已经统一为“角色”，此命令现在等同于 \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格式选项子句列表。这些子句的解释方式与\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 读取参数并将其作为布尔表达式求值。结果为真时继续正常处理，否则跳过后续行，直到遇到匹配的 \elif、\else 或 \endif。某个 \if 或 \elif 条件成立后，同一块中后续 \elif 的参数不再求值，直接视为假。只有之前匹配的 \if 和 \elif 均未成立，才处理 \else 后的行。

与其他反斜杠命令参数一样，\if 或 \elif 的表达式参数先进行变量插值和反引号展开，然后像开关选项变量一样求值。有效值为 true、false、1、0、on、off、yes、no 的任意无歧义、不区分大小写的匹配。例如 t、T 和 tR 都会视为真。

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

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

同一个条件块的所有反斜线命令必须出现在同一个源文件中。如果主输入文件或通过\include引入的文件到达 EOF 时，仍有本地\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，结果会以扩展模式显示。如果在命令名后追加 +，则还会显示数据库大小、默认表空间和描述。当前用户对其拥有 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 大对象列表，以及为它们提供的任何注释。如果在命令名后追加 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变量的名称和值。

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

某些变量是特殊的，它们控制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 命令，使得可以在不发送 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，提供它是为了使用方便。

指定在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 秒）。默认等待时间可通过变量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 节。）