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

建立到PostgreSQL服务器的新连接。连接参数既可以使用按位置指定的语法（数据库名、用户、主机和端口中的一个或多个），也可以使用conninfo连接字符串，详见第 32.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命令。特别是，psql的变量替换规则和反斜线转义在这里不适用。

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

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

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

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

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

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

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

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

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

以最大的详细程度重复最近的服务器错误消息，就好像VERBOSITY被设置为verbose，SHOW_CONTEXT被设置为always一样。

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

如果未指定视图，则会呈现一个空的CREATE VIEW模板供编辑。

如果指定了行号，psql会将光标定位到视图定义中的指定行。

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

将当前查询输入缓冲区发送给服务器，并且可以选择将查询输出存储到filename，或通过管道把输出传给 shell 命令command。只有查询成功返回零个或更多元组时，才会向文件或命令写入内容；如果查询失败或 SQL 命令不返回数据，则不会写入。

单独的\g基本上等同于一个分号。带有参数的\g提供了一个“一次性”替代\o命令的选择。

将当前查询输入缓冲区发送给服务器，然后把查询输出（如果有）的每一行的每一列视为要执行的 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，则取消设置对应的变量，而不是设置它。

如果查询失败或没有恰好返回一行，则不会更改任何变量。

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

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

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

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

\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。如果没有指定参数，查询输出将恢复为标准输出。

“查询结果”包括从数据库服务器获取的所有表格、命令响应和通知，以及查询数据库的各种反斜杠命令的输出（例如\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。

这个命令获取指定视图的定义，并以CREATE OR REPLACE VIEW命令的形式显示。定义会打印到由\o设置的当前查询输出通道。

如果在命令名称后添加+，那么输出行将从1开始编号。

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

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

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

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

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

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

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

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

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

进入一个单独的 shell，或执行 shell 命令command。参数不会被进一步解释；shell 会原样看到它们。特别地，变量替换规则和反斜线转义在这里不适用。

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