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

设置作为查询结果打印的任何表的标题，或取消任何这样的标题。此命令等价于 \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.)

建立到一个新数据库和/或以一个用户名的连接。之前的连接被关闭。 If dbname is - the current database name is assumed.

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

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

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

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

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

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

显示关系的所有列（关系可以是表、视图、索引或序列）、它们的类型以及任何特殊属性（如 NOT NULL 或默认值，如果有）。如果该关系实际上是表，任何已定义的索引也会列出。如果该关系是视图，则还显示视图定义。

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

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

显示对象（可以是一个正则表达式）的描述，如果没有给出参数则显示所有对象的描述。 (“Object” covers aggregates, functions, operators, types, relations (tables, views, indices, sequences, large objects), rules, and triggers.) For example:

=> \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 分别代表索引、序列、表、视图和系统表。你可以按任意顺序 指定其中任意个或全部，来获得它们的列表及其 所有者。

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

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

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

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

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

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

新的查询缓冲区随后按照 psql 的正常规则重新解析，即把整个缓冲区当作单行对待。 (Thus you cannot make “scripts” this way, use \i for that.) This means also that if the query ends with (or rather contains) a semicolon, it is immediately executed. In other cases it will merely wait in the query buffer.

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

=> \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 读取输入并执行，就像从键盘输入一样。

列出服务器中的所有数据库及其所有者。向命令名追加 + 还可以看到数据库的任何描述。如果你的 Postgres 安装编译时 带有多字节编码支持，则还会显示每个 数据库的编码方案。

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

把该文件存储为一个 Postgres 大对象。可以选择把给定的注释与该对象关联。 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 有细微差别，因为它以本地用户身份在本地文件系统上操作，而不是服务器的用户和文件系统。

显示当前存储在数据库中的所有 Postgres 大对象的列表及其所有者。

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

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

“Query results” 包括从数据库服务器获得的所有表、命令响应和通知，以及查询数据库的各种反斜线命令（如 \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 标签中的选项。这条命令 等价于 \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 终止。 This in many ways equivalent to the internal command \i.

使用这个选项与写 psql < filename. 有细微差别。一般来说，两者都会如你期望的那样工作，但使用 -f 会启用一些不错的特性，例如带行号的错误消息。使用这个选项还可能略微降低启动开销。另一方面，使用 shell 输入重定向的变体（理论上）保证产生与你手工输入所有内容时完全相同的输出。

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

指定 postmaster 正在运行的主机的主机名。不带此选项时，通信使用本地 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.

As of version 7.0, psql automatically issues a password prompt whenever the backend requests password authentication. Because this is currently based on a “hack”, the automatic recognition might mysteriously fail, hence this option to force a prompt. 如果没有发出密码提示而后端又要求密码认证，连接尝试将失败。

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

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

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