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

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

设置作为查询结果打印的表的标题，或取消此类标题。该命令等价于\pset title title。（此命令的名称源自“caption”，因为它过去只用于设置HTML表的标题。）

建立到PostgreSQL服务器的新连接。如果成功建立了新连接，则关闭先前的连接。如果dbname、username、host或port中的任何一个被省略或被指定为-，将使用前一个连接中该参数的值。如果没有前一个连接，则使用libpq对该参数值的默认值。

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

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

该命令的语法与 SQL 的 COPY 命令类似。注意，正因为如此，\copy 命令适用特殊的解析规则。特别是，变量替换规则和反斜线转义在这里不适用。

\copy ... from stdin | to stdout 分别基于命令的输入和输出进行读取/写入。所有行都从发出该命令的同一输入源读取，直到读到仅包含 \. 的一行或流到达 EOF 为止。输出会发送到与命令输出相同的位置。若要读写psql的标准输入或输出，请使用 pstdin 或 pstdout。这个选项适合在 SQL 脚本文件中以内联方式填充表。

显示PostgreSQL的版权和分发条款。

对于每个匹配 pattern 的关系（表、视图、索引或序列），显示其所有列、列的类型、表空间 （如果不是默认表空间），以及任何特殊属性，例如 NOT NULL 或默认值。 Associated indexes, constraints, rules, and triggers are also shown. (“Matching the pattern” is defined below.)

命令形式\d+与之相同，只是显示的信息更多：会显示与表各列关联的任何注释、表中是否存在 OID，以及（当该关系是视图时的）视图定义。

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

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

列出表空间。如果指定了pattern，则只显示名称匹配该模式的表空间。如果在命令名后附加+，每个对象还会与它关联的权限一起列出。

列出字符集编码之间的转换。如果指定了 pattern，则只列出名称匹配该模式的转换。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。

列出类型转换。如果指定了 pattern，则只列出源类型或目标类型匹配该模式的类型转换。

显示匹配 pattern 的对象的描述，如果没有给出参数则显示所有可见对象的描述。但无论哪种情况，都只列出有描述的对象。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。“对象”涵盖聚合、函数、操作符、类型、关系（表、视图、索引、序列）、大对象、规则和触发器。例如：

=> \dd version
                     Object descriptions
   Schema   |  Name   |  Object  |        Description
------------+---------+----------+---------------------------
 pg_catalog | version | function | PostgreSQL version string
(1 row)

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

列出域。如果指定了 pattern，则只显示名称匹配该模式的域。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。

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

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

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

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

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

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

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

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

列出数据库角色。如果指定了 pattern，则只列出名称匹配该模式的角色。（此命令现在实际上等价于 \du。）如果使用 \dg+ 形式，还会显示每个角色的附加信息，包括每个角色的注释。

在这组命令中，字母i、s、t和v分别代表索引、序列、表和视图。你可以按任意顺序指定这些字母中的任意个或全部，来获得这些类型对象的列表。例如，\dit列出索引和表。如果在命令名后面追加+，每个对象还会连同它在磁盘上的物理大小以及关联的描述（如果有）一起列出。

如果指定了pattern，则只列出名称匹配该模式的对象。默认情况下只显示用户创建的对象；提供一个模式或S修饰符可以包含系统对象。

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

列出模式（命名空间）。如果指定了pattern，则只列出名称匹配该模式的模式。非本地的临时模式会被隐藏。如果在命令名后面追加+，每个对象还会连同它关联的权限和描述（如果有）一起列出。

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

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

GRANT 和 REVOKE 命令用来设置访问权限。

列出数据类型。如果指定了 pattern，则只列出名称匹配该模式的类型。如果在命令名后附加 +，每个类型都会连同其内部名称和大小一起列出，如果它是 enum 类型，还会列出其允许值。默认只显示用户创建的对象；提供模式或 S 修饰符可包含系统对象。

列出数据库角色。如果指定了 pattern，则只列出名称匹配该模式的角色。如果使用 \du+ 形式，还会显示每个角色的附加信息，包括每个角色的注释。

如果指定了filename，则编辑该文件；编辑器退出后，其内容会被复制回查询缓冲区。如果没有给出参数，则把当前查询缓冲区复制到一个临时文件中，然后以相同的方式编辑。

然后，新的查询缓冲区会按照psql的正常规则被重新解析，整个缓冲区被当作单独一行。（因此你不能用这种方式编写脚本。请使用\i。）这也意味着，如果查询以分号结尾（或者更确切地说包含分号），它会立即被执行。在其他情况下，它只会在查询缓冲区中等待。

这个命令获取并编辑指定函数的定义，形式为CREATE OR REPLACE FUNCTION命令。 编辑方式与\edit相同。 编辑器退出后，更新后的命令会在查询缓冲区中等待；键入分号或\g发送它，或用\r取消。

目标函数可以只用名称指定，也可以同时给出名称和参数，例如foo(integer, text)。如果存在多个同名函数，就必须给出参数类型。

如果未指定函数，则会呈现一个空的CREATE FUNCTION模板供编辑。

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

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

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

设置客户端字符集编码。没有参数时，此命令显示当前编码。

设置非对齐查询输出的字段分隔符。默认值是竖线（|）。另请参见 \pset，那里介绍了设置输出选项的通用方法。

把当前查询输入缓冲区发送给服务器，并可选地把查询输出存储到filename中，或者把输出通过管道送给执行command的单独 Unix shell。不带参数的\g实际上等效于分号。带参数的\g是\o命令的一种“一次性”替代。

给出指定SQL命令的语法帮助。如果未指定command， 则psql将列出所有可用语法帮助的命令。如果command是星号 （*），则显示所有SQL命令的语法帮助。

打开HTML查询输出格式。如果HTML格式已经打开，则切换回默认的对齐文本格式。此命令是为兼容性和便利性而保留的；设置其他输出选项的方法见\pset。

从文件filename中读取输入，并像在键盘上输入一样执行它。

列出服务器中所有数据库的名称、拥有者、字符集编码和访问权限。如果在命令名后附加 +，还会显示数据库大小、默认表空间和描述。（大小信息只对当前用户能够连接的数据库可用。）

从数据库中读取具有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中，或通过管道把以后的结果送给单独的 Unix shell 去执行command。如果未指定参数，查询输出将重置为标准输出。

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

将当前查询缓冲区打印到标准输出。

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

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

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

这个命令设置影响查询结果表输出的选项。parameter指定要设置哪个选项。value的含义取决于所选的选项。

可调整的打印选项有：

这些不同格式的外观示例可参见 示例 一节。

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

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

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

打印psql的命令行历史记录到filename。 如果省略filename，历史记录将被写入标准输出（如果适用，将使用分页器）。 如果psql在构建时没有使用Readline支持，则此命令不可用。

把内部变量 name 设置为 value；如果给出多个值，则设置为所有值的串接。如果没有给出第二个参数，变量只是被设置为没有值。要取消变量的设置，使用 \unset 命令。

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

尽管你可以随意将任何变量设置为任何值，但psql将其中若干变量视为特殊变量。这些变量在下面有关变量的章节中介绍。

切换输出中的列名标题和行数页脚的显示状态。这个命令等价于\pset tuples_only，提供它是为了使用方便。

指定在HTML输出格式中放在table标签内的属性。这个命令等价于\pset tableattr table_options。

不带参数时，切换以毫秒为单位显示每条 SQL 语句执行耗时的开关状态。带参数时，设置为相同的值。

把当前查询缓冲区输出到文件filename，或通过管道送给 Unix 命令command。

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

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

GRANT和 REVOKE 命令用于设置访问权限。

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

进入一个单独的 shell，或执行 shell 命令 command。参数不会被进一步解释；shell 会原样看到它们。

显示有关反斜线命令的帮助信息。