如果当前表格输出格式是非对齐，则切换为对齐；否则设置为非对齐。保留这条命令是为了向后兼容。通用的解决办法见 \pset。

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

设置作为查询结果打印的任何表的标题，或取消任何这样的标题。此命令等价于 \pset title title. (The name of this command derives from “caption”, as it was previously only used to set the caption in an HTML table.)

建立到一个新数据库和/或以另一个用户名的连接。先前的连接会被关闭。如果dbname为-，则假定使用当前的数据库名。

如果省略username，则假定使用当前的用户名。

作为一条特殊规则，不带任何参数的\connect将以默认用户连接到默认数据库（就像你启动psql时不带任何参数一样）。

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

执行前端（客户端）复制。此操作执行的是一条 SQL COPY 命令， 但不是由后端读取或写入指定的文件（后者因此需要后端访问权限和特殊的用户权限，并且受限于后端可访问的文件系统）， 而是由 psql 读取或写入该文件， 并在后端和本地文件系统之间传送数据。

该命令的语法类似于 SQL COPY 命令（细节见其描述）。注意，因此对 \copy 命令适用特殊的解析规则。特别是，变量替换规则和反斜线转义不适用。

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

Shows all columns of relation (which could be a table, view, index, or sequence), 它们的类型以及任何特殊属性（如 NOT NULL 或默认值，如果有）。如果该关系实际上是表，任何已定义的索引、主键、唯一约束和检查约束也会列出。如果该关系是视图，则还显示视图定义。

命令形式 \d+ 相同，但还会显示与表列关联的任何注释。

列出所有可用的聚合函数及其操作的数据类型。如果指定了 pattern（正则表达式）， 则只显示匹配的聚合。

显示对象（可以是一个正则表达式）的描述，如果没有给出参数则显示所有对象的描述。（对象涵盖聚合、函数、操作符、类型、关系（表、视图、索引、序列、大对象）、规则和触发器。）例如：

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

对象的描述可以用 COMMENT ON SQL 命令生成。

列出可用的函数及其参数和返回类型。 If pattern (a regular expression) is specified, only matching functions are shown. If the form \df+ is used, additional information about each function, including language and description, is shown.

这不是实际的命令名：字母 i、s、t、v、S 分别代表索引（index）、序列（sequence）、 表（table）、视图（view）和系统表（system table）。可以按任意顺序指定其中 任意个或全部，以获得它们的列表以及各自的属主。

如果指定了 pattern， 它是一个正则表达式，把列表限制为名字 匹配的对象。如果在命令名后面加上 “+”，每个对象都会连同其相关联的描述一起列出（如果有的话）。

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

列出可用的操作符及其操作数和返回类型。 如果指定了 name， 则只显示具有该名称的操作符。

这是 \z 的别名，因它更具助记性而保留（display permissions，显示权限）。

列出所有数据类型，或者只列出匹配pattern的类型。命令形式\dT+显示额外的信息。

列出所有已配置的用户或只列出匹配 pattern 的用户。

如果指定了 filename，则编辑该文件；编辑器退出后，其内容被复制回查询缓冲区。 If no argument is given, the current query buffer is copied to a temporary file which is then edited in the same fashion.

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

把参数打印到标准输出，参数之间以一个空格分隔并后跟一个换行符。这在脚本的输出中穿插信息时很有用。例如：

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

If the first argument is an unquoted -n the the trailing newline is not written.

如果使用多字节编码，则设置客户端编码。不带参数时，此命令显示当前编码。

设置非对齐查询输出的字段分隔符。默认是竖线（|）。设置输出选项的通用方法另见 \pset。

把当前查询输入缓冲区发送到后端，并可选地把输出保存到 filename 中，或把输出通过管道送到一个单独的 Unix shell 去执行 command。 A bare \g is virtually equivalent to a semicolon. A \g with argument is a “one-shot” alternative to the \o command.

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

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

从文件 filename 读取输入并执行，就像从键盘输入一样。

列出服务器中的所有数据库及其所有者。向命令名追加 + 还可以看到数据库的任何描述。 If your PostgreSQL installation was compiled with multibyte encoding support, the encoding scheme of each database is shown as well.

从数据库读取 OID 为 loid 的大对象并把它写入 filename。 注意这条命令与服务器端函数 lo_export 有微妙的差别， 后者以数据库服务器运行用户的权限在服务器的 文件系统上操作。

把该文件存储为一个 PostgreSQL 大对象。可以选择把给定的注释与该对象关联。 Example:

foo=> \lo_import '/home/peter/pictures/photo.xcf' 'a picture of me'
lo_import 152801

The response indicates that the large object received object id 152801 which one ought to remember if one wants to access the object ever again. For that reason it is recommended to always associate a human-readable comment with every object. Those can then be seen with the \lo_list command.

注意这条命令与服务器端的 lo_import 有微妙的差别，因为它以本地用户在本地文件系统上操作， 而不是服务器的用户和文件系统。

显示当前存储在数据库中的所有 PostgreSQL 大对象的列表以及为它们提供的任何注释。

从数据库删除 OID 为 loid 的大对象。

把以后的查询结果保存到文件 filename 中，或把以后的结果通过管道送到一个单独的 Unix shell 去执行 command。 If no arguments are specified, the query output will be reset to stdout.

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

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

此命令设置影响查询结果表输出的选项。 parameter 描述要设置哪个选项。 The semantics of value depend thereon.

可调整的打印选项有：

Illustrations on how these different formats look can be seen in the 示例 section.

退出 psql 程序。

此命令与 \echo 相同，只是所有输出将写入由 \o 设置的查询输出通道。

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

打印命令行历史或把它保存到 filename。如果省略 filename，则历史写到标准输出。 This option is only available if psql is configured to use the GNU history library.

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

有效的变量名可以包含字符、数字和下划线。详见有关 psql 变量的小节。

尽管欢迎你把任何变量设置为任何值，psql 把若干变量 视为特殊的。它们记录在有关变量的小节中。

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

允许你指定要放在 HTML 表输出模式的 table 标签中的选项。 This command is equivalent to \pset tableattr table_options.

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

切换扩展行格式模式。因此它等价于 \pset expanded。

产生数据库中所有表及其访问权限的列表。如果给出参数，它被当作一个正则表达式， 只列出匹配它的表。

test=> \z
Access permissions for database "test"
 Relation |           Access permissions
----------+-------------------------------------
 my_table | {"=r","joe=arwR", "group staff=ar"}
(1 row )

这样阅读：

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

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

获取有关反斜线（\）命令的帮助信息。

在读入时把所有行打印到屏幕。这对脚本处理比交互模式更有用。 This is equivalent to setting the variable ECHO to all.

切换到非对齐输出模式（默认输出模式是对齐的）。

指定 psql 执行一个查询字符串 query，然后退出。这在 shell 脚本中很有用。

query 必须是 后端完全可解析的查询字符串（即不含 psql 特有的功能），或者是单条反斜杠命令。因此 你不能混合 SQL 和 psql 元命令。要做到这一点，可以把字符串管道输入 psql，像这样： echo "\x \\ select * from foo;" | psql。

指定要连接的数据库的名称。这等效于在命令行上把 dbname 指定为第一个非选项参数。

显示发送到后端的所有查询。这等效于把变量 ECHO 设置为 queries。

回显 \d 及其他反斜线命令生成的实际查询。如果你想在自己的程序中包含类似的功能，可以使用它。这等价于在 psql 中设置变量 ECHO_HIDDEN。

用文件 filename 作为查询的来源，而不是交互式地读取查询。 文件处理完后，psql 终止。这在很多方面等价于内部 命令 \i。

如果filename是-（连字符），则会读取标准输入。

使用这个选项与写成psql < filename有细微差别。通常两种形式都会得到你期望的结果，但使用-f可以启用一些有用的特性，例如带行号的错误消息。使用这个选项也还有一点机会降低启动开销。另一方面，使用 shell 输入重定向的形式在理论上能保证得到与你手工逐行输入时完全相同的输出。

使用separator作为字段分隔符。这等效于\pset fieldsep或者\f。

指定 postmaster 所在机器的主机名。 如果 host 以斜线开头，它被用作 Unix 域套接字所在的目录。

打开 HTML 表格输出。这等效于 \pset format html 或 \H 命令。

列出所有可用的数据库，然后退出。其他非连接选项会被忽略。这类似于内部命令 \list。

把所有查询输出放到文件filename中。这等效于命令\o。

指定 postmaster 用于监听连接的 TCP/IP 端口，或者在省略时指定本地 Unix 域套接字文件扩展名。默认是 PGPORT 环境变量的值，如果没有设置，则默认为编译时指定的端口，通常是 5432。

以 \pset 的形式指定打印选项。注意，这里必须用一个等号而不是空格来分隔名称和值。例如，要把输出格式设置为 LaTeX，可以写 -P format=latex。

指定 psql 安静地工作。默认情况下，它会打印欢迎消息和各种提示信息。如果使用了这个选项，以上那些就都不会输出。这与 -c 选项配合很有用。 Within psql you can also set the QUIET variable to achieve the same effect.

把separator用作记录分隔符。这等效于\pset recordsep命令。

以单步模式运行。即每条查询发送到后端之前都会提示用户，并可选择取消执行。可用它来调试脚本。

以单行模式运行，此时换行符像分号一样 终止一条查询。

关闭列名和结果行计数页脚等的打印。它完全等效于 \t 元命令。

指定要放在HTML table标签内的选项。详见\pset。

让 psql 在连接数据库之前提示输入用户名和密码。

这个选项已废弃，因为它在概念上有缺陷。 （为非默认用户名而提示与因为后端要求 而为口令提示其实是两件 事。）建议改看 -U 和 -W 选项。

以用户 username 而不是默认用户连接到数据库。（当然，你必须有权限这样做。）

执行变量赋值，类似于 \set 内部命令。注意在命令行上必须用等号分隔名称和值。 要取消变量的设置，去掉等号即可。要把一个变量 设置为没有值，使用等号但去掉值。 这些赋值在启动的非常早期阶段完成， 因此为内部目的保留的变量可能会在 稍后被覆盖。

显示 psql 的版本。

要求 psql 在连接数据库之前提示输入密码。即使你随后用元命令 \connect.

在当前版本中，只要后端要求口令认证，psql 就会自动发出口令提示。 由于这目前基于一个技巧，自动 识别可能神秘地失败，因此提供这个选项来强制提示。 如果没有发出口令提示而后端又要求口令认证， 连接尝试将失败。

打开扩展行格式模式。这等效于 命令 \x。

不读取启动文件 ~/.psqlrc。

显示有关 psql 命令行参数的帮助。