PostgreSQL 9.2.4所有命令的语法帮助及SQL语句简要说明

 

clusterdb

clusterdb 对一个数据库中先前已经建过簇的表进行建簇.

 

使用方法:

 clusterdb [选项]... [数据库名]

 

选项:

  -a,--all                 对所有数据库建簇

  -d,--dbname=DBNAME       对数据库 DBNAME 建簇

  -e,--echo                显示发送到服务端的命令

  -q,--quiet               不写任何信息

  -t,--table=TABLE         只对指定的表 TABLE 建簇

  -v,--verbose                   写大量的输出

  -V,--version             输出版本信息, 然后退出

  -?,--help                显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAM        数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT           数据库服务器端口号

  -U,--username=USERNAME   联接的用户名

  -w,-no-password         永远不提示输入口令

  -W,--password            强制提示输入口令

 --maintenance-db=DBNAME   更改维护数据库

 

阅读 SQL 命令 CLUSTER 的描述信息, 以便获得更详细的信息.

 

臭虫报告至.

 

createdb

createdb 创建一个 PostgreSQL 数据库.

 

使用方法:

  createdb[选项]... [数据库名称] [描述]

 

选项:

  -D,--tablespace=TABLESPACE  数据库默认表空间

  -e,--echo                   显示发送到服务端的命令

  -E,--encoding=ENCODING      数据库编码

  -O,--owner=OWNER            新数据库的所属用户

     --lc-collate=LOCALE      数据库的LC_COLLATE设置

     --lc-ctype=LOCALE        数据库的LC_CTYPE设置

  -O,--owner=OWNER            新数据库的所属用户

  -T,--template=TEMPLATE      要拷贝的数据库模板

  -V,--version                输出版本信息, 然后退出

  -?,--help                   显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAME          数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT              数据库服务器端口号

  -U,--username=USERNAME      联接的用户名

  -w,--no-password           永远不提示输入口令

  -W,--password              强制提示输入口令

 --maintenance-db=DBNAME      更改维护数据库

 

默认情况下, 以当前用户的用户名创建数据库.

 

臭虫报告至.

 

createlang

createlang 安装一个过程语言进 PostgreSQL 数据库.

 

使用方法:

 createlang [选项]... 语言名称 [数据库名]

 

选项:

  -d,--dbname=DBNAME       要安装语言的数据库

  -e,--echo                显示发送到服务端的命令

  -l,--list                显示当前已经安装了的语言列表

  -V,--version             输出版本信息, 然后退出

  -?,--help                显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAM        数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT           数据库服务器端口号

  -U,--username=USERNAME   联接的用户名

  -w,-no-password         永远不提示输入口令

  -W,--password            强制提示输入口令

 

臭虫报告至.

 

createuser

createuser 创建一个新的 PostgreSQL 用户.

 

使用方法:

 createuser [选项]... [用户名]

 

选项:

  -c,--connection-limit=N                  角色的连接限制(缺省: 没有限制)

  -d,--createdb                                 此角色可以创建新数据库

  -D,--no-createdb                                   此角色不可以创建新数据库(默认)

  -e,--echo                                       显示发送到服务端的命令

  -E,--encrypted                               口令加密存储

  -i,--inherit                                     角色能够继承它所属角色的权限（这是缺省情况)

  -I,--no-inherit                                角色不继承权限

  -l,--login                                       角色能够登录(这是缺省情况)

  -L,--no-login                                 角色不能登录

  -N,--unencrypted                           口令不加密存储

  -P,--pwprompt                               给新角色指定口令

  -r,--createrole                                这个角色可以创建新的角色

  -R,--no-createrole                          这个角色没有创建其它角色的权限(默认)

  -s,--superuser                                角色将是超级用户

  -S,--no-superuser                           角色不能是超级用户(默认)

  -V,--version                                   输出版本信息, 然后退出

 --interactive                                   提示缺少角色名及其属性，而不是使用默认值

 --replication                                          角色能启动复制

 --no-replication                              角色不能启动复制

  -?,--help                                       显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAM                    数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT                             数据库服务器端口号

  -U,--username=USERNAME          联接用户 (不是要创建的用户名)

  -w,-no-password                                   永远不提示输入口令

  -W,--password                               强制提示输入口令

 

臭虫报告至.

 

dropdb

dropdb 删除一个 PostgreSQL 数据库.

 

使用方法:

 dropdb [选项]... 数据库名

 

选项:

  -e,--echo                                       显示发送到服务端的命令

  -i,--interactive                               删除任何东西之前给予提示

  -V,--version                                   输出版本信息, 然后退出

 --if-exists                                       如果数据库不存在则不报告错误

  -?,--help                                       显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAM                    数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT                             数据库服务器端口号

  -U,--username=USERNAME          联接的用户名

  -w,-no-password                                   永远不提示输入口令

  -W,--password                               强制提示输入口令

 --maintenance-db=DBNAME           更改维护数据库

 

臭虫报告至.

 

droplang

droplang 从数据库中删除一个过程语言.

 

使用方法:

 droplang [选项]... 语言名称 [数据库名]

 

选项:

  -d,--dbname=DBNAME                 要删除语言的数据库

  -e,--echo                                       显示发送到服务端的命令

  -l,--list                                                 显示当前已经安装了的语言列表

  -V,--version                                   输出版本信息, 然后退出

  -?,--help                                       显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAM                    数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT                             数据库服务器端口号

  -U,--username=USERNAME          联接的用户名

  -w,-no-password                                   永远不提示输入口令

  -W,--password                               强制提示输入口令

 

臭虫报告至.

 

dropuser

dropuser 删除一个 PostgreSQL 用户.

 

使用方法:

 dropuser [选项]... [用户名]

 

选项:

  -e,--echo                显示发送到服务端的命令

  -i,--interactive         删除任何东西之前给予提示, 如果没有指定

                            角色名也给予提示

  -V,--version             输出版本信息, 然后退出

 --if-exists              用户名不存在时则不报告错误

  -?,--help                显示此帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAM        数据库服务器所在机器的主机名或套接字目录

  -p,--port=PORT           数据库服务器端口号

  -U,--username=USERNAME   联接用户 (不是要删除的用户名)

  -w,-no-password         永远不提示输入口令

  -W,--password            强制提示输入口令

 

臭虫报告至.

 

ecpg

ecpg是用于C语言程序的PostgreSQL嵌入式SQL预处理器.

 

Usage:

 ecpg [OPTION]... FILE...

 

选项:

-c              从嵌入式SQL代码中自动产生C代码;

                 这将影响EXEC SQL TYPE

-C MODE          设置兼容模式；MODE可以是下列模式之一

                 "INFORMIX","INFORMIX_SE"

  -DSYMBOL      定义SYMBOL

-h            分析一个头文件,这个选项包含选项"-c"

-i             分析系统引用文件

 -IDIRECTORY  为引用文件搜索变量DIRECTORY

-o OUTFILE     将结果写入到OUTFILE

  -rOPTION      指定运行时的系统行为; OPTION可以是:

          "no_indicator", "prepare", "questionmarks"

 --regression   在回归测试模式下运行

 -t             打开事务的自动提交功能

 --version      输出版本信息，然后退出

  -?,--help     显示帮助信息,然后退出

 

如果没有指定输出文件，那么输出文件名将由输入文件名（如果有后缀，那么去掉.pgc)

加上.c的后缀名组成.

 

错误报告至.

 

initdb

initdb 初始化一个PostgreSQL 数据库簇.

 

使用方法:

  initdb [选项]... [DATADIR]

 

选项:

  -A, --auth=METHOD         本地连接的默认认证方法

      --auth-host=METHOD   本地的TCP/IP连接的默认认证方法

      --auth-local=METHOD   本地socket连接的默认认证方法

  -D, --pgdata=DATADIR      当前数据库簇的位置

  -E, --encoding=ENCODING   为新数据库设置默认编码

      --locale=LOCALE      为新数据库设置默认语言环境

  --lc-collate, --lc-ctype, --lc-messages=LOCALE

  --lc-monetary,--lc-numeric, --lc-time=LOCALE

                            为新的数据库簇在各自的目录中分别

                   设定缺省语言环境（默认使用环境变

                   量)

 --no-locale               等同于 --locale=C

 --pwfile=文件名           对于新的超级用户从文件读取口令

  -T,--text-search-config=CFG

                   缺省的文本搜索配置

  -U,--username=NAME       数据库超级用户名

  -W,--pwprompt            对于新的超级用户提示输入口令

  -X,--xlogdir=XLOGDIR          当前事务日志目录的位置

 

非普通使用选项:

  -d,--debug               产生大量的除错信息

  -LDIRECTORY              输入文件的位置

  -n,--noclean             出错后不清理

  -s,--show                显示内部设置

 

其它选项:

  -V,--version             输出版本信息, 然后退出

  -?,--help                显示此帮助, 然后退出

 

如果没有指定数据目录, 将使用环境变量 PGDATA

 

报告错误至.

 

 

oid2name

oid2name helps examining the file structureused by PostgreSQL.

 

Usage:

 oid2name [OPTION]...

 

Options:

  -dDBNAME      database to connect to

  -fFILENODE    show info for table withgiven file node

  -HHOSTNAME    database server host orsocket directory

 -i             show indexes andsequences too

  -oOID         show info for table withgiven OID

  -p PORT        database server port number

  -q             quiet (don't show headers)

 -s             show alltablespaces

 -S             show system objectstoo

  -tTABLE       show info for named table

  -UNAME        connect as specified databaseuser

  -V,--version  output version information,then exit

 -x             extended (showadditional columns)

  -?,--help     show this help, then exit

 

The default action is to show all databaseOIDs.

 

Report bugs to.

 

 

pgbench

pgbench is a benchmarking tool forPostgreSQL.

 

Usage:

 pgbench [OPTION]... [DBNAME]

 

Initialization options:

 -i           invokesinitialization mode

  -FNUM       fill factor

  -sNUM       scaling factor

 --index-tablespace=TABLESPACE

               create indexes in the specifiedtablespace

 --tablespace=TABLESPACE

               create tables in the specifiedtablespace

 --unlogged-tables

               create tables as unlogged tables

 

Benchmarking options:

  -cNUM       number of concurrent databaseclients (default: 1)

 -C           establish newconnection for each transaction

  -DVARNAME=VALUE

               define variable for use bycustom script

  -fFILENAME  read transaction script fromFILENAME

  -jNUM       number of threads (default: 1)

 -l           write transactiontimes to log file

  -Msimple|extended|prepared

               protocol for submitting queriesto server (default: simple)

 -n           do not run VACUUMbefore tests

 -N           do not update tables"pgbench_tellers" and "pgbench_branches"

 -r           report averagelatency per command

  -sNUM       report this scale factor inoutput

 -S           perform SELECT-onlytransactions

  -tNUM       number of transactions eachclient runs (default: 10)

  -TNUM       duration of benchmark test inseconds

 -v           vacuum all fourstandard tables before tests

 

Common options:

 -d             print debuggingoutput

  -hHOSTNAME    database server host orsocket directory

  -p PORT        database server port number

  -U USERNAME    connect as specified database user

  -V,--version  output version information,then exit

  -?,--help     show this help, then exit

 

Report bugs to.

 

pg_archivecleanup

pg_archivecleanup removes older WAL filesfrom PostgreSQL archives.

 

Usage:

 pg_archivecleanup [OPTION]... ARCHIVELOCATION OLDESTKEPTWALFILE

 

Options:

 -d             generate debugoutput (verbose mode)

 -n             dry run, show thenames of the files that would be removed

  -V,--version  output version information,then exit

  -xEXT         clean up files if they havethis extension

  -?,--help     show this help, then exit

 

For use as archive_cleanup_command inrecovery.conf when standby_mode = on:

 archive_cleanup_command = 'pg_archivecleanup [OPTION]... ARCHIVELOCATION%r'

e.g.

 archive_cleanup_command = 'pg_archivecleanup /mnt/server/archiverdir %r'

 

Or for use as a standalone archive cleaner:

e.g.

 pg_archivecleanup /mnt/server/archiverdir000000010000000000000010.00000020.backup

 

Report bugs to.

 

pg_basebackup

pg_basebackup 在运行的PostgreSQL服务器上执行基础备份.

 

使用方法:

 pg_basebackup [选项]...

 

控制输出的选项:

 -D,--pgdata=DIRECTORY 接收基础备份到指定目录

  -F,--format=p|t       输出格式 (纯文本 (缺省值), tar压缩格式)

  -x,--xlog             在备份中包含必需的WAL文件(fetch 模式)

  -X,--xlog-method=fetch|stream

                         按指定的模式包含必需的WAL日志文件

  -z,--gzip             对tar文件进行压缩输出

  -Z,--compress=0-9     按给定的压缩级别对tar文件进行压缩输出

 

一般选项:

  -c,--checkpoint=fast|spread

                         设置检查点方式(fast或者spread)

  -l,--label=LABEL      设置备份标签

  -P,--progress         显示进度信息

  -v,--verbose          输出详细的消息

  -V,--version          输出版本信息, 然后退出

  -?,--help             显示帮助, 然后退出

 

联接选项:

  -h,--host=HOSTNAME    数据库服务器主机或者是socket目录

  -p,--port=PORT        数据库服务器端口号

  -s,--status-interval=INTERVAL

                        发往服务器的状态包的时间间隔 (以秒计)

  -U,--username=NAME    指定连接所需的数据库用户名

  -w,--no-password      禁用输入密码的提示

  -W,--password         强制提示输入密码 (应该自动发生)

 

错误报告至.

 

pg_config

 

pg_config 提供 PostgreSQL 的安装信息.

 

使用方法:

 pg_config [选项]...

选项:

 --bindir              显示执行文件所在位置

 --docdir             显示文档所在位置

 --htmldir             显示HTML文档文件所在位置

 --includedir          显示客户端接口 C 头文件所在

                        位置

 --pkgincludedir      显示其它C语言头文件所在的位置

 --includedir-server   显示服务端 C 头文件所在位置

 --libdir              显示目标代码库文件所在位置

 --pkglibdir           显示动态加载库所在位置

 --localedir           显示语言环境支持文件所在位置

 --mandir            显示参考手册所在位置

 --sharedir              显示独立架构支持文件所在位置

 --sysconfdir          显示系统范围的配置文件的所在位置

 --pgxs                显示扩展 makefile 所在位置

 --configure           显示编译 PostgreSQL 时 "configure"

                        的选项

 --cc                   显示在创建PostgreSQL时所使用的CC值

 --cppflags            当创建PostgreSQL时显示CPPFLAGS的值

 --cflags             显示在创建PostgreSQL时所使用的CFLAG值

 --cflags_sl            当创建PostgreSQL时显示CFLAGS_SL的值

 --ldflags             显示在创建PostgreSQL时所使用的LDFLAG值

 --ldflags_ex          当创建PostgreSQL时显示LDFLAGS_EX的值

 --ldflags_sl           当创建PostgreSQL时显示LDFLAGS_SL的值

 --libs               显示在创建PostgreSQL时所使用的LIBS值

  --version             显示PostgreSQL的版本信息

  -?,--help            显示帮助, 然后退出

 

没有参数,将显示所有已知的成员.

 

臭虫报告至.

 

pg_controldata

pg_controldata 显示 PostgreSQL 数据库簇控制信息.

 

使用方法:

 pg_controldata [选项][DATADIR]

 

选项:

 -V,--version 输出版本信息，然后退出

  -?,--help     显示帮助信息，然后退出

 

如果没有指定数据目录(DATADIR),将使用

环境变量PGDATA.

 

报告错误至.

 

pg_ctl

pg_ctl 是一个用于初始化、启动、停止或控制PostgreSQL服务器的工具.

 

使用方法:

 pg_ctl init[db]               [-D 数据目录] [-s] [-o "选项"]

 pg_ctl start   [-w]  [-t 秒数] [-D 数据目录] [-s] [-l文件名] [-o"选项"]

 pg_ctl stop   [-w]  [-t 秒数] [-D 数据目录] [-s] [-m关闭模式]

 pg_ctl restart [-w] [-t 秒数] [-D 数据目录] [-s] [-m关闭模式]

                [-o "选项"]

 pg_ctl reload  [-D 数据目录] [-s]

 pg_ctl status  [-D 数据目录]

 pg_ctl promote  [-D 数据目录] [-s]

  pg_ctlkill    信号名称进程号

 pg_ctl register   [-N 服务名称] [-U 用户名] [-P 口令] [-D 数据目录]

         [-S 启动类型] [-w] [-t秒数] [-o "选项"]

 pg_ctl unregister [-N 服务名称]

 

普通选项:

  -D,--pgdata=数据目录  数据库存储区域的位置

  -s,--silent           只打印错误信息, 没有其他信息

  -t,--timeout=SECS    当使用-w 选项时需要等待的秒数

  -V,--version           输出版本信息, 然后退出

 -w                     等待直到操作完成

 -W                     不用等待操作完成

  -?,--help             显示此帮助, 然后退出

(默认为关闭等待, 但不是启动或重启.)

 

如果省略了 -D 选项, 将使用 PGDATA 环境变量.

 

启动或重启的选项:

  -c,--core-files       在这种平台上不可用

  -l,--log=FILENAME    写入 (或追加) 服务器日志到文件FILENAME

  -oOPTIONS             传递给postgres的命令行选项

                      (PostgreSQL 服务器执行文件)或initdb

  -pPATH-TO-POSTMASTER  正常情况不必要

 

停止或重启的选项:

  -m,--mode=MODE        可以是 "smart","fast", 或者 "immediate"

 

关闭模式有如下几种:

 smart       所有客户端断开连接后退出

 fast        直接退出, 正确的关闭

 immediate   不完全的关闭退出; 重启后恢复

 

允许关闭的信号名称:

 ABRT HUP INT QUIT TERM USR1 USR2

 

注册或注销的选项:

  -N 服务名称     注册到 PostgreSQL 服务器的服务名称

  -P 口令         注册到 PostgreSQL 服务器帐户的口令

  -U 用户名       注册到 PostgreSQL 服务器帐户的用户名

  -SSTART-TYPE   注册到PostgreSQL服务器的服务启动类型

 

启动类型有:

 auto       在系统启动时自动启动服务(默认选项)

 demand     按需启动服务

 

臭虫报告至.

 

pg_dump

pg_dump 把一个数据库转储为纯文本文件或者是其它格式.

 

用法:

 pg_dump [选项]... [数据库名字]

 

一般选项:

  -f,--file=FILENAME          输出文件或目录名

  -F,--format=c|d|t|p         输出文件格式 (定制, 目录, tar)

                               明文 (默认值))

  -v,--verbose                详细模式

  -V,--version                输出版本信息，然后退出

  -Z,--compress=0-9           被压缩格式的压缩级别

 --lock-wait-timeout=TIMEOUT  在等待表锁超时后操作失败

  -?,--help                   显示此帮助, 然后退出

 

控制输出内容选项:

  -a,--data-only              只转储数据,不包括模式

  -b,--blobs                  在转储中包括大对象

  -c,--clean                  在重新创建之前，先清除（删除）数据库对象

  -C,--create                 在转储中包括命令,以便创建数据库

  -E,--encoding=ENCODING      转储以ENCODING形式编码的数据

  -n,--schema=SCHEMA          只转储指定名称的模式

  -N,--exclude-schema=SCHEMA  不转储已命名的模式

  -o,--oids                   在转储中包括 OID

  -O,--no-owner               在明文格式中, 忽略恢复对象所属者

 

  -s,--schema-only            只转储模式, 不包括数据

  -S,--superuser=NAME         在明文格式中使用指定的超级用户名

  -t,--table=TABLE            只转储指定名称的表

  -T,--exclude-table=TABLE    不转储指定名称的表

  -x,--no-privileges          不要转储权限 (grant/revoke)

 --binary-upgrade             只能由升级工具使用

 --column-inserts             以带有列名的INSERT命令形式转储数据

 --disable-dollar-quoting     取消美元 (符号) 引号, 使用 SQL 标准引号

 --disable-triggers           在只恢复数据的过程中禁用触发器

 --exclude-table-data=TABLE   不转储指定名称的表中的数据

 --inserts                    以INSERT命令，而不是COPY命令的形式转储数据

 --no-security-labels         不转储安全标签的分配

 --no-tablespaces             不转储表空间分配信息

 --no-unlogged-table-data     不转储没有日志的表数据

 --quote-all-identifiers      所有标识符加引号，即使不是关键字

 --section=SECTION            备份命名的节 (数据前, 数据, 及 数据后)

 --serializable-deferrable   等到备份可以无异常运行

  --use-set-session-authorization

                               使用 SESSION AUTHORIZATION 命令代替

                ALTER OWNER 命令来设置所有权

 

联接选项:

  -h,--host=主机名        数据库服务器的主机名或套接字目录

  -p,--port=端口号        数据库服务器的端口号

  -U,--username=名字      以指定的数据库用户联接

  -w,--no-password        永远不提示输入口令

  -W,--password           强制口令提示 (自动)

 --role=ROLENAME          在转储前运行SET ROLE

 

如果没有提供数据库名字, 那么使用 PGDATABASE 环境变量

的数值.

 

报告错误至.

 

pg_dumpall

pg_dumpall 抽取一个 PostgreSQL 数据库簇进一个 SQL 脚本文件.

 

用法:

 pg_dumpall [选项]...

 

一般选项:

  -f,--file=FILENAME          输出文件名

  -V,--version                输出版本信息，然后退出

 --lock-wait-timeout=TIMEOUT  在等待表锁超时后操作失败

  -?,--help                   显示此帮助, 然后退出

 

控制输出内容选项:

  -a,--data-only              只转储数据,不包括模式

  -c,--clean                  在重新创建数据库前先清除(删除)数据库

  -g,--globals-only           只转储全局对象, 不包括数据库

  -o,--oids                   在转储中包括 OID

  -O,--no-owner               不恢复对象所属者

  -r,--roles-only             只转储角色，不包括数据库或表空间

  -s,--schema-only            只转储模式, 不包括数据

  -S,--superuser=NAME         在转储中, 指定的超级用户名

  -t,--tablespaces-only       只转储表空间，而不转储数据库或角色

  -x,--no-privileges          不要转储权限 (grant/revoke)

 --binary-upgrade             只能由升级工具使用

 --column-inserts             以带有列名的INSERT命令形式转储数据

 --disable-dollar-quoting     取消美元 (符号) 引号, 使用 SQL 标准引号

 --disable-triggers           在只恢复数据的过程中禁用触发器

 --inserts                    以INSERT命令，而不是COPY命令的形式转储数据

 --no-security-labels         不转储安全标签的分配

 --no-tablespaces             不转储表空间分配信息

 --no-unlogged-table-data     不转储没有日志的表数据

 --quote-all-identifiers      所有标识符加引号，即使不是关键字

 --use-set-session-authorization

                               使用 SESSION AUTHORIZATION 命令代替

                ALTER OWNER 命令来设置所有权

 

联接选项:

  -h,--host=主机名        数据库服务器的主机名或套接字目录

  -l,--database=DBNAME    另一个缺省数据库

  -p,--port=端口号        数据库服务器的端口号

  -U,--username=名字      以指定的数据库用户联接

  -w,--no-password        永远不提示输入口令

  -W,--password           强制口令提示 (自动)

 --role=ROLENAME          在转储前运行SET ROLE

 

如果没有使用-f/--file，那么将把SQL脚本写到标准输出

.

 

报告错误至.

 

pg_isolation_regress

PostgreSQL regression test driver

 

Usage:

 pg_isolation_regress [OPTION]... [EXTRA-TEST]...

 

Options: