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

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

将 dbname、username、host 或 port 中的任何一个指定为-，都等价于省略该参数。

新连接可以重用前一个连接的连接参数；不仅包括数据库名称、用户、主机和端口，还包括其他设置，如 sslmode。默认情况下，参数在位置语法中被重用，但在给定 conninfo 字符串时不会被重用。传递 -reuse-previous=on 或 -reuse-previous=off 作为第一个参数将覆盖该默认设置。如果参数被重用，则任何未明确指定为位置参数或在 conninfo 字符串中的参数将从现有连接的参数中获取。一个例外是，如果使用位置语法更改 host 设置，使其不同于先前的值，则现有连接参数中存在的任何 hostaddr 设置将被删除。此外，仅当用户、主机和端口设置未更改时，才会重用现有连接使用的任何密码。当命令既不指定也不重用特定参数时，将使用 libpq 的默认值。

如果成功建立了新连接，则关闭先前的连接。如果连接尝试失败（用户名错误、访问被拒绝等），当 psql 处于交互模式时，会保留先前的连接。但在执行非交互式脚本时，会立即报错并停止处理。这一区别一方面使用户能够方便地应对输入错误，另一方面也作为安全机制，防止脚本意外地作用于错误的数据库。

例如：

=> \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，则只显示名称匹配该模式的访问方法。如果在命令名后附加+，还会列出每个访问方法关联的处理器函数和描述。

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

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

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

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

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

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

列出域。如果指定了 pattern，则只显示名称匹配该模式的域。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。如果在命令名后附加+，还会列出每个对象关联的权限和描述。

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

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

在这组命令中，字母 E、i、m、s、t 和 v 分别代表外部表、索引、物化视图、序列、表和视图。可以按任意顺序指定这些字母中的任意一个或全部，以获取相应类型的对象列表。例如，\dit 列出索引和表。如果在命令名后附加+，还会列出每个对象的磁盘上的物理大小以及关联的描述（如果有）。如果指定了 pattern，则只列出名称匹配该模式的对象。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。

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

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

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

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

列出函数及其结果数据类型、参数数据类型和函数类型。函数类型分为“agg”（聚合）、“normal”、“trigger”或“window”。要仅显示特定类型的函数，可在命令中添加对应的字母 a、n、t 或 w。如果指定了 pattern，则只显示名称匹配该模式的函数。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。如果使用\df+形式，还会显示每个函数的附加信息，包括易变性、并行安全性、拥有者、安全分类、访问权限、语言、源代码和描述。

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

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

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

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

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

这是\lo_list 的别名，用于显示大对象列表。

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

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

列出操作符及其操作数类型和结果类型。如果指定了 pattern，则只列出名称匹配该模式的操作符。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。如果在命令名后附加+，还会显示每个操作符的附加信息，目前只包括底层函数名。

列出排序规则。如果指定了 pattern，则只列出名称匹配该模式的排序规则。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。如果在命令名后附加+，还会列出每个排序规则关联的描述（如果有）。请注意，只会显示可用于当前数据库编码的排序规则，因此同一安装中的不同数据库可能会得到不同结果。

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

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

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

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

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

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

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

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

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

列出事件触发器。如果指定了 pattern，则只列出名称匹配该模式的事件触发器。如果在命令名后附加+，还会列出每个对象关联的描述。

如果指定了 filename，则编辑该文件；编辑器退出后，将文件内容复制到当前查询缓冲区。如果未给出 filename，则将当前查询缓冲区复制到临时文件，再以相同方式编辑。如果当前查询缓冲区为空，则将最近执行的查询复制到临时文件，并以相同方式编辑。

随后，按照 psql 的正常规则重新解析查询缓冲区的新内容，将整个缓冲区视为一行。任何完整的查询都会立即执行；也就是说，如果查询缓冲区包含分号或以分号结束，就会执行到该位置为止的所有内容。剩余内容会在查询缓冲区中等待；键入分号或\g 发送它，或键入\r 清空查询缓冲区以取消它。将缓冲区视为一行主要影响元命令：缓冲区中位于元命令之后的所有内容都会被视为该元命令的参数，即使它们跨越多行也是如此。（因此，不能用这种方式编写使用元命令的脚本。应使用\i 来处理这类脚本。）

如果指定了行号，psql 会将光标定位到文件或查询缓冲区中的指定行。请注意，如果只给出一个全由数字组成的参数，psql 会假定它是行号，而不是文件名。

将参数打印到标准输出，参数之间用一个空格分隔，末尾跟随换行符。这可用于在脚本输出中插入信息。例如：

=> \echo `date`
Tue Oct 26 21:40:57 CEST 1999

如果第一个参数是未加引号的 -n，则不输出末尾的换行符。

这个命令获取并编辑指定函数的定义，形式为 CREATE OR REPLACE FUNCTION 命令。编辑方式与\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。

将当前查询缓冲区发送给服务器执行。如果给出参数，查询输出会写入指定文件或通过管道传递给给定的 shell 命令，而不是按通常方式显示。只有查询成功返回零个或更多元组时，才会向文件或命令写入内容；如果查询失败或 SQL 命令不返回数据，则不会写入。

如果当前查询缓冲区为空，则最近发送的查询将被重新执行。除此之外，没有任何参数的\g 基本上等同于一个分号。带有参数的\g 提供了一个“一次性”替代\o 命令的选择。

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

将当前查询缓冲区发送给服务器，然后把查询输出（如果有）的每一行的每一列视为要执行的 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，但会对当前查询强制使用扩展输出模式。参见\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，则只列出名称匹配该模式的数据库。如果在命令名后附加+，还会显示数据库大小、默认表空间和描述。（大小信息只对当前用户能够连接的数据库可用。）

从数据库中读取具有 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 设置的查询输出通道。

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

打印 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 命令的形式呈现。定义将打印到当前查询输出通道，由\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。

重复执行当前查询缓冲区（如同 \g 一样），直到被中断或查询失败。两次执行之间等待指定的秒数（默认 2 秒）。每次查询结果都会带有一个头部，其中包含 \pset title 字符串（如果有）、查询开始时的时间以及延迟间隔。

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

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

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

这是\dp 的别名（“显示权限”）。

不带参数时，进入一个子 shell；子 shell 退出后，psql 恢复运行。带参数时，执行 shell 命令 command。

与大多数其他元命令不同，该行剩余的全部内容始终被视为\!的参数，其中不会进行变量插值或反引号扩展。该行剩余内容会原样传给 shell。

显示帮助信息。可选的 topic 参数（默认为 commands）选择要解释的 psql 的哪个部分：commands 描述 psql 的反斜线命令；options 描述可以传递给 psql 的命令行选项；而 variables 显示关于 psql 配置变量的帮助。