psql

如果目前的表输出格式是不对齐的，则切换成对齐的。如果是对齐的，则切换成不对齐。这条命令是为了向后兼容。 参阅\pset获取一个更通用的解决方法。

把当前工作目录改变到directory。没有参数则是改变到当前用户的家目录。

把正在打印的表的标题设置为一个查询的结果或者取消这样的设置。 这条命令等效于\pset title title。这条命令的名称源于"caption"， 因为以前只是用于在一个HTML表格里面设置标题。

与一个新的数据库建立一个连接，使用/不用一个用户名。 前面的连接将关闭。如果dbname，username，host，port被省略或是-， 那么就使用上次连接里面的值。 如果之前没有链接则使用libpq的缺省值。

如果连接失败(用户名错、访问被拒绝等)， 那么当psql处于交互模式时将保留前面的连接。 如果运行的是非交互的脚本，处理会马上停止并返回一个错误。 设置这样的区别一方面是为用户使用方便考虑， 另一方面也为了保证脚本不会碰巧操作了错误的数据库的安全机制考虑。

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

这条命令的语法是模拟SQL COPY命令的。 要注意的是因此带来一些应用于\copy命令的特殊分 析规则(尤其是变量替换规则和反斜杠代换规则)将不起作用。

\copy ... from stdin | to stdout分别基于命令输入和输出进行读/写。 所有行都从发出命令的同一个源读取，直到读到了\.或者流达到EOF。 输出发送到和命令输出相同的位置。要从psql的标准输入或者输出读/写， 可以使用pstdin或pstdout。这个选项用于把和SQL脚本嵌 在一起的文件填充表很有用。

显示PostgreSQL的版权和版本信息。

对于每个匹配pattern的关系(表、视图、索引、序列)， 显示所有列、它们的类型、表空间(如果不是缺省的)和任何特 殊属性(诸如NOT NULL或缺省等，只要存在)。 唯一约束相关的索引、规则、约束、触发器也同样显示出来。 如果关系是一个视图，还显示视图的定义。 "匹配模式"在下面定义Patterns。

从\d+来的命令也是一样的，只不过显示更多信息： 任何与表的列关联的注释也都会显示， 还有就是表中出现的 OID，and the view definition if the relation is a view.

缺省时，仅显示用户创建的对象；提供一个模式或者S修饰符 来包括系统对象。

列出聚合函数，连同其返回类型机及其操作的数据类型。如果pattern已声明，只有名称匹配模式的聚集 会显示。缺省时，仅显示用户创建的对象；提供一个模式或者S 修饰符来包括对象。

列出所有可用的表空间。如果声明了pattern， 那么只显示那些匹配模式的表空间。如果在命令名上附加了+， 那么每个对象都和与之相关的权限一起列出。

列出所有字符集之间的可用转换。 如果声明了pattern， 则只列出那些匹配模式的转换。 缺省时，仅显示用户创建的对象；提供一个模式或者S 修饰符来包括对象。

如果指定pattern， 只有资源或者目标类型匹配模式的投射会列出。

显示所有匹配pattern的描述，如果没有给出参数，显示所有可视对象。 但是不管怎样，只有那些有描述内容的对象才显示出来。 By default, only user-created objects are shown; supply a pattern or the S modifier to include system objects. "对象"包括：聚集，函数，操作符， 类型，关系(表，视图，索引，序列，大对象)， 规则，触发器。例如：

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

可以用COMMENTSQL命令生成对象的描述。

列出默认访问权限设置。一个条目显示每个角色（以及模式，若适用），多这些角色来说 默认权限设置已经从内置缺省情况发生了改变。如果指定了 pattern，只有角色名或者模式名匹配 模式的条目被列出。

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

它列出域名。若声明pattern， 只有名称匹配模式的域名会显示。缺省时，仅显示用户创建的对象； 提供一个模式或者S修饰符来包括系统对象。

它列出外服务器（助记符："external servers"）。 若指定pattern，只有名称匹配 模式的服务器会列出。如果使用\des+形式，会显示每个服务器的 一个完整描述，包括服务器的ACL、类型、版本和选项。

它列出用户映射（助记符："external users"）。 若指定pattern，只有名称匹配 模式的映射会列出。如果使用\deu+形式，会显示关于映射的 额外信息。

它列出外部数据封装器（助记符："external wrappers"）。 若指定pattern，只有名称匹配 模式的外部数据封装器会列出。如果使用\dew+形式，会显示 外部数据封装器的ACL和选项。

列出函数及其参数、返回类型和函数类型，它们被分为"agg" (聚集), "normal", "trigger",或者"window"。仅显示特定类型的 函数，添加相应字母到a,n, t或者w 到命令。若指定pattern，仅显示名称匹 配模式的函数。若使用\df+格式，关于每个函数的额外信息，包括 包括易变性、语言、源码和描述，都会显示。缺省时，仅显示用户创建的对象； 提供一个模式或者S来包括系统对象。

它列出文本搜索配置。若指定pattern，只有名称匹配 模式的配置会显示。如果使用\dF+形式，会显示每个配置的完整描述， 包括底层的文本搜索解析器和每个解析器token类型的字典列表。

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

它列出文本搜索解析器。若指定pattern，只有名称匹配 模式的解析器会显示。如果使用\dFp+形式，会显示每个解析器的完整描述， 包括包括底层函数和公认的token类型。

它列出文本搜索模板。若指定pattern，只有名称匹配 模式的模板会显示。如果使用\dFt+形式，会显示关于每个模板的附加信息， 包括包括底层函数名称。

列出数据库角色。 如果声明了pattern， 那么只显示那些匹配模式的名字。这条命令实际上等于\du。 如果格式\dg+被使用，会显示关于每个角色的附加信息， 包括每个角色的注释。

在这组命令中，字母 i, s, t和v分别代表索引、序列、表和视图。 您可以按任意顺序声明任何或全部的这些字母，来获得一个这些类型的对象的清单。 例如，\dit列出索引和表。如果+附加到命令名， 若存在，每个对象会按它在磁盘上的实际大小以及其相关描述来描述。 如果声明了pattern，那么只列出匹配模式的对象。 缺省时，仅显示用户创建的对象；提供一个模式或者S修饰符来包括系统对象。

\lo_list的别名，显示一个大对象的列表。

列出所有可用模式(名字空间)。如果声明了pattern， 那么只列出匹配模式的模式名。不显示非本地的临时模式。 如果在命令名上附加了+，那 么每个对象都和与之相关的权限和注释一起列出(如果有的话)。

列出所有可用操作符，以及它们的操作数和返回的数据类型。 如果声明了pattern， 那么只显示匹配模式的操作符。 缺省时仅显示用户创建的对象；提供一个模式或者S修饰符来包含系统 对象。

一列表，视图，序列和它们相关的权限。 如果声明了pattern， 那么只列出名字匹配模式的表。

GRANT和REVOKE命令用于设置访问权限。 权限显示的意义在GRANT下有解释。

列出定义的配置设置。这些设置可以是特定角色、特定数据库或者两者都是。 role-pattern和database-pattern 通常用于选择特定角色和数据库分别列出来。如果省略，或者如果指定*， 所有的设置都会列出来，分别包括那些不是特定角色或者特定数据库的。

ALTER ROLE和ALTER DATABASE命令式用来定义 每角色和每数据库配置设置。

列出数据类型。如果声明了pattern， 那么只显示匹配模式的类型。如果+被添加到命令名称上，每个类型 按其内部名称和大小列出，以及其允许的数值（若是enum类型）。 缺省时仅显示用户创建的对象；提供一个模式或者S修饰符来包含系统 对象。

列出数据角色。如果声明了pattern， 那么只名称显示匹配模式的角色名。如果使用\du+格式， 会显示关于每个角色的附加信息，包括对每个角色的注释。

如果声明了filename， 则编辑此文件并且在编辑器退出后将其内容拷贝回查询缓冲区。 如果没有给出此参数， 则把当前查询缓冲区内容拷贝到一个临时文件然后以相同方式编辑。

然后根据一般的psql规则重新分析查询缓冲区， 这时整个缓冲区当作一个单行， 因此你无法用这个方法制作脚本(用\i)。 这还意味着如果该查询以分号结尾(或者包含分号)， 它就会马上被执行。否则它只是在查询缓冲区里等待。

该命令提取并编辑命名的函数的定义，以一个CREATE OR REPLACE FUNCTION 命令的形式。以对\e相同的方式编辑。退出编辑器后，更新命令会在 查询缓冲区等待；类型分号或者要发送它的\g ，或者用来取消的\r。

目标函数可以仅通过名称来声明，或者通过名称和参数来声明，例如foo(integer, text)。 必须给定参数类型，如果有超过一个同名的函数。

如果没有指定函数，一个空的CREATE FUNCTION模板那是用来编辑的。

向标准输出打印参数，用一个空格分隔并且最后跟着一个新行。 这个特性在显示脚本的输出时会有用。例如：

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

如果第一个参数是一个无引号的-n，那么不会写出结尾的新行。

设置客户端字符编码方式。不带参数时，这条命令显示当前的编码方式。

为不对齐的查询输出设置域分隔符。 缺省时是竖条(|)。 参阅\pset获取设置输出选项的通用方法。

把当前的查询输入缓冲区的内容发送给服务器并且把查询的输出存储到可选的filename或 者把输出重定向到一个独立的执行command的Unix shell。 单独一个\g实际上等效于一个分号。 一个带有参数的\g是"一次 性"的\o命令的代用品。

给出指定SQL命令的语法帮助。 如果没有给出command， 那么psql将列出可获得语法帮助的所有命令。 如果command是一个星号(*) ， 则显示所有SQL命令的语法帮助。

打开HTML查询输出格式。如果HTML格式已经打开， 则切换回缺省的对齐的文本格式。 这个命令是为了兼容和方便，参阅\pset获取设置其它输出选项的内容。

从文件filename中读取并把其内容当作从键盘输入的那样执行查询。

列出服务器中所有数据库的名称、所有者、字符集编码以及访问权限。 如果添加+到命令名称、数据库大小、默认表空间，并且也会显示描述。 （大小信息仅对当前用户可连接的数据库是有效的。）

从数据库里读取OID为loid的大对象并把它写到filename里。 注意这个功能与服务器函数lo_export有些微小的区别， 后者运行时带着运行数据库服务器的用户权限，而且是在服务器的文件系统上。

把文件存储为一个PostgreSQL大对象。可以带着一个该对象的注解选项。例如：

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

表明大型对象收到对象ID152801的响应，可以用来访问将来新创建的大对象。 为了可读性，建议总是把一个人类可读的评论与每一个对象联系。OIDs和注释 可以通过\lo_list来查看。

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

显示一个目前存储在该数据库里的所有PostgreSQL大对象和 它们的所有者的列表。

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

把后面的查询结果保存到文件filename里或者把后面的查询结果重定向到一个独立执行command的Unix shell。如果没有声明参数，查询输出 将被重置为标准输出。

"查询结果"包括所有表，命令响应和从数据库服务器来的提示， 同样还有各种各样查询数据库的反斜杠命令的输出(如\d)，但是没有错误信息。

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

更改指定用户的口令，缺省为当前用户。该命令将提示口令输入， 然后将加密过的口令使用ALTER ROLE之类的命令发送给服务器。 这可以保证新口令不会以明文形式出现在命令历史、服务器日志、或其他什么地方。

提示用户设置变量name。一个可选提示， text，是可以指定的。（对于多字提示， 用单引号。）

缺省时，\prompt使用终端输入和输出。然而，如果-f命令行 开关被使用，\prompt使用标准输入和标准输出。

这个命令的输出设置选项影响查询结果表。option 表明那个选项应该被设置。value的语义根据选定的 选项发生变化。对于一些选项，省略value会导致 选项toggled或者复原，正如特定选项中描述的一样。如果没有提及此类表现，那么省略 value仅会使得当前设置显示出来。

可调节的打印选项有:

可以在例子例子小节看到这些不同格式输出的示例。

退出psql程序。

这条命令等效于\echo， 区别是所有输出将写入由\o设置的输出通道。

重置(清空)查询缓冲区。

将命令行历史打印出或是存放到filename。 如果省略则输出到标准输出。这个选项只有在psql 配置成使用GNU Readline库后才生效。

设置内部变量name为value或者如果给出了多于一个值， 设置为所有这些值的连接结果。如果没有给出第二个参数， 那么只设变量不设值。要重置一个变量，使用\unset命令。

有效的变量名可以包含字符，数字和下划线。参阅下面的变量变量 获取细节。

尽管你可以设置任何变量为任意值，psql对一些变量特殊对待。 它们在关于变量的小节里面有文档。

切换输出的字段名的信息头和行记数脚注。 这条命令等效于\pset tuples_only，提供它主要为了方便。

在使用HTML输出 模式时声明放在table标记里的属性。 这条命令等效于\pset tableattr table_options。

没有参数，切换每个SQL语句需要时间的显示，以毫秒为单位。通过参数设置名称。

将当前查询缓冲区输出到文件filename或者重定向到Unix 命令command。

切换扩展行格式。等效于\pset expanded。

通过相关访问权限列出表、视图和序列。如果指定 pattern， 则仅列出名称匹配模式的表、视图和序列。

这是\dp("显示权限")的别名。

返回到一个单独的Unix shell或者 执行Unix命令command。 参数不会被进一步解释；shell将看到全部参数。

获得关于反斜杠命令的帮助信息。