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

建立到PostgreSQL服务器的新连接。连接参数既可以使用按位置指定的语法，也可以使用中详述的conninfo第 31.1 节连接串。

当命令省略数据库名、用户、主机或端口时，新连接可以复用前一个连接的值。默认情况下，除了在处理conninfo串时，其余情况都会复用前一个连接的值。传递 -reuse-previous=on或 -reuse-previous=off作为第一个参数可以覆盖该默认设置。当命令既不指定也不复用特定参数时，将使用 libpq的默认值。将 dbname、username、host和port中的任何一个指定为-，都等价于省略该参数。

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

例如：

=> \c mydb myuser host.dom 6432
=> \c service=foo
=> \c "host=localhost port=5432 dbname=mydb connect_timeout=10 sslmode=disable"

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

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

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

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

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

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

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

对于每个匹配pattern的关系（表、视图、物化视图、索引、序列或外部表）或复合类型，显示所有列及其类型、表空间（如果不是默认表空间），以及NOT NULL或默认值等特殊属性。还会显示关联的索引、约束、规则和触发器。对于外部表，还会显示关联的外部服务器。（“匹配模式”的定义见下面的模式。）

\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，则只列出角色名或模式名匹配该模式的条目。

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

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

在这组命令中，字母 E、i、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+形式，还会显示每个模板的附加信息，包括底层函数名。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

随后，按照psql的正常规则重新解析新的查询缓冲区，其中整个缓冲区被视为一行。（因此，不能用这种方式编写脚本。应使用\i来处理这类脚本。）这意味着，如果查询以分号结束（或包含分号），它会立即执行；否则它只会在查询缓冲区中等待；键入分号或\g发送它，或键入\r取消。

如果指定了行号，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会将光标定位到函数体中的指定行。（请注意，函数体通常并不从文件的第一行开始。）

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

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

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

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

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

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

如果filename是-（连字符），则从标准输入读取，直到遇到 EOF 指示或\q元命令。这可用于将交互式输入与文件输入交错使用。请注意，只有在最外层启用了 Readline，此处才会使用 Readline 功能。

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

从数据库中读取具有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。如果没有指定参数，查询输出将恢复为标准输出。

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

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

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

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

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

这个命令设置影响查询结果表输出的选项。option指定要设置哪个选项。value的含义取决于所选的选项。对于某些选项，省略value会切换或取消设置该选项，具体见各选项的说明。如果没有提及这类行为，那么省略value只会显示当前设置。

Adjustable printing options are:

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

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

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

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

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

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

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

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

这个命令获取并显示指定函数的定义，以CREATE OR REPLACE FUNCTION命令的形式呈现。定义将打印到当前查询输出通道，由\o设置。

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

如果在命令名后附加+，则会为输出行编号，函数体的第一行编号为 1。

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

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

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

将当前查询缓冲区输出到文件filename，或通过管道传递给 shell 命令command。

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

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

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

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

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