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 的描述信息, 以便获得更详细的信息.
臭虫报告至<pgsql-bugs@postgresql.org>.
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 更改维护数据库
默认情况下, 以当前用户的用户名创建数据库.
臭虫报告至<pgsql-bugs@postgresql.org>.
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 强制提示输入口令
臭虫报告至<pgsql-bugs@postgresql.org>.
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 强制提示输入口令
臭虫报告至<pgsql-bugs@postgresql.org>.
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 更改维护数据库
臭虫报告至<pgsql-bugs@postgresql.org>.
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 强制提示输入口令
臭虫报告至<pgsql-bugs@postgresql.org>.
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 强制提示输入口令
臭虫报告至<pgsql-bugs@postgresql.org>.
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的后缀名组成.
错误报告至<pgsql-bugs@postgresql.org>.
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
报告错误至<pgql-bugs@postgresql.org>.
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<pgsql-bugs@postgresql.org>.
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<pgsql-bugs@postgresql.org>.
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<pgsql-bugs@postgresql.org>.
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 强制提示输入密码 (应该自动发生)
错误报告至<pgsql-bugs@postgresql.org>.
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 显示帮助, 然后退出
没有参数,将显示所有已知的成员.
臭虫报告至<pgsql-bugs@postgresql.org>.
pg_controldata
pg_controldata 显示 PostgreSQL 数据库簇控制信息.
使用方法:
pg_controldata [选项][DATADIR]
选项:
-V,--version 输出版本信息,然后退出
-?,--help 显示帮助信息,然后退出
如果没有指定数据目录(DATADIR),将使用
环境变量PGDATA.
报告错误至<pgsql-bugs@postgresql.org>.
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 按需启动服务
臭虫报告至<pgsql-bugs@postgresql.org>.
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 环境变量
的数值.
报告错误至<pgsql-bugs@postgresql.org>.
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脚本写到标准输出
.
报告错误至<pgsql-bugs@postgresql.org>.
pg_isolation_regress
PostgreSQL regression test driver
Usage:
pg_isolation_regress [OPTION]... [EXTRA-TEST]...
Options: