如果当前的表输出格式为未对齐，则将其切换为对齐。如果不是未对齐的，则将其设置为未对齐。保留此命令是为了向后兼容。有关更通用的解决方案，请参阅 \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    -- changes only sslmode
=> \c postgresql://tom@localhost/mydb?application_name=myapp

设置任何作为查询结果打印的表的标题，或者取消任何此类标题。此命令等效于 \pset title title。（此命令的名称源于“标题”，因为它以前仅用于设置表格中的标题。）HTML表格。）

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

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

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

当指定 program 时，command 由 psql 执行，并且从 command 传递或传递到 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 节）。如果指定了访问方法模式，则只列出与名称匹配该模式的访问方法关联的操作符类。如果指定了输入类型模式，则只列出与名称匹配该模式的输入类型关联的操作符类。如果将+附加到命令名称，则会列出每个操作符类及其关联的操作符族和所有者。

列出操作符族（参阅第 36.16.5 节）。如果指定了访问方法模式，则只列出与名称匹配该模式的访问方法关联的操作符族。如果指定了输入类型模式，则只列出与名称匹配该模式的输入类型关联的操作符族。如果将+附加到命令名称，则会列出每个操作符族及其所有者。

列出与操作符族关联的操作符（参阅第 36.16.2 节）。如果指定了访问方法模式，则只列出与名称匹配该模式的访问方法关联的操作符族的成员。如果指定了操作符族模式，则只列出与名称匹配该模式的操作符族的成员。如果将+附加到命令名称，则会列出每个操作符及其排序操作符族（如果它是一个排序操作符）。

列出与操作符族关联的支持函数（参阅第 36.16.3 节）。如果指定了访问方法模式，则只列出与名称匹配该模式的访问方法关联的操作符族的函数。如果指定了操作符族模式，则只列出与名称匹配该模式的操作符族的函数。如果将+附加到命令名称，则会详细显示函数，包括它们的实际参数列表。

列出表空间。如果指定了模式，则只显示名称与该模式匹配的表空间。如果将+附加到命令名称，则会列出每个表空间及其相关选项、磁盘大小、权限和描述。

列出字符集编码之间的转换。如果指定了模式，则只列出名称与该模式匹配的转换。默认情况下，只显示用户创建的对象；提供一个模式或S修饰符以包括系统对象。如果将+附加到命令名称，则会列出每个对象及其关联的描述。

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

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

显示类型为约束、操作符类、操作符族、规则和触发器的对象的描述。所有其他注释可以通过这些对象类型的各自的反斜杠命令查看。

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

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

列出域。如果指定了模式，则只显示名称与该模式匹配的域。默认情况下，只显示用户创建的对象；提供一个模式或S修饰符以包括系统对象。如果将+附加到命令名称，则会列出每个对象及其关联的权限和描述。

列出默认访问权限设置。对于每个角色（以及适用的模式），如果其默认权限设置已从内置默认值更改，则会显示一个条目。如果指定了模式，则只列出角色名称或模式名称与该模式匹配的条目。

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

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

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

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

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

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

列出函数及其结果数据类型、参数数据类型和函数类型，函数类型分为 “agg”（聚合）、“normal”（普通）、“procedure”（过程）、“trigger”（触发器）或 “window”（窗口）。要仅显示特定类型的函数，请在命令中添加相应的字母 a、n、p、t 或 w。如果指定了 pattern，则仅显示名称与模式匹配的函数。任何其他参数都是类型名称模式，这些模式与函数的第一个、第二个等等参数的类型名称匹配。（匹配函数可以具有比您指定的更多的参数。为了防止这种情况，请在最后一个 arg_pattern 中写入短划线 -。）默认情况下，仅显示用户创建的对象；提供一个模式或 S 修饰符来包括系统对象。如果使用 \df+ 形式，则会显示有关每个函数的其他信息，包括易失性、并行安全性、所有者、安全分类、访问权限、语言、内部名称（仅适用于 C 和内部函数）和描述。可以使用 \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（“嵌套”）或指定模式，则会包括非根分区关系，并且会显示一列，其中显示每个分区关系的父关系。

如果将 + 附加到命令名称，还会显示每个关系的分区大小总和以及关系的描述。如果 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，则会以与没有显式 value 的 \pset option 相同的方式更改已命名的 option。

如果给定 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 行为。

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

\if 和 \elif 命令读取其参数并将其评估为布尔表达式。如果表达式产生 true，则处理将正常继续；否则，将跳过这些行，直到到达匹配的 \elif、\else 或 \endif 为止。一旦 \if 或 \elif 测试成功，则不会评估同一块中稍后 \elif 命令的参数，而是将其视为 false。仅当之前没有匹配的 \if 或 \elif 成功时，才会处理 \else 后面的行。

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

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

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

给定条件块的所有反斜杠命令都必须出现在同一源文件中。如果在关闭所有本地 \if 块之前到达主输入文件或 \include 的文件的 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，则仅列出名称与模式匹配的数据库。如果命令名称后附加了 +，则还会显示数据库大小、默认表空间和描述。（大小信息仅适用于当前用户可以连接的数据库。）

从数据库中读取具有OID loid 的大型对象，并将其写入 filename。请注意，这与服务器函数 lo_export 有细微差别，后者以数据库服务器运行的用户权限在服务器的文件系统上运行。

将文件存储到 PostgreSQL 大型对象中。 可以选择将给定的注释与对象关联。 示例：

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

响应表明大型对象接收到对象 ID 152801，该 ID 可用于在将来访问新创建的大型对象。 为了便于阅读，建议始终将人类可读的注释与每个对象关联。 可以使用 \lo_list 命令查看 OID 和注释。

请注意，此命令与服务器端的 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 设置的查询输出通道。

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

将 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 秒的间隔也以分钟：秒格式显示，如果需要，还会添加小时和天数字段。

取消设置（删除）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 节）。