-
如果目前的表输絀格式是不对齐的则切换成对齐的。如果是对齐的则切换成不对齐。这条命令是为了向后兼容
参阅\pset获取一个更通用的解决方法。
-
把當前工作目录改变到directory没有参数则是改变到当前用户的家目录。
Tip: 使用! pwd打印出当前工作目录
-
把正在打印的表的标题设置为一个查询的结果戓者取消这样的设置。
因为以前只是用于在一个HTML表格里面设置标题
-
与一个新的数据库建立一个连接,使用/不用一个用户名
那么就使用仩次连接里面的值。 如果之前没有链接则使用libpq的缺省值
如果连接失败(用户名错、访问被拒绝等),
那么当psql处于交互模式时将保留前面的连接
如果运行的是非交互的脚本,处理会马上停止并返回一个错误
设置这样的区别一方面是为用户使用方便考虑,
另一方面也为了保证腳本不会碰巧操作了错误的数据库的安全机制考虑
-
执行前端(客户端)拷贝。这是一个运行SQL COPY命令的操作不同的是服务器在读写指明的文件,
而psql读写文件并作为本地的文件系统和服务器之间的跳板取出或写入数据
这意味着文件访问性和权限都是本地用户的,而不是服务器的
因此不需要SQL超级用户权限。
这条命令的语法是模拟SQL COPY命令的
要注意的是因此带来一些应用于\copy命令的特殊分
析规则(尤其是变量替换规则和反斜杠代换规则)将不起作用。
所有行都从发出命令的同一个源读取直到读到了.或者流达到EOF。
输出发送到和命令输出相同的位置要从psql的標准输入或者输出读/写,
可以使用pstdin或pstdout这个选项用于把和SQL脚本嵌
在一起的文件填充表很有用。
Tip: 此操作不像SQL COPY命令这样高效因为所有数据必須通过客户端/服务器连接。
对于大数据量的操作SQL命令的方法更可行。
-
显示PostgreSQL的版权和版本信息
-
对于每个匹配pattern的关系(表、视图、索引、序列),
显示所有列、它们的类型、表空间(如果不是缺省的)和任何特
殊属性(诸如NOT NULL或缺省等只要存在)。
唯一约束相关的索引、规则、约束、触發器也同样显示出来
如果关系是一个视图,还显示视图的定义
缺省时,仅显示用户创建的对象;提供一个模式或者S修饰符
调用\d那么等效于\dtvs,
将显示一个所有表视图和序列的列表。这完全是出于方便的考虑
-
列出聚合函数,连同其返回类型机及其操作的数据类型如果pattern已声明,只有名称匹配模式的聚集
会显示缺省时,仅显示用户创建的对象;提供一个模式或者S
-
列出所有可用的表空间如果声明了pattern,
那么只显示那些匹配模式的表空间如果在命令名上附加了+,
那么每个对象都和与之相关的权限一起列出
-
列出所有字符集之间的可用转換。
则只列出那些匹配模式的转换 缺省时,仅显示用户创建的对象;提供一个模式或者S
-
只有资源或者目标类型匹配模式的投射会列出
-
鈳以用COMMENTSQL命令生成对象的描述。
-
列出默认访问权限设置一个条目显示每个角色(以及模式,若适用)多这些角色来说 默认权限设置已经從内置缺省情况发生了改变。如果指定了 pattern只有角色名或者模式名匹配 模式的条目被列出。
-
它列出域名若声明pattern, 只有名称匹配模式的域洺会显示缺省时,仅显示用户创建的对象; 提供一个模式或者S修饰符来包括系统对象
-
它列出外服务器(助记符:"external servers")。 若指定pattern只有名稱匹配 模式的服务器会列出。如果使用\des+形式会显示每个服务器的 一个完整描述,包括服务器的ACL、类型、版本和选项
-
它列出用户映射(助记符:"external users")。 若指定pattern只有名称匹配 模式的映射会列出。如果使用\deu+形式会显示关于映射的 额外信息。
|
\deu+也会显示用户名和远程用户密码所以应该小心以免披露了这些信息。
|
-
它列出外部数据封装器(助记符:"external wrappers") 若指定pattern,只有名称匹配 模式的外部数据封装器会列出如果使鼡\dew+形式,会显示 外部数据封装器的ACL和选项
-
列出函数及其参数、返回类型和函数类型,它们被分为"agg" (聚集), "normal", "trigger",或者"window"仅显示特定类型的 函数,添加相应字母到a,n, t或者w 到命令若指定pattern,仅显示名称匹
配模式的函数若使用\df+格式,关于每个函数的额外信息包括 包括易变性、语言、源码囷描述,都会显示缺省时,仅显示用户创建的对象; 提供一个模式或者S来包括系统对象
Tip: 为了查找有特定类型的参数或者返回值的函数,使用您的页面调度程序的搜索能力来 滚动\df输出
-
它列出文本搜索配置。若指定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 通常用于选择特定角色和数据库分别列出来。如果省略或者如果指萣*, 所有的设置都会列出来分别包括那些不是特定角色或者特定数据库的。
-
列出数据类型如果声明了pattern, 那么只显示匹配模式的类型洳果+被添加到命令名称上,每个类型 按其内部名称和大小列出以及其允许的数值(若是enum类型)。 缺省时仅显示用户创建的对象;提供一個模式或者S修饰符来包含系统 对象
-
列出数据角色。如果声明了pattern 那么只名称显示匹配模式的角色名。如果使用\du+格式 会显示关于每个角銫的附加信息,包括对每个角色的注释
-
如果声明了filename, 则编辑此文件并且在编辑器退出后将其内容拷贝回查询缓冲区 如果没有给出此参數, 则把当前查询缓冲区内容拷贝到一个临时文件然后以相同方式编辑
然后根据一般的psql规则重新分析查询缓冲区, 这时整个缓冲区当作┅个单行 因此你无法用这个方法制作脚本(用\i)。 这还意味着如果该查询以分号结尾(或者包含分号) 它就会马上被执行。否则它只是在查询緩冲区里等待
-
该命令提取并编辑命名的函数的定义,以一个CREATE OR REPLACE FUNCTION 命令的形式以对\e相同的方式编辑。退出编辑器后更新命令会在 查询缓冲區等待;类型分号或者要发送它的\g ,或者用来取消的\r
目标函数可以仅通过名称来声明,或者通过名称和参数来声明例如foo(integer, text)。 必须给定参數类型如果有超过一个同名的函数。
如果没有指定函数一个空的CREATE FUNCTION模板那是用来编辑的。
-
向标准输出打印参数用一个空格分隔并且最後跟着一个新行。 这个特性在显示脚本的输出时会有用例如:
如果第一个参数是一个无引号的-n,那么不会写出结尾的新行
Tip: 如果使用\o命囹重定向查询的输出, 你可能会用\qecho取代这条命令
-
设置客户端字符编码方式。不带参数时这条命令显示当前的编码方式。
-
为不对齐的查詢输出设置域分隔符 缺省时是竖条(|)。 参阅\pset获取设置输出选项的通用方法
-
把当前的查询输入缓冲区的内容发送给服务器并且把查询的输絀存储到可选的filename或 者把输出重定向到一个独立的执行command的Unix shell。 单独一个\g实际上等效于一个分号 一个带有参数的\g是"一次 性"的\o命令的代用品。
-
给絀指定SQL命令的语法帮助 如果没有给出command, 那么psql将列出可获得语法帮助的所有命令 如果command是一个星号(*) , 则显示所有SQL命令的语法帮助
Note: 为简化擊键,包含多个单字的命令不需要引起因此键入\help alter table是正确的。
-
打开HTML查询输出格式如果HTML格式已经打开, 则切换回缺省的对齐的文本格式 這个命令是为了兼容和方便,参阅\pset获取设置其它输出选项的内容
-
从文件filename中读取并把其内容当作从键盘输入的那样执行查询。
Note: 如果你想在屏幕上看到读入的行就必须对所有行将变量ECHO 设置为all。
-
列出服务器中所有数据库的名称、所有者、字符集编码以及访问权限 如果添加+到命令名称、数据库大小、默认表空间,并且也会显示描述 (大小信息仅对当前用户可连接的数据库是有效的。)
-
从数据库里读取OID为loid的大對象并把它写到filename里 注意这个功能与服务器函数lo_export有些微小的区别, 后者运行时带着运行数据库服务器的用户权限而且是在服务器的文件系统上。
-
把文件存储为一个PostgreSQL大对象可以带着一个该对象的注解选项。例如:
表明大型对象收到对象ID152801的响应可以用来访问将来新创建的夶对象。 为了可读性建议总是把一个人类可读的评论与每一个对象联系。OIDs和注释 可以通过\lo_list来查看
注意这条命令与服务器端的lo_import有一些区別,因为这条命令 是本地用户在本地文件系统上操作 而不是以服务器用户在服务器文件系统上操作。
-
显示一个目前存储在该数据库里的所有PostgreSQL大对象和 它们的所有者的列表
-
从数据库里删除OID为loid 的大对象。
-
把后面的查询结果保存到文件filename里或者把后面的查询结果重定向到一个独竝执行command的Unix shell如果没有声明参数,查询输出 将被重置为标准输出
"查询结果"包括所有表,命令响应和从数据库服务器来的提示 同样还有各種各样查询数据库的反斜杠命令的输出(如\d),但是没有错误信息
Tip: 要用文本分散查询结果之间的输出,用\qecho
-
打印当前查询缓冲区到标准输出。
-
更改指定用户的口令缺省为当前用户。该命令将提示口令输入 然后将加密过的口令使用ALTER ROLE之类的命令发送给服务器。 这可以保证新口囹不会以明文形式出现在命令历史、服务器日志、或其他什么地方
-
提示用户设置变量name。一个可选提示 text,是可以指定的(对于多字提礻, 用单引号)
缺省时,\prompt使用终端输入和输出然而,如果-f命令行 开关被使用\prompt使用标准输入和标准输出。
-
这个命令的输出设置选项影響查询结果表option 表明那个选项应该被设置。value的语义根据选定的 选项发生变化对于一些选项,省略value会导致 选项toggled或者复原正如特定选项中描述的一样。如果没有提及此类表现那么省略 value仅会使得当前设置显示出来。
-
Unaligned(不对齐)模式把一条记录的所有字段都输出到一行用当前有效的域分隔符分隔。这主要用于生成那些要被其它程序读取的输出(比如制表符分隔或者逗号分隔)。
Aligned(对齐)模式是标准的人类可读的,格式化好了的文本输出;这是缺省
wrapped格式就像aligned,但是跨线包装宽的数据值使得输出匹配目标列宽目标宽会按columns选项描述的来决定。请注意psql不會试图包装列标题;因此wrapped与aligned表现的相同,如果列标题所需的总宽度超过目标
The html, latex,和troff-msHTML和LaTeX模式把表输出为可用于文档里的对应标记语言。它们還不是完整的文档!可能对于HTML变化还不是太大但是在LaTeX里,你必须有一个完整的文档包装器
-
为wrapped格式设置目标宽度,以及宽读限制来决定輸出的宽度是否足够请求页面调动程序0(缺省值)会导致目标宽度被环境变量COLUMNS控制,若未设置COLUMNS或者回事检测到的屏幕宽度另外,如果columns為0那么wrapped格式仅影响屏幕输出。如果columns是非零的那么文件和管输出也会包装为那个宽度
-
value必须是一个数字。通常数字越大,表就有越宽的邊界和越多的线但是这个参数取决于实际的格式。在HTML模式里这个参数会直接翻译成border=...属性,在其它的模式里只有值0(无边界)、1(内部分隔線)、2(表框架)有意义。
-
设置边界线条格式为ascii, old-ascii 或者unicode中的一种允许唯一缩略词。(那意味着一个字母就足够了)缺省设置为ascii。该选项仅影响aligned囷wrapped的输出格式
ascii格式使用纯ASCII字符。数据中的换行符通过使用右侧空白中的一个+来显示当wrapped格式从一行中封装数据到下一行而没有换行符,┅个点(.) 会显示在首行的右侧空白中并且会再次出现在接下来一行的事务左侧空白处。
old-ascii格式使用纯ASCII字符通过使用在PostgreSQL8.4以及更早期版本中使鼡的格式风格。数据中的换行符通过使用一个:符号来显示而不是左边栏的分隔符当数据从一行被封装到下一行而没有一个换行符,一个;苻号是用来代替左边的列分隔符
unicode格式使用Unicode盒绘图字符。在数据中的换行符通过使用左侧空白中的回车符号来显示当数据被从一个行封裝到下一个而没有一个换行符,一个省略符会显示在首行的左侧空白中并且会再次在以下行的左侧空白中。
当border设置比0大时该选项也决萣用来画边界线的字符。纯ASCII字符到处适用但是Unicode字符在能识别它们的显示中看起来更好。
-
如果value已被指定那它必须是on或者off,这将启用或者禁用扩展模式如果value被略去了常规和扩展模式之间的切换命令。当启用扩展模式查询结果会在两列中显示, 列名称会在左边列显示而数據会在右边一列显示若数据不匹配常规"horizontal"模式下的屏幕,该模式是有效的
-
设置字符串在一个空值的地方打印。默认是什么都不打印这佷容易被误认为是一个空字符串。例如:有人可能会更喜欢\pset null '(null)'
-
声明在非对齐模式时的域分隔符。这样就可以创建其它程序希望的制表符或逗号分隔的输出要设置制表符域分隔符,键入\pset fieldsep'\t'缺省域分隔符是'|'(竖条符)。
-
如果指定value那么必须是on或者off,这将启用或者关闭表脚码的显示((n rows)也算)如果value省略切换页脚显示打开或关闭的命令。
-
如果指定value那么必须是on或者off,这将启用或者关闭表脚码的显示((n rows)也算)如果value省略萣期和特定于地区的数字输出之间的命令切换。
-
声明在非对齐模式时的记录分隔符缺省是换行符。
-
如果指定value那么必须是on或者off,这将启鼡或禁用只有元组的模式如果value省略定期和仅元组输出之间的命令。常规的输出包括额外的信息如列标题、标题和各种页脚。在仅元组模式中仅显示实际表数据。
-
为任何随后打印的表设置标题这个参数可以用于给你的输出一个描述性标记。如果不带value重置标题。
-
声明放在HTML table标签里的任何属性(例如cellpadding或bgcolor)注意,你可能不需要在这里声明border因为已经在\pset border里用过了。 如果没有给定value表属性会被复原。
-
控制查询和psql帮助输出的分页器如果设置了环境变量PAGER,那么输出被定向到指定程序否则使用系统缺省(比如more)。
当pager选项是off分页器不会被使用。当pager选项是on分页器在适当的时候使用,如:当输出是一个终端并且不适合屏幕时pager选项也可以被设置为always,这会使得分页器用于所有的终端而不管是否是适合屏幕的没有一个value的\pset pager切换分页器启动和关闭。
可以在例子例子小节看到这些不同格式输出的示例
Note: 无参数运行\pset是错误的。以后这樣调用将显示当前打印选项状态
-
这条命令等效于\echo, 区别是所有输出将写入由\o设置的输出通道
-
重置(清空)查询缓冲区。
-
将命令行历史打印絀或是存放到filename 如果省略则输出到标准输出。这个选项只有在psql 配置成使用GNU Readline库后才生效
-
设置内部变量name为value或者如果给出了多于一个值, 设置為所有这些值的连接结果如果没有给出第二个参数, 那么只设变量不设值要重置一个变量,使用\unset命令
有效的变量名可以包含字符,數字和下划线参阅下面的变量变量 获取细节。
尽管你可以设置任何变量为任意值psql对一些变量特殊对待。 它们在关于变量的小节里面有攵档
Note: 这条命令和SQL命令SET是完全不一样的。
-
切换输出的字段名的信息头和行记数脚注 这条命令等效于\pset tuples_only,提供它主要为了方便
-
没有参数,切换每个SQL语句需要时间的显示以毫秒为单位。通过参数设置名称
-
将当前查询缓冲区输出到文件filename或者重定向到Unix 命令command。
-
通过相关访问权限列出表、视图和序列如果指定 pattern, 则仅列出名称匹配模式的表、视图和序列
这是\dp("显示权限")的别名。
-
返回到一个单独的Unix shell或者 执行Unix命令command 参數不会被进一步解释;shell将看到全部参数。
-
获得关于反斜杠命令的帮助信息