psql

如果当前的表输出格式是非对齐的，则切换成对齐格式。如果不是非对齐格式， 则设置成非对齐格式。保留这个命令是为了向后兼容性。更一般的方案请见 \pset。

与一台PostgreSQL服务器建立一个新连接。 可以使用位置语法指定要使用的连接参数，或者使用 第 31.1.1 节中详细介绍的conninfo连接串。

当使用位置参数时，如果dbname、 username、 host或 port中的任意一个被省略或者指定为 -，那么使用前一个连接中的该参数的值；如果没有前一个连接， 则使用该参数值的libpq默认值。当使用conninfo 字符串时，没有来自先前连接的值用于新连接。

如果新连接成功地被建立，之前的连接会被关闭。如果连接尝试失败 （错误的用户名、访问被拒绝等），只有在psql 处于交互模式的情况下才会保留之前的连接。 当执行一个非交互式脚本时处理将被立即停止， 并且报出一个错误。这种区别一方面可以帮助用户发现打字错误， 另一方面也可以作为一种安全机制防止脚本在错误的数据库上执行动作。

例子：

=> \c mydb myuser host.dom 6432
=> \c service=foo
=> \c "host=localhost port=5432 dbname=mydb connect_timeout=10 sslmode=disable"
=> \c postgresql://tom@localhost/mydb?application_name=myapp

设置作为查询结果打印的任何表的标题或者取消这样的设置。这个命令等效于 \pset title title （这个命令的名称来自于"caption"，因为它之前只被用来在 HTML表格中设置标题）。

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

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

执行一次前端(客户端)拷贝。这个是运行一个 SQL COPY命令的操作， 不过不是服务器读取或者写入指定的文件，而是由psql 读写文件并且并作为本地的文件系统和服务器之间的跳板取出或写入数据。 这意味着文件的可访问性和权限是本地用户的而非服务器上的， 并且不需要 SQL 超级用户特权。

当program被指定时，command 被psql执行并且传给command 的数据或者从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的版权以及发布条款。

对于每一个匹配pattern的关系 （表、视图、索引、序列或者外部表）或者组合类型，显示所有的列、它们的类型、 表空间（如果非默认表空间）以及任何诸如NOT NULL 或者默认值的特殊属性。相关的索引、约束、规则以及触发器也会被显示。 对于外部表，还会显示相关的外部服务器（下文的 Patterns 中定义了"匹配模式"）。

对于某些类型的关系，\d会为每一列显示额外的信息： 对于序列会显示列值，对于索引显示被索引的表达式， 对于外部表显示外部数据封装器选项。

命令形式\d+是一样的，不过会显示更多信息： 与该表的列相关的任何注释，表中是否存在 OID，如果关系是视图则显示视图定义， 非默认的复制身份设置。

默认情况下只会显示用户创建的对象，提供一个模式或者S 修饰符可以把系统对象包括在内。

列出聚合函数，以及它们的返回类型和它们所操作的数据类型。如果指定了pattern，只显示名称匹配该模式的聚合。 默认情况下只会显示用户创建的对象，提供一个模式或者S 修饰符可以把系统对象包括在内。

列出表空间。如果指定了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 修饰符可以把系统对象包括在内。

列出外部服务器（助记："外部服务器"）。如果指定了 pattern， 只列出名称匹配该模式的那些服务器。如果使用了\des+形式， 将显示每个服务器的完整描述，包括该服务器的 ACL、类型、版本、选项和描述。

列出外部表（助记："外部表"）。如果指定了 pattern， 只列出表名称或者模式名称匹配该模式的项。如果使用了\det+ 选项，一般选项和外部表描述也会被显示。

列出用户映射（助记："外部用户"）。如果指定了 pattern， 只列出用户名匹配该模式的那些映射。如果使用了\deu+ 形式，有关每个映射的额外信息也会被显示。

列出外部数据封装器（助记："外部封装器"）。 如果指定了pattern， 只列出名称匹配该模式的那些外部数据封装器。如果使用了 \dew+形式，外部数据封装器的 ACL、选项和描述也会被显示。

列出被分为"agg"（聚集）、"normal"、"trigger" 以及"window"的函数及其参数、返回类型和函数类型。要想只显示指定类型的函数， 可以在该命令上增加相应的字母a、n、t 或者w。如果指定了pattern，只显示名称匹配该模式的函数。 默认情况下只会显示用户创建的对象，提供一个模式或者S 修饰符可以把系统对象包括在内。如果使用了\df+形式， 则有关每个函数的额外信息也会被显示，包括安全分类、波动性、所有者、 语言、源代码和描述。

列出文本搜索配置。如果指定了pattern， 只显示名称匹配该模式的配置。如果使用了\dF+形式， 每种配置的完整描述也会被显示， 包括底层的文本搜索解析器和用于每一种解析器记号类型的字典列表。

列出文本搜索字典。如果指定了pattern， 只显示名称匹配该模式的字典。如果使用了\dFd+形式， 有关每一种选中的字典的额外信息也会被显示，包括底层的文本搜索模板和选项值。

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

列出文本搜索模板。如果指定了pattern， 只显示名称匹配该模式的模板。如果使用了\dFt+形式， 每一种模板有关的额外信息也会被显示，包括底层的函数名称。

列出数据库角色（因为"用户"和"组"的概念已经被统一成 "角色"，这个命令现在等价于\du）。 如果指定了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）。 如果指定了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 将把游标定位在该函数体的指定行上（注意函数体通常不是开始于文件的第一行）。

设置客户端字符集编码。如果不带参数，这个命令显示当前编码。

设置用于非对齐查询输出的域分隔符。默认值是竖线(|)。 还可以参见用于设置输出选项的一般方法\pset。

把当前查询输入缓冲区发送到服务器，并且根据选择把查询的输出存储在 filename 或者把输出用管道导向 shell 命令command。 只有该查询成功地返回零个或者更多元组时才会向文件或者命令写入， 而查询失败或者不是返回数据的 SQL 命令时则不会写入。

单独一个\g实质上等价于一个分号。带有参数的 \g是\o命令的一个 "一次性的"替换方案。

把当前查询输入缓冲区发送给服务器并且将查询的输出存储在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， 则只列出名称匹配该模式的数据库。如果向命令名称追加+， 则还会显示数据库的尺寸、默认表空间以及描述 （尺寸信息只对当前用户能连接的数据库可用）。

从数据库中读取具有OID loid的大对象并且将它写入到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。

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

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

如果不带参数，则打开/关闭显示每个 SQL 语句花费的时间（以毫秒为单位）。 如果有参数，参数是on则打开显示，否则关闭显示。

重置（删除）psql变量name。

把当前查询缓冲区输出到文件filename或者用管道导出到 shell 命令 command。

反复执行当前的查询缓冲区（就像\g那样）直到被中止或者查询失败。 两次执行之间等待指定的秒数（默认是 2 秒）。

设置或者切换扩展表格格式化模式。究其本身而言，这个命令等效于 \pset expanded。

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

这是\dp（"display privileges"）的一个别名。

跳到一个单独的 shell 或者执行 shell 命令 command。 参数不会被进一步解释，shell 将会原封不动地看到参数。特别要说明的是， 变量替换规则和反斜线转义在这里不适用。

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