如果当前表格输出格式为不对齐，则切换为对齐。如果它不是不对齐，则设置为不对齐。此命令保留用于向后兼容性。参见\pset以获取更通用的解决方案。

建立到PostgreSQL服务器的新连接。可以使用位置语法（数据库名称、用户、主机和端口中的一个或多个）指定要使用的连接参数，也可以使用详细说明在第 34.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表格中的标题。）

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

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

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

当指定program时，由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或默认值。 还显示相关的索引、约束、规则和触发器。对于外部表，还显示关联的外部服务器。 （“匹配模式”的定义在下面的Patterns中。）

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

命令形式\d+与相同，只是显示更多信息：显示与表列相关的任何注释， 表中的OID的存在，如果关系是视图，则显示视图定义，非默认的 复制标识设置以及 如果关系具有访问方法，则显示 访问方法名称。

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

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

列出访问方法。如果指定了pattern， 则仅显示名称与该模式匹配的访问方法。如果在命令名称后附加+， 则每个访问方法将显示其关联的处理函数和描述。

列出操作符类别 (参见第 38.16.1 节)。 如果指定了access-method-pattern， 则仅列出与名称匹配该模式的访问方法关联的操作符类别。 如果指定了input-type-pattern， 则仅列出与名称匹配该模式的输入类型关联的操作符类别。 如果在命令名称后附加+，则每个操作符类别都将列出其关联的操作符族和所有者。

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

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

列表支持与运算符族相关的函数（参见第 38.16.3 节）。 如果指定了access-method-pattern， 则仅列出与名称匹配该模式的访问方法关联的运算符族的函数。 如果指定了operator-family-pattern， 则仅列出与名称匹配该模式的运算符族的函数。 如果在命令名称后附加+，则以其实际参数列表详细显示函数。

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

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

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

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

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

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

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

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

列出默认访问权限设置。每个角色（如果适用，还包括模式）的默认权限设置已从内置默认值更改的条目都会显示。 如果指定了pattern，则仅列出角色名称或模式名称与该模式匹配的条目。

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

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

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

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

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

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

列出函数及其结果数据类型、参数数据类型和函数类型，这些函数被分类为“agg”（聚合）、“normal”、“procedure”、“trigger”或“window”。 要仅显示特定类型的函数，将相应的字母a、n、p、t或w添加到命令中。 如果指定了pattern，则仅显示名称与该模式匹配的函数。 任何额外的参数都是类型名称模式，这些模式与函数的第一个、第二个等参数的类型名称匹配。（匹配的函数可能具有比您指定的更多的参数。为了防止这种情况，将破折号-写为最后一个arg_pattern。） 默认情况下，仅显示用户创建的对象；提供一个模式或S修饰符以包括系统对象。 如果使用形式\df+，将显示有关每个函数的其他信息，包括不稳定性、并行安全性、所有者、安全分类、访问权限、语言、源代码和描述。

列出文本搜索配置。 如果指定了pattern， 则只显示名称与该模式匹配的配置。 如果使用形式\dF+，则显示每个配置的完整描述， 包括底层文本搜索解析器和每个解析器标记类型的字典列表。

列出文本搜索字典。 如果指定了pattern， 则只显示名称与该模式匹配的字典。 如果使用形式\dFd+，则会显示有关每个选定字典的 附加信息，包括基础文本搜索模板和选项值。

列出文本搜索解析器。 如果指定了pattern， 则只显示名称与该模式匹配的解析器。 如果使用形式\dFp+，则会显示每个解析器的完整描述， 包括底层函数和识别的标记类型列表。

列出文本搜索模板。 如果指定了pattern， 则只显示名称与该模式匹配的模板。 如果使用形式\dFt+，则会显示有关每个模板的额外信息， 包括底层函数名称。

列出数据库角色。 (由于“用户”和“组”的概念已经统一为“角色”，因此此命令现在等效于\du。) 默认情况下，只显示用户创建的角色；提供S修饰符以包括系统角色。 如果指定了模式，则只列出名称与模式匹配的角色。 如果使用形式\dg+，则会显示有关每个角色的其他信息；目前这会为每个角色添加注释。

这是\lo_list的别名，用于显示大对象的列表。 如果在命令名称后添加+， 则每个大对象将显示其关联的权限（如果有）。

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

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

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

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

列出具有其关联访问权限的列表、表和序列。 如果指定了pattern，则只列出名称与模式匹配的表、视图和序列。

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

列出分区关系。 如果pattern被指定， 则只列出名称与模式匹配的条目。 修饰符t（表）和i（索引） 可以附加到命令，过滤要列出的关系类型。默认情况下，列出分区表和索引。

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

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

列出定义的配置设置。这些设置可以是特定于角色、特定于数据库，也可以是两者兼有的。 role-pattern和database-pattern用于分别选择要列出的特定角色和数据库。 如果省略，或者指定了*，则列出所有设置，包括那些不特定于角色或数据库的设置。

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

列出复制出版物。 如果指定了pattern，则仅列出名称与模式匹配的出版物。 如果在命令名称后附加+，则还会显示与每个出版物关联的表和模式。

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

列出数据类型。 如果pattern被指定，只有名称与模式匹配的类型会被列出。 如果在命令名称后添加+，每种类型将被列出其内部名称和大小，如果是enum类型，则列出其允许的值，以及其关联的权限。 默认情况下，只显示用户创建的对象；提供一个模式或S修饰符以包括系统对象。

列出数据库角色。 (由于“用户”和“组”的概念已经统一为“角色”，因此此命令现在等效于\dg。) 默认情况下，只显示用户创建的角色；提供S修饰符以包括系统角色。 如果指定了模式，则仅列出名称与模式匹配的角色。 如果使用形式\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格式选项子句的列表，这些选项子句的解释方式与\psetoptionvalue命令相同，但仅在此查询的持续时间内生效。在此列表中，不允许在=符号周围有空格，但在选项子句之间需要空格。 如果省略了=value，则命名的option将以与\psetoption没有显式value时相同的方式更改。

如果提供了一个filename或|command参数， 查询的输出将被写入到指定的文件或通过给定的shell命令进行传输，而不是像通常那样显示出来。只有在查询成功返回零个或多个元组时，文件或命令才会被写入，而不是在查询失败或是非数据返回的SQL命令时。

如果当前查询缓冲区为空，则最近发送的查询将被重新执行。除此之外，没有任何参数的\g基本上等同于一个分号。 带有参数的\g提供了一个“一次性”替代\o命令的选择，并且还允许一次性调整通常由\pset设置的输出格式选项。

当最后一个参数以|开头时，整行剩余部分被视为要执行的命令， 在其中不进行变量插值或反引号扩展。其余部分将被直接传递给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

如果您指定一个前缀， 该字符串将被添加到查询的列名前，以创建要使用的变量名：

=> 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将会引发错误。

这里是一个例子:

-- 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，则只列出名称与模式匹配的数据库。 如果在命令名称后附加+，还会显示数据库大小、默认表空间和描述。 （大小信息仅适用于当前用户可以连接的数据库。）

从数据库中读取具有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。

安排将未来的查询结果保存到文件文件名， 或将未来的结果传输到shell命令命令。 如果未指定参数，则查询输出重置为标准输出。

如果参数以|开头，则整个剩余部分的行被视为要执行的命令， 在其中不进行变量插值或反引号扩展。其余部分的行会被直接传递给shell。

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

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

更改指定用户（默认为当前用户）的密码。此命令提示输入新密码，对其进行加密， 并将其作为ALTER ROLE命令发送到服务器。这样可以确保新密码 不会以明文形式出现在命令历史记录、服务器日志或其他地方。

提示用户提供文本，将其赋值给变量name。 可以指定一个可选的提示字符串text。 （对于多个单词的提示，用单引号括起文本。）

默认情况下，\prompt 使用终端进行输入和输出。然而，如果使用了 -f 命令行开关，\prompt 将使用标准输入和标准输出。

这个命令设置影响查询结果表输出的选项。 option 指示要设置哪个选项。根据所选选项，value的语义会有所不同。 对于某些选项，省略value会导致该选项被切换或取消设置，具体描述在特定选项下。 如果没有提到这样的行为，那么省略value只会显示当前设置。

\pset不带任何参数时，显示所有打印选项的当前状态。

可调打印选项包括:

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

退出psql程序。 在脚本文件中，只有该脚本的执行被终止。

这个命令与\echo命令相同，只是输出将被写入查询输出通道，由\o设置。

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

打印psql的命令行历史记录到文件名。 如果省略文件名，历史记录将被写入标准输出（如果适用，将使用分页器）。 如果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的参数， 参数中不进行变量插值或反引号扩展。

切换显示输出列名标题和行数页脚。此命令等效于\pset tuples_only， 仅为方便起见提供。

指定在table标签中放置的属性，在HTML输出格式中。 该命令等效于\pset tableattr table_options。

使用参数，打开或关闭显示每个SQL语句执行时间的功能。没有参数时，切换显示开关。 显示的时间单位为毫秒；超过1秒的时间间隔也以分钟:秒的格式显示，如有必要还会显示小时和天。

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

大多数控制psql行为的变量不能被取消设置；相反，\unset命令被解释为将它们设置为默认值。 请参见下面的Variables。

将当前查询缓冲区写入文件文件名或将其传输到shell命令命令。 如果当前查询缓冲区为空，则写入最近执行的查询。

如果参数以|开头，则整个剩余部分的行被视为要执行的命令， 在其中不进行变量插值或反引号扩展。其余部分的行会被直接传递给shell。

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

重复执行当前查询缓冲区（就像\g一样）直到被中断或查询失败。 在执行之间等待指定的秒数（默认为2秒）。每个查询结果都会显示一个标题， 包括\pset title字符串（如果有的话），查询开始时的时间和延迟间隔。

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

设置或切换扩展表格格式模式。因此，它等同于\pset expanded。

列出具有其关联访问权限的列表、表和序列。 如果指定了模式，则仅列出名称与模式匹配的表、视图和序列。

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