Postgresql 中文操作指南

如果当前表输出格式未对齐，则将其切换为已对齐。如果它未未对齐，则将其设置为未对齐。保留此命令是为了向后兼容。有关更通用的解决方案，请参见 \pset 。

设置针对下次查询执行的查询参数，为任何参数占位符（ $1 等）传递指定的参数。

Example:

\c 或 \connect [ -reuse-previous=_on|off ] [ dbname [ username ] [ host ] [ port ] | conninfo ]_ #

设置任何表显示为查询结果的标题，或取消此类任何标题。此命令等于 \pset title _title_ 。（此命令的名称源于“标题”，因为它之前仅用于设置 HTML 表中的标题。）

将当前的工作目录更改为 directory 。无参数时，更改为当前用户的 home 目录。

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

执行前端（客户端）复制。运行 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 元命令。与大多数其他元命令不同，该行中的其余部分始终被当作 \copy 的参数，并且在参数中既不执行变量插值也不执行反引号扩展。

显示 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 或默认值。关联的索引、约束、规则和触发器也会显示。对于外部表，相关的外围服务器也会显示。（“与模式匹配”在下面的 Patterns 中定义。）

对于某些类型的关系， \d 会为每列显示附加信息：序列的列值、索引的索引表达式以及外部表的外部数据包装程序选项。

命令形式 \d+ 相同，但显示的信息更多：将显示与表的列关联的任何注释，以及表中是否存在 OID，如果关系是视图，则显示视图定义。如果关系具有访问方法，则显示非默认 replica identity 设置和 access method 名称。

默认情况下，仅显示用户创建的对象；提供某个图案或 ` S ` 修饰符以包含系统对象。

列出聚合函数，并列出其返回类型与它们所操作的数据类型。如果指定 ` pattern `, 则仅显示名称与图案匹配的聚合。默认情况下，仅显示用户创建的对象；提供某个图案或 ` S ` 修饰符以包含系统对象。

列出访问方法。如果指定 ` pattern `, 则仅显示名称与图案匹配的访问方法。如果在命令名称后面追加 ` + `, 则每个访问方法都与它的关联处理函数和说明一起列出。

列出运算符类（参见 ` Section 38.16.1 `）。如果指定 ` access-method-pattern `, 则仅列出与名称匹配该图案的访问方法关联的运算符类。如果指定 ` input-type-pattern `, 则仅列出与名称匹配该图案的输入类型关联的运算符类。如果在命令名称后面追加 ` + `, 则每个运算符类都与它的关联运算符族和所有者一起列出。

列出运算符族（参见 ` Section 38.16.5 `）。如果指定 ` access-method-pattern `, 则仅列出与名称匹配该图案的访问方法关联的运算符族。如果指定 ` input-type-pattern `, 则仅列出与名称匹配该图案的输入类型关联的运算符族。如果在命令名称后面追加 ` + `, 则每个运算符族都与它的所有者一起列出。

列出与运算符族关联的运算符（参见 ` Section 38.16.2 `）。如果指定 ` access-method-pattern `, 则仅列出与名称匹配该图案的访问方法关联的运算符族的成员。如果指定 ` operator-family-pattern `, 则仅列出名称匹配该图案的运算符族的成员。如果在命令名称后面追加 ` + `, 则每个运算符都与它的排序运算符族（如果是排序运算符）一起列出。

列出与运算符族关联的支持函数（参见 ` Section 38.16.3 `）。如果指定 ` access-method-pattern `, 则仅列出与名称匹配该图案的访问方法关联的运算符族的函数。如果指定 ` operator-family-pattern `, 则仅列出名称匹配该图案的运算符族的函数。如果在命令名称后面追加 ` + `, 则函数连同它们的实际参数列表一起详细显示出来。

列出表空间。如果指定 ` pattern `, 则仅显示名称与图案匹配的表空间。如果在命令名称后面追加 ` + `, 则每个表空间都与它的关联选项、磁盘大小、权限和说明一起列出。

列出字符集编码之间的转换。如果指定 ` pattern `, 则仅列出名称与图案匹配的转换。默认情况下，仅显示用户创建的对象；提供某个图案或 ` S ` 修饰符以包含系统对象。如果在命令名称后面追加 ` + `, 则每个对象都连同其关联说明一起列出。

列出服务器配置参数及其值。如果指定 ` pattern `, 则仅列出名称与图案匹配的参数。如果没有 ` pattern `, 则仅列出被设置为非默认值的那些参数。（使用 ` \dconfig * ` 查看所有参数。）如果在命令名称后面追加 ` + `, 则每个参数都与它的数据类型、参数可以被设置的上下文和访问特权（如果已授予非默认访问特权）一起列出。

列出类型转换。如果指定 ` pattern `, 则仅列出源类型或目标类型与图案匹配的转换。如果在命令名称后面追加 ` + `, 则每个对象都连同其关联说明一起列出。

显示类型为 ` constraint `, ` operator class `, ` operator family `, ` rule `, 和 ` trigger ` 的对象的说明。所有其他注释都可以通过这些对象类型的各个反斜杠命令来查看。

\dd 显示匹配 pattern 的对象或者适当类型的可见对象（如果未给出任何参数）的描述。但是在任何情况下，仅列出具有描述的对象。默认情况下，仅显示用户创建的对象；提供一个模式或 S 修改器以包含系统对象。

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

列出域。如果指定 pattern ，则只显示名称与模式匹配的域。默认情况下，仅显示用户创建的对象；提供一个模式或 S 修改器以包含系统对象。如果将 + 附加到命令名称，每个对象都及其关联的权限和描述一起列出。

列出默认访问权限设置。为每个角色（如果适用，以及模式）显示一个条目，其中默认权限设置已从内置默认设置更改。如果指定 pattern ，则只列出角色名称或模式名称匹配该模式的条目。

ALTER DEFAULT PRIVILEGES 命令用于设置默认访问权限。权限显示的含义在 Section 5.7 中进行了解释。

在这一组命令中，字母 E 、 i 、 m 、 s 、 t 和 v 分别代表外键表、索引、物化视图、序列、表和视图。您可以指定这些字母的任何一个或全部，以任何顺序，以获取这些类型的对象的列表。例如， \dti 列出表格和索引。如果将 + 附加到命令名称，每个对象都及其持久状态（永久、临时或未记录）、磁盘上的物理大小和任何关联的描述一起列出。如果指定 pattern ，则只列出名称与模式匹配的对象。默认情况下，仅显示用户创建的对象；提供一个模式或 S 修改器以包含系统对象。

列出外部服务器（助记符：“外部服务器”）。如果指定 pattern ，则只列出名称与模式匹配的服务器。如果使用 \des+ 形式，则显示每个服务器的完整描述，包括服务器的访问权限、类型、版本、选项和描述。

列出外部表（助记符：“外部表”）。如果指定 pattern ，则只列出表名称或模式名称与模式匹配的条目。如果使用 \det+ 形式，还会显示一般选项和外部表描述。

列出用户映射（助记符：“外部用户”）。如果指定 pattern ，则只列出用户名与模式匹配的映射。如果使用 \deu+ 形式，还将显示每个映射的附加信息。

列出外部数据包装器（助记符：“外部包装器”）。如果指定 pattern ，则只列出名称与模式匹配的外部数据包装器。如果使用 \dew+ 形式，还将显示外部数据包装器的访问权限、选项和描述。

列出函数及其返回数据类型、参数数据类型和函数类型，这些类型分为“agg”（聚合）、“normal”（普通）、“procedure”（程序）、“trigger”（触发器）或“window”（窗口）。要仅显示特定类型的函数，请将相应的字母 a 、 n 、 p 、 t 或 w 添加到命令中。如果指定 pattern ，则只显示名称与模式匹配的函数。任何附加参数都是类型名称模式，它们与函数的第一个、第二个等参数的类型名称匹配。（匹配的函数可以有比您指定更多的参数。为防止出现这种情况，请写一个短划线 - 作为最后一个 arg_pattern 。）默认情况下，仅显示用户创建的对象；提供一个模式或 S 修改器以包含系统对象。如果使用 \df+ 形式，还将显示每个函数的附加信息，包括可变性、并行安全性、所有者、安全分类、访问权限、语言、内部名称（仅适用于 C 和内部函数）和描述。可以使用 \sf 查看特定函数的源代码。

列出文本搜索配置。如果指定了 pattern ，只显示名称与该模式匹配的配置。如果使用了 \dF+ 形式，将会显示每个配置的完整描述，包括基础文本搜索解析器和每个解析器令牌类型的字典列表。

列出文本搜索字典。如果指定了 pattern ，只显示名称与该模式匹配的字典。如果使用了 \dFd+ 形式，将会显示每个选定字典的其他信息，包括底层文本搜索模板和选项值。

列出文本搜索解析器。如果指定了 pattern ，只显示名称与该模式匹配的解析器。如果使用了 \dFp+ 形式，将会显示每个解析器的完整描述，包括底层函数和已识别令牌类型的列表。

列出文本搜索模板。如果指定了 pattern ，只显示名称与该模式匹配的模板。如果使用了 \dFt+ 形式，将会显示每个模板的其他信息，包括底层函数名称。

列出数据库角色。（由于“用户”和“组”的概念已经统一到“角色”中，因此此命令现在等同于 \du 。）默认情况下，只显示用户创建的角色；提供 S 修饰符以包括系统角色。如果指定了 pattern ，只列出名称与该模式匹配的角色。如果使用了 \dg+ 形式，将会显示每个角色的其他信息；目前这会添加每个角色的注释。

这是 \lo_list 的别名，它显示大对象列表。如果 + 附加到命令名称，每个大对象都会同其关联的权限（如果存在）一起列出。

列出过程语言。如果指定了 pattern ，只列出名称与该模式匹配的语言。默认情况下，只显示用户创建的语言；提供 S 修饰符以包括系统对象。如果 + 附加到命令名称，将会显示每个语言及其调用处理程序、验证器、访问权限，以及它是否为系统对象。

列出模式（命名空间）。如果指定了 pattern ，只列出名称与该模式匹配的模式。默认情况下，只显示用户创建的对象；提供模式或 S 修饰符以包括系统对象。如果 + 附加到命令名称，将会显示每个对象及其关联的权限和描述（如果存在）。

列出运算符及其操作数和结果类型。如果指定了 pattern ，只列出名称与该模式匹配的运算符。如果指定了一个 arg_pattern ，只列出其右操作数的类型名称与该模式匹配的前缀运算符。如果指定了两个 arg_pattern_s are specified, only binary operators whose argument type names match those patterns are listed. (Alternatively, write _- ，则用于一元运算符的未使用操作数。）默认情况下，只显示用户创建的对象；提供模式或 S 修饰符以包括系统对象。如果 + 附加到命令名称，将会显示每个运算符的其他信息，目前只显示底层函数的名称。

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

列出带有关联访问权限的表、视图和序列。如果指定了 pattern ，则仅列出名称与该模式匹配的表、视图和序列。默认情况下，仅显示用户创建的对象；提供一个模式或 S 修饰符来包含系统对象。

GRANT 和 REVOKE 命令用于设置访问权限。权限显示的含义在 Section 5.7 中进行了说明。

列出分区关系。如果指定了 pattern ，则仅列出名称与该模式匹配的条目。修饰符 t （表明）和 i （索引）可以追加到该命令，以筛选要列出的关系的种类。默认情况下，列出的内容是分区表和索引。

如果使用了修饰符 n （“嵌套”）或指定了一个模式，则会包含非根分区关系，并且会显示一栏内容，该内容显示每个分区关系的父级。

如果将 + 追加到命令名称，则也会显示每个关系的分区的总大小，以及该关系的说明。如果将 n 与 + 结合使用，则会显示两个大小：一个包括直接附加的叶分区总大小，另一个显示所有分区的总大小，包括间接附加的子分区。

列出已定义的配置设置。这些设置可以针对角色、数据库或两者进行设置。 role-pattern 和 database-pattern 用于分别选择要列出的特定角色和数据库。如果省略这些内容，或者指定了 * ，则会列出所有设置，包括分别不针对角色或数据库的设置。

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

列出有关每个已授予的角色成员资格的信息，包括已分配的选项 ( ADMIN 、 INHERIT 和/或 SET ) 和授予者。有关角色成员资格的信息，请参阅 GRANT 命令。

默认情况下，仅显示针对用户创建的角色授予的权限；提供 S 修饰符来包含系统角色。如果指定了 pattern ，则仅列出名称与该模式匹配的角色授予的权限。

列出复制发布。如果指定了 pattern ，则仅列出名称与该模式匹配的发布。如果将 + 追加到命令名称，则还会显示与每个发布关联的表和架构。

列出复制订阅。如果指定了 pattern ，则仅列出名称与该模式匹配的订阅。如果将 + 追加到命令名称，则还会显示订阅的其他属性。

列出数据类型。如果指定了 pattern ，则仅列出名称与该模式匹配的类型。如果将 + 追加到命令名称，则每个类型将随其内部名称和大小、（如果该类型是 enum 类型）其允许值以及其关联的权限一同列出。默认情况下，仅显示用户创建的对象；提供一个模式或 S 修饰符来包含系统对象。

列出数据库角色。 （由于“用户”和“组”的概念已统一为“角色”，此命令现在等同于 \dg 。）默认情况下，仅显示用户创建的角色；提供 S 修饰符以包含系统角色。如果指定了 pattern ，则仅列出名称与该模式匹配的角色。如果使用表单 \du+ ，则会显示有关每个角色的其他信息；目前，这会为每个角色添加注释。

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

列出扩展的统计信息。如果指定了 pattern ，则仅列出名称与该模式匹配的扩展的统计信息。

每种类型的扩展统计信息的状态都在以其统计信息类型（例如 Ndistinct）命名的列中显示。 defined 表示在创建统计信息时请求了它，而NULL表示没有请求它。如果你想知道 ANALYZE 是否已运行并且计划程序可以使用统计信息，则可以使用 pg_stats_ext 。

列出事件触发器。如果指定了 pattern ，则仅列出名称与该模式匹配的事件触发器。如果将 + 附加到命令名称中，则列出每个对象及其关联的描述。

如果指定了 filename ，则编辑该文件；在编辑器退出后，文件内容将复制到当前查询缓冲区。如果没有给定 filename ，则当前查询缓冲区将被复制到一个临时文件中，然后使用相同的方式进行编辑。或者，如果当前查询缓冲区为空，则最近执行的查询将被复制到一个临时文件中并使用相同的方式进行编辑。

如果你编辑文件或上一个查询，并且在未修改文件的情况下退出编辑器，则查询缓冲区将被清除。否则，根据psql的正常规则重新解析查询缓冲区的新内容，将整个缓冲区视为单行。任何完整查询都会立即执行；也就是说，如果查询缓冲区包含分号或以分号结尾，则到此为止的所有内容都将被执行并从查询缓冲区中删除。查询缓冲区中剩下的任何内容都将重新显示。键入分号或 \g 以发送它，或 \r 以通过清除查询缓冲区来取消它。

将缓冲区视为单行主要影响元命令：元命令后面的缓冲区中的任何内容都将作为元命令的参数，即使它跨越多行。（因此，你无法以这种方式创建使用元命令的脚本。为此，请使用 \i 。）

如果指定了行号，psql将在文件或查询缓冲区的指定行上定位光标。请注意，如果给出了一个全数字的单一参数，psql会假定它是一个行号，而不是一个文件名。

将已评估的参数打印到标准输出，用空格分隔，并后跟换行符。这对于将信息穿插到脚本的输出中可能很有用。例如：

\ef [ _function_description [ line_number ] ]_ #

\encoding [ _encoding ]_ #

\errverbose #

\ev [ _view_name [ line_number ] ]_ #

\f [ _string ]_ #

\g [ (_option = value […​]) ] \g [ (_option = value […​]) ] [ | command_ ]_ #

\gdesc #

\getenv _psql_var env_var_ #

将当前查询缓冲区发送至服务器，然后将查询输出（如果存在）的每一行的每一列视为要执行的 SQL 语句。例如，为 my_table 的每一列创建索引：

\gset [ _prefix ]_ #

\gx [ (_option = value […​]) ] \gx [ (_option = value […​]) ] [ | command_ ]_ #

\h 或 \help [ _command ]_ #

\H or \html #

\i 或 \include filename #

\if expression\elif expression\else_\endif_ #

\ir 命令类似于 \i ，但以不同的方式解析相对文件名。在交互模式下执行时，这两个命令的行为完全相同。但是，当从脚本中调用时， \ir 把文件名解释为其所在目录的相对文件名，而不是当前工作目录的相对文件名。

列出服务器中的数据库，并显示其名称、所有者、字符集编码和访问权限。如果指定了 pattern ，则只列出名称与该模式匹配的数据库。如果在命令名称后面附加 + ，还将显示数据库大小、默认表空间和描述信息。（只有当前用户可以连接的数据库才提供大小信息。）

从数据库中读取具有 OID loid 的大型对象，并将其写入 filename 。请注意，这与服务器函数 lo_export 有细微差别，后者由数据库服务器运行的用户以其权限在服务器文件系统上运行。

将文件存储到 PostgreSQL 大型对象中。它还可以选择与对象关联给定的注释。示例：

\lo_list[+] #

\lo_unlink _loid_ #

\o 或 \out [role="_filename"]_ \o_ 或 \out [ |_command_ ]_ #

\p or \print #

\password [ _username ]_ #

\prompt [ _text ] name_ #

\pset [ _option [ value ] ]_ #

\q or \quit #

\qecho _text [ …​ ]_ #

\r or \reset #

\s [ _filename ]_ #

\set [ _name [ value [ …​ ] ] ]_ #

\setenv _name [ value ]_ #

此命令以 CREATE OR REPLACE FUNCTION 或 CREATE OR REPLACE PROCEDURE 命令的形式获取并显示命名函数或过程的定义。将定义打印到当前查询输出通道，由 \o 设置。

目标函数可以用单独名称或者名称和参数指定，例如 foo(integer, text) 。如果同名函数有多个，则必须给定参数类型。

如果将 + 附加到命令名称，则输出行将被编号，函数体的第一行为第 1 行。

与大多数其他元命令不同，该行的整个其余部分始终被视为 \sf 的参数，并且变量插值和反引号展开不在参数中执行。

此命令获取并显示命名视图的定义，采用 CREATE OR REPLACE VIEW 命令的形式。将定义打印到当前查询输出通道，由 \o 设置。

如果将 + 附加到命令名称，则输出行将从 1 开始编号。

与大多数其他元命令不同，该行的整个其余部分始终被视为 \sv 的参数，并且变量插值和反引号展开不在参数中执行。

切换显示输出列名标题和行计数页脚。此命令相当于 \pset tuples_only ，并为方便起见提供。

指定要放入 HTML 输出格式中 table 标记内的属性。此命令相当于 \pset tableattr _table_options_ 。

使用参数，启用或禁用显示每条 SQL 语句执行时间的功能。如果没有参数，则在启用和禁用之间切换显示。显示以毫秒为单位；超过 1 秒的时间间隔也将以分钟：秒格式显示，并在需要时添加小时和天字段。

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

控制 psql 行为的大多数变量不能取消设置；而 \unset 命令解释为设置这些变量为其默认值。请参见下面的 Variables 。

将当前查询缓冲区写入文件 filename 或将其管道到 shell 命令 command 。如果当前查询缓冲区为空，则会写入最近执行的查询。

如果参数以 | 开头，则将整个行的其余部分都作为 command 来执行，并且不会在其中执行变量内插或反引号扩展。行的其余部分将直接传给 shell。

此命令与 \echo 相同，但输出将写入 psql 的标准错误通道，而不是标准输出。

重复执行当前查询缓冲区（如 \g 所做），直到中断或查询失败，或者达到执行计数限制（如果给出）。在执行之间等待指定秒数（默认 2）。向后兼容，可以随或不随 interval= 前缀指定 seconds 。每个查询结果都显示在包含 \pset title 字符串（如果任何）、查询开始时间和延迟时间间隔的页眉中。

如果当前查询缓冲区为空，则会重新执行最近发送的查询。

设置或切换展开表格格式化模式。因此它等效于 \pset expanded 。

列出表、视图和序列及其关联的访问权限。如果指定 pattern ，则仅列出名称匹配模式的表、视图和序列。默认情况下，仅显示用户创建的对象；提供模式或 S 修饰符以包括系统对象。

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

无参数时，转义到子 shell；当子 shell 退出时，psql 恢复。带参数时，执行 shell 命令 command 。

与大多数其他元命令不同的是，该行始终的完整其余部分被认为是 \! 的参数，并且在参数中不执行变量插值或反引号扩展。该行的其余部分只是按字面意思传递给 shell。

显示帮助信息。可选的 topic 参数（默认 commands ）选择对 psql 的哪一部分进行解释： commands 描述 psql 的反斜杠命令； options 描述可传递给 psql 的命令行选项； variables 显示有关 psql 配置变量的帮助。

反斜杠分号不是像前面命令那样的元命令；它只是导致在不进一步处理的情况下向查询缓冲区添加分号。

通常，psql 会在达到命令结束分号后立即将 SQL 命令调度到服务器，即使当前行上仍有更多输入。因此，例如，输入

value 必须是一个数字。通常，数字越大，表格具有的边框和行就越多，但具体细节取决于特定格式。在 HTML 格式中，此设置将直接转换为 border=…​ 属性。在大多其他格式中，只有值 0（无边框）、1（内部分割线）和 2（表格框架）才有意义，而且高于2的值的处理方式与 border = 2 相同。此外， latex 和 latex-longtable 格式允许使用值3在数据行之间添加分割线。

为 wrapped 格式设置目标宽度，以及用于确定输出是否足够宽以需要分页或在扩展自动模式下切换到垂直显示的宽度限制。零（默认值）导致目标宽度受环境变量 COLUMNS 或 COLUMNS （如果未设置）下检测到的屏幕宽度控制。此外，如果 columns 为零，则 wrapped 格式仅影响屏幕输出。如果 columns 为非零，则文件和管道输出也会折行至该宽度。

指定在 CSV 输出格式中要使用的字段分隔符。如果分隔符出现在字段的值中，该字段将根据标准 CSV 规则使用双引号输出。默认值是逗号。

如果指定了 value ，则它必须是 on 或 off （这将启用或禁用扩展模式），或 auto 。如果 value 被省略，该命令可在启用和禁用设置之间切换。在启用扩展模式时，查询结果以两列的形式显示，列名在左侧，数据在右侧。如果数据无法在标准“水平”模式下容纳在屏幕中，则此模式非常有用。在“自动”设置中，每当查询结果中有多个列且结果比屏幕宽时，都会使用扩展模式；否则，使用常规模式。“自动”设置仅在对齐的和折行的格式中有效。在其他格式中，它始终表现得如同扩展模式已关闭一般。

指定在未对齐的输出格式中要使用的字段分隔符。通过这种方式，可以创建比如制表符分隔的输出，其他程序可能更喜欢这种输出。若要将制表符设为字段分隔符，请键入 \pset fieldsep '\t' 。默认字段分隔符是 '|' （垂直线）。

将要用于未对齐的输出格式中的字段分隔符设置为零字节。

如果指定 value ，则它必须是 on 或 off ，这将启用或禁用表格页脚的显示（ (_n 行）计数）。如果省略 value ，该命令将打开或关闭页脚显示。

将输出格式设置为 aligned 、 asciidoc 、 csv 、 html 、 latex 、 latex-longtable 、 troff-ms 、 unaligned 或 wrapped 中的一个。允许有唯一的缩写。

aligned 格式是标准、人类可读、格式良好的纯文本输出；这是默认值。

unaligned 格式将一行上的所有列写入一行，并用当前活动的字段分隔符分隔。这对于创建可能被其他程序读入的输出很有用，例如制表符分隔或逗号分隔格式。但是，如果字段分隔符字符出现在列值中，则不会特殊处理；因此，CSV 格式可能更适合此类用途。

csv 格式用逗号分隔列值，应用 RFC 4180 中描述的引用规则。此输出与服务器 COPY 命令的 CSV 格式兼容。除非 tuples_only 参数为 on ，否则将生成带有列名的标题行。不打印标题和页脚。每一行都以系统相关的行尾字符终止，通常是类 Unix 系统的新行 ( \n ) 或 Microsoft Windows 的回车和新行序列 ( \r\n )。可以使用 \pset csv_fieldsep 选择逗号以外的字段分隔符字符。

wrapped 格式类似于 aligned ，但将宽数据值跨行换行，使输出适合目标列宽。目标宽度是按照 columns 选项下方所述确定的。请注意，psql 不会尝试换行列标题标题；因此，如果列标题所需的总宽度超出目标，则 wrapped 格式的行为与 aligned 相同。

asciidoc 、 html 、 latex 、 latex-longtable 和 troff-ms 格式输出的表格旨在使用各自的标记语言包含在文档中。它们不是完整的文件！这在 HTML 中可能不是必需的，但在 LaTeX 中你必须有一个完整的文档包装器。 latex 格式使用 LaTeX 的 tabular 环境。 latex-longtable 格式需要 LaTeX longtable 和 booktabs 包。

将边框线条绘制样式设置为 ascii 、 old-ascii 或 unicode 中的一个。允许有唯一的缩写。（这意味着一个字母就足够了。）默认设置是 ascii 。此选项仅影响 aligned 和 wrapped 输出格式。

ascii 样式使用纯 ASCII 字符。数据中的换行使用右边缘的 + 符号显示。当 wrapped 格式在没有换行字符的情况下将数据从一行换行到下一行时，第一行的右边缘会显示一个点 ( . )，并在下一行的左边缘再次显示。

old-ascii 样式使用纯 ASCII 字符，使用 PostgreSQL 8.4 及更早版本中使用的格式样式。数据中的换行使用 : 符号替换左边缘的列分隔符显示。当数据在没有换行字符的情况下从一行换行到下一行时，将使用 ; 符号替换左边缘的列分隔符。

unicode 样式使用 Unicode 框图字符。数据中的换行使用右边缘的回车符号显示。当数据在没有换行字符的情况下从一行换行到下一行时，第一行的右边缘会显示一个省略号符号，并在下一行的左边缘再次显示。

当 border 设置大于 0 时， linestyle 选项还确定用于绘制边框线的字符。纯 ASCII 字符可在任何地方使用，但 Unicode 字符在识别它们的显示器上看起来更美观。

设置要打印为 null 值的字符串。默认情况下什么都不打印，很容易与空字符串弄混。例如，人们可能更喜欢 \pset null '(null)' 。

如果指定 value ，则它必须是 on 或 off ，这将启用或禁用显示特定于区域设置的字符，以将数字组分隔在小数点左侧。如果省略 value ，该命令将在常规和特定于区域设置的数字输出之间切换。

控制查询和 psql 帮助输出的分页程序的使用。当 pager 选项为 off 时，不使用分页程序。当 pager 选项为 on 时，在适当的时候使用分页程序，即当输出到终端并且不适合屏幕时。 pager 选项也可以设置为 always ，这将导致对所有终端输出使用分页程序，无论它是否适合屏幕。没有 value 的 \pset pager 切换分页程序的使用状态。

如果设置了环境变量 PSQL_PAGER 或 PAGER ，则要分页的输出将通过管道传输到指定的程序。否则，将使用与平台相关的默认程序（例如 more ）。

在使用 \watch 命令重复执行查询时，环境变量 PSQL_WATCH_PAGER 将用于在 Unix 系统上查找分页程序。此配置是单独进行的，因为它可能会混淆传统分页程序，但可用于将输出发送到了解 psql 输出格式的工具（例如 pspg --stream ）。

如果 pager_min_lines 设置为大于页面高度的数字，那么在至少有这么多行要显示的输出时才调用分页程序。默认设置为 0。

指定在未对齐的输出格式中要使用的记录（行）分隔符。默认值是新行字符。

将记录分隔符设置成在未对齐输出格式中使用一个零字节。

在 HTML 格式中，这指定被放置在 table 标记内的属性。例如这可能是 cellpadding 或 bgcolor 。请注意，您可能不想在这里指定 border ，因为 \pset border 已经负责了这一点。如果没有提供 value ，则表属性处于未设置状态。

在 latex-longtable 格式中，它控制包含左对齐数据类型的每个列的按比例分配宽度。它指定为用空格分隔的值列表，例如 '0.2 0.2 0.6' 。未指定的输出列使用最后指定的值。

设置随后打印的表的标题。可以用来赋予输出描述性标记。如果没有提供 value ，则标题处于未设置状态。

如果指定了 value ，则它必须是 on 或 off ，这将启用或禁用仅元组模式。如果 value 忽略了此命令，则在普通和仅元组输出之间切换。普通输出包括列头、标题和各个页脚等额外信息。在仅元组模式下，只显示实际的表数据。

将 unicode 线性样式的边框绘制样式设置为 single 或 double 之一。

将 unicode 样式的列绘制样式设置为 single 或 double 之一。

将 unicode 样式的标头绘制样式设置为 single 或 double 之一。

将扩展输出中标头的最大宽度设置为 full （默认值）、 column 、 page 或 integer value 之一。

full ：扩展标头不会被截断，并且和最宽的输出行一样宽。

column ：将标头行截断到第一列的宽度。

page ：将标头行截断到终端宽度。

integer value ：指定标头行的确切最大宽度。

当 on （默认值）时，每个 SQL 命令在成功完成时都会自动提交。要在这种模式下推迟提交，你必须输入 BEGIN 或 START TRANSACTION SQL 命令。当 off 或未设置时，直到你明确发出 COMMIT 或 END ，SQL 命令才会提交。autocommit-off 模式的工作原理是为你发出一个隐含的 BEGIN ，在任何尚未进入事务块且本身不是 BEGIN 或其他事务控制命令的命令之前，或者不能在事务块中执行的命令（例如 VACUUM ）。

确定在完成 SQL 关键字时要使用哪种字母大小写。如果设置为 lower 或 upper ，则完成的单词将分别是小写或大写。如果设置为 preserve-lower 或 preserve-upper （默认值），则完成的单词将与已经输入单词的大小写一致，但未输入任何内容就完成的单词将分别是小写或大写。

你当前连接到的数据库的名称。每次你连接到数据库（包括程序启动）时都会设置此名称，但可以更改或取消设置。

如果设置为 all ，则所有非空输入行在读取时都会打印到标准输出。（这并不适用于交互式读取的行。）要在程序启动时选择此行为，请使用开关 -a 。如果设置为 queries ，psql 在将每个查询发送到服务器时将其打印到标准输出。选择此行为的开关是 -e 。如果设置为 errors ，则只会将失败的查询显示在标准错误输出上。此行为的开关是 -b 。如果设置为 none （默认值），则不显示任何查询。

当此变量设置为 on 并且 backslash 命令查询数据库时，该查询将首先显示。此功能可帮助你研究 PostgreSQL 内部并为你自己的程序提供类似的功能。（要在程序启动时选择此行为，请使用 -E 开关。）如果你将此变量设置为 noexec ，则查询将仅显示但不实际发送到服务器并执行。默认值是 off 。

当前客户端字符集编码。每次你连接到数据库（包括程序启动）时以及你使用 \encoding 更改编码时都会设置此变量，但可以更改或取消设置。

如果上一个 SQL 查询失败，则为 true ，如果成功，则为 false 。另请参见 SQLSTATE 。

如果此变量设置为大于零的整数， SELECT 查询的结果将按该数目的行分组获取和显示，而不是在显示之前收集整个结果集的默认行为。因此，无论结果集的大小如何，使用的内存量都非常有限。启用此功能时通常使用 100 到 1000 的设置。请记住，在使用此功能时，查询可能在显示了部分行后发生故障。

如果此变量设置为 true ，则不显示表的访问方法详细信息。这主要用于回归测试。

如果此变量设置为 true ，则不显示列压缩方法详细信息。这主要用于回归测试。

如果此变量设置为 ignorespace ，则不会将以空格开头的行输入到历史记录列表中。如果设置为 ignoredups ，则不会输入与之前的历史记录行匹配的行。 ignoreboth 的值合并了这两个选项。如果设置为 none （默认值），则以交互模式读取的所有行都保存在历史记录列表中。

将用于存储历史记录列表的文件名。如果未设置，则文件名取自 PSQL_HISTORY 环境变量。如果也未设置，则默认值为 ~/.psql_history ，或 Windows 上的 %APPDATA%\postgresql\psql_history 。例如，放入：

HISTSIZE #

HOST #

IGNOREEOF #

LASTOID #

LAST_ERROR_MESSAGE__LAST_ERROR_SQLSTATE #

ON_ERROR_ROLLBACK #

ON_ERROR_STOP #

PORT #

PROMPT1_PROMPT2_PROMPT3 #

QUIET #

ROW_COUNT #

SERVER_VERSION_NAME__SERVER_VERSION_NUM #

SHELL_ERROR #

SHELL_EXIT_CODE #

SHOW_ALL_RESULTS #

SHOW_CONTEXT #

SINGLELINE #

SINGLESTEP #

SQLSTATE #

USER #

VERBOSITY #

VERSION_VERSION_NAME_VERSION_NUM #