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

建立到PostgreSQL服务器的新连接。连接参数既可以使用按位置指定的语法（数据库名、用户、主机和端口中的一个或多个），也可以使用conninfo连接字符串，详见Section 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    -- changes only 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或默认值等特殊属性。还会显示关联的索引、约束、规则和触发器。对于外部表，还会显示关联的外部服务器。（“匹配模式”的定义见下面的Patterns。）

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

\d+形式的命令与之相同，但会显示更多信息：表各列关联的注释、表中是否存在 OID、视图定义（如果关系是视图），以及非默认的复制标识设置。

默认只显示用户创建的对象；提供模式或S修饰符可包含系统对象。

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

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

列出操作符类（见Section 37.16.1）。如果指定了access-method-pattern，则只列出关联访问方法的名称匹配该模式的操作符类。如果指定了input-type-pattern，则只列出关联输入类型的名称匹配该模式的操作符类。如果在命令名后附加+，还会列出每个操作符类关联的操作符族和拥有者。

列出操作符族（见Section 37.16.5）。如果指定了access-method-pattern，则只列出关联访问方法的名称匹配该模式的操作符族。如果指定了input-type-pattern，则只列出关联输入类型的名称匹配该模式的操作符族。如果在命令名后附加+，还会列出每个操作符族的拥有者。

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

列出与操作符族关联的支持函数（见Section 37.16.3）。如果指定了access-method-pattern，则只列出关联访问方法的名称匹配该模式的操作符族函数。如果指定了operator-family-pattern，则只列出名称匹配该模式的操作符族函数。如果在命令名后附加+，则详细显示函数，包括其实际参数列表。

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

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

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

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

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

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

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

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

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

在这组命令中，字母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，则只显示名称匹配该模式的函数。默认只显示用户创建的对象；提供模式或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 命令用于设置访问权限。权限显示的含义在 Section 5.7中有解释。

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

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

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

列出已定义的配置设置。这些设置可以专属于角色、专属于数据库，或同时专属于两者。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或 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=值格式选项子句列表。这些子句的解释方式与\pset option 值命令相同，但仅在此查询执行期间生效。在此列表中，=符号周围不允许有空格，但选项子句之间必须有空格。如果=值被省略，则指定的option会按以下命令的方式更改：\pset option，其中不显式指定值。

如果给出了filename或|command参数，查询输出就会写入指定文件，或通过管道传给指定的 shell 命令，而不是照常显示。只有当查询成功返回零个或多个元组时，才会向文件或命令写入；如果查询失败，或执行的是不返回数据的 SQL 命令，则不会写入。

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

当最后一个参数以|开头时，该行剩余的全部内容都会被视为要执行的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 变量（参见下面的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的大对象。

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

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

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

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

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

提示用户提供文本，将其赋值给变量名称。还可以指定可选的提示字符串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变量名称设置为值，如果给出多个值，则设置为所有值的串接。如果只给出一个参数，则将变量设置为空字符串值。要取消变量设置，请使用\unset命令。

\set没有任何参数时，显示当前设置的所有psql变量的名称和值。

合法的变量名可以包含字母、数字和下划线。详情见下面的Variables。变量名区分大小写。

某些变量是特殊的，它们控制psql的行为，或者由系统自动设置以反映连接状态。下面的Variables介绍了这些变量。

将环境变量名称设置为值；如果没有提供值，则取消设置该环境变量。例如：

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生成的纯文本转储，但也可能在其他场景中有用。

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

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

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

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

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

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

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

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

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

这是\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命令，将其划分为多个事务。（有关服务器如何处理多查询字符串的更多细节，请参见Section 52.2.2.1。）psql对每个请求只打印收到的最后一个查询结果；在这个示例中，虽然三条SELECT命令确实都会执行，但psql只打印3。