psql的命令语法是:
psql [options] [dbname [username]]
psql命令行选项以及它们的意思在表1-1中列出。使用以下命令可以看到psql完整的选项列表:
$ psql --help
表1-1 psql命令行选项
选项 |
意义 |
-a |
从脚本中响应所有输入 |
-A |
取消表数据输出的对齐模式;功能与“-P format=unaligned”相同 |
-c <查询> |
仅仅运行一个简单的查询(或者内部命令)然后退出 |
-d <数据库名> |
指定连接到的数据库名(默认为$PGDATABASE或者当前登录用户名) |
-e |
回显发送到服务器的查询 |
-E |
显示内部命令生成的查询语句 |
-f <文件名> |
执行一个文件中的查询,然后退出 |
-F <字符串> |
指定列数据显示分隔符(默认为“|”);功能与“-P fieldsep=<字符串>”相同 |
-h <主机> |
指定数据库服务器主机(默认为$PGHOST或者本地主机) |
-H |
设置表格输出模式为HTML;功能与“-P format=html”相同 |
--help |
显示帮助,然后退出 |
-l |
列出存在的数据库,然后退出 |
-n |
禁用readline;阻止行编辑 |
-o <文件名> |
将查询的输出发送到文件名指定文件(使用“|管道”的形式将输出发送到一个过滤程序) |
-p <端口> |
指定数据库服务器的端口(默认为$PGPORT或者编译期设置的默认值,通常为4321) |
-P var[=arg] |
设置打印选项var为arg(查看pset命令) |
-q |
以静默方式运行(没有任何消息,仅有查询的输出) |
-R <字符串> |
设置记录的分隔符(默认为换行);功能与“-P recordsep=<字符串>”相同 |
-s |
设置为单步执行模式(每条查询都需要确认) |
-S |
设置单行模式(每行结束就认为查询输入结束,而不是分号) |
-t |
只打印行;功能与“-P tuples_only”相同 |
-T <文本> |
设置HTML表格标记选项(width,border等);功能与“-P tableattr=<text>”相同 |
-U <用户名> |
指定数据库用户(默认为$PGUSER或者当前登录的用户名) |
-v name=value |
设置psql变量name的值为value |
--version |
显示版本信息然后退出,也可以用“-V” |
-W |
强制提示输入密码(如果需要密码,会自动执行) |
-x |
开启扩展表格输出;功能与“-P expanded”相同 |
-X |
不读取启动文件(~/.psqlrc) |
psql内部命令快速参考
psql支持的内部命令在表1-2中列出。在很多版本的PostgreSQL中,这些命令有一些更易读的长模式(例如list就是l的长模式命令)。
表1-1 psql命令行选项
命令 |
意义 |
? |
列出所有的psql内部命令 |
a |
在表格对齐和非对齐模式之间切换。 |
c[onnect] [dbname|- [user]] |
连接到新的数据库;使用“-”作为数据库名指连接到默认数据库。可以user身份连接数据库 |
C <标题> |
设置输出表格的标题;功能与“pset 标题”相同 |
cd <目录> |
改变工作目录 |
copy … |
Perform SQL COPY with data stream to the client machine. |
copyright |
显示PostgreSQL的使用和发布条款 |
d <表> |
描述表(或者视图、索引、序列生成器) |
d{t|i|s|v} |
列出表/索引/序列生成器/视图 |
d{p|S|l} |
列出访问许可/系统表/大对象 |
da |
列出聚合体(aggregates) |
db |
列出表空间 |
dc |
列出conversions |
dC |
列出casts |
dd [对象] |
列出表、类型、函数或者操作的注释 |
dD |
列出domains |
df |
列出函数(自定义函数???)需要验证 |
dg |
列出groups |
dl |
列出大对象;也可以写作“lo_list” |
dn |
列出模式 |
do |
列出operators |
dT |
列出数据类型 |
du |
列出用户 |
e [file] |
使用外部编辑器编辑当前的查询缓冲区或者file指定的文件 |
echo <文本> |
将文本打印到标准输出 |
encoding <编码> |
设置客户端编码 |
f <分隔符> |
修改输出字段的分隔符 |
g [文件名] |
将查询的结果发送到后端(结果输出到文件或者|管道) |
h [命令] |
显示SQL命令的帮助;*表示所有命令的详细说明 |
H |
开启HTML模式 |
i <文件名> |
从文件中读取并执行查询 |
l |
列出所有的数据库 |
lo_export,lo_import, lo_list,lo_unlink |
执行大对象操作 |
o [文件名] |
将所有的查询结果发送到文件或者|管道 |
p |
显示当前查询缓冲区的内容 |
pset <选项> |
设置表输出选项,可设置的选项可以是以下中的一个:format,border,expanded,fieldsep,footer,null,recordsep,tuples_only,title,tableattr,pager |
q |
退出psql |
qecho <文本> |
将文本写入到查询输出流(参考o命令) |
|
重置(清空)查询缓冲区 |
s [文件名] |
打印历史或将历史存入文件中 |
set <变量> <值> |
设置内部变量 |
|
只显示行(在该模式之间切换) |
T <标记> |
设置HTML表格的标记;功能和“pset tableattr”相同 |
iming |
显示命令执行的时间(在显示和不显示这两种模式间切换) |
z |
列出对表、视图和序列生成器的访问许可 |
! [命令] |
切换到shell或者执行一个shell命令 |