PostgreSQL initdb
initdb — 创建一个新的PostgreSQL数据库集簇
大纲
initdb
[option
...] [ --pgdata
| -D
] directory
描述
initdb
创建一个新的PostgreSQL数据库集簇。一个数据库集簇是由一个单一服务器实例管理的数据库的集合。
一个数据库集簇的创建包括创建存放数据库数据的目录、生成共享目录表(属于整个集簇而不是任何特定数据库的表)并且创建template1
和postgres
数据库。当你后来创建一个新的数据库时,任何在template1
数据库中的东西都会被复制(因此,任何已安装在template1
中的东西都会被自动地复制到后来创建的每一个数据库中)。
postgres
数据库是便于用户、工具和第三方应用使用的默认数据库。
尽管initdb
将尝试创建指定的数据目录,它可能没有权限(如果想要的数据目录的父目录被根用户拥有)。要在这样一种设置中初始化,作为 root 创建一个空数据目录,然后使用chown
将该目录赋予给数据库用户账户,再然后su
成为该数据库用户并运行initdb
。
initdb
必须以将拥有该服务器进程的用户运行,因为该服务器需要访问initdb
创建的文件和目录。因为该服务器不能作为 root 运行,你不能以 root 运行initdb
(事实上它会拒绝这样做)。
由于安全原因,由initdb
创建的新集簇默认将只能由集簇拥有者访问。--allow-group-access
选项允许与集簇拥有者同组的任何用户读取集簇中的文件。这对非特权用户执行备份很有用。
initdb
初始化该数据库集簇的默认区域和字符集编码。当一个数据库被创建时,其字符集编码、排序顺序(LC_COLLATE
)和字符集类(LC_CTYPE
,例如大写、小写、数字)可以被独立设置。initdb
为template1
数据库确定那些设置,它们将作为所有其他数据库的默认值。
要修改默认排序顺序或字符集类,使用--lc-collate
和--lc-ctype
选项。除C
或POSIX
之外的排序顺序也有性能罚值。由于这些原因,在运行initdb
时选择正确的区域很重要。
余下的区域分类可以在服务器启动之后改变。你也可以使用--locale
来为所有区域分类设置默认值,包括排序顺序和字符集类。所有服务器区域值(lc_*
)可以通过SHOW ALL
显示。详见第 23.1 节。
要修改默认编码,使用--encoding
。详见第 23.3 节.
选项
-A
authmethod
--auth=
authmethod
-
这个选项为本地用户指定在
pg_hba.conf
中使用的默认认证方法(host
和local
行)。initdb
将使用指定的认证方法为非复制连接以及复制连接填充pg_hba.conf
项。除非你信任你系统上的所有本地用户,不要使用
trust
。为了安装方便,trust
是默认值。 --auth-host=
authmethod
-
这个选项为通过 TCP/IP 连接的本地用户指定在
pg_hba.conf
中使用的认证方法(host
行)。 --auth-local=
authmethod
-
这个选项为通过 Unix 域套接字连接的本地用户指定在
pg_hba.conf
中使用的认证方法(local
行)。 -D
directory
--pgdata=
directory
-
这个选项指定数据库集簇应该存放的目录。这是
initdb
要求的唯一信息,但是你可以通过设定PGDATA
环境变量来避免书写它,这很方便因为之后数据库服务器(postgres
)可以使用同一个变量来找到数据库目录。 -E
encoding
--encoding=
encoding
-
选择模板数据库的编码。这也将是后来创建的任何数据库的默认编码,除非你覆盖它。默认值来自于区域,或者如果该值不起作用则为
SQL_ASCII
。PostgreSQL服务器所支持的字符集在第 23.3.1 节中描述。 -g
--allow-group-access
-
允许与集簇拥有者同组的用户读取
initdb
创建的所有集簇文件。 Windows会忽略此选项,因为它不支持POSIX样式的组权限。 -k
--data-checksums
-
在数据页面上使用校验码来帮助检测 I/O 系统造成的损坏。启用校验码将会引起显著的性能惩罚。如果设置,则为所有对象计算校验和,在整个数据库中。 所有校验和失败都将报告在
pg_stat_database
视图。 --locale=
locale
-
为数据库集簇设置默认区域。如果这个选项没有被指定,该区域将从
initdb
所运行的环境中继承。区域支持在第 23.1 节中描述。 --lc-collate=
locale
--lc-ctype=
locale
--lc-messages=
locale
--lc-monetary=
locale
--lc-numeric=
locale
--lc-time=
locale
-
和
--locale
相似,但是只在指定的分类中设置区域。 --no-locale
-
等效于
--locale=C
。 -N
--no-sync
-
默认情况下,
initdb
将等待所有文件被安全地写到磁盘。这个选项会导致initdb
不等待就返回,这当然更快,但是也意味着一次后续的操作系统崩溃可能让数据目录损坏。通常,这个选项对测试有用,但是不应该在创建生产安装时使用。 --pwfile=
filename
-
让
initdb
从一个文件读取数据库超级用户的口令。该文件的第一行被当作口令。 -S
--sync-only
-
安全地把所有数据库文件写入到磁盘并退出。这不会执行任何正常的initdb操作。
-T
config
--text-search-config=
config
-
设置默认的文本搜索配置。详见default_text_search_config。
-U
username
--username=
username
-
选择数据库超级用户的用户名。这个的默认值是实际运行
initdb
的用户的名称。超级用户的名字是什么真的不重要,但是你可以选择保留常用的名字postgres,即使操作系统的用户名不同。 -W
--pwprompt
-
让
initdb
提示要求为数据库超级用户给予一个口令。如果你没有计划使用口令认证,这就不重要。否则在你设置一个口令之前你就无法使用口令认证。 -X
directory
--waldir=
directory
-
这个选项指定预写式日志会被存储在哪个目录中。
--wal-segsize=
size
-
设置WAL段尺寸,以兆字节为单位。这是WAL日志中每个文件的尺寸。默认的尺寸为16兆字节。该值必须位于2的1次幂和1024次幂(兆字节)之间。这个选项只能在初始化期间设置,并且之后不能更改。
调整这个值来控制WAL日志传送或者归档可能会有用。此外,在有大量WAL的数据库中,每个目录中数量巨大的WAL文件可能会成为性能和管理问题。增加WAL文件尺寸将会降低WAL文件的数量。
其他较少使用的选项:
-d
--debug
-
打印来自引导后端的调试输出以及普通大众不那么感兴趣的一些消息。引导后端被程序
initdb
用来创建目录表。这个选项会生成大量极端无聊的输出。 -L
directory
-
指定
initdb
应从哪里寻找它的输入文件来初始化数据库集簇。这通常没有必要。如果你需要显式指定它们的位置,你应该被告知。 -n
--no-clean
-
默认情况下,当
initdb
确定有一个错误阻止它完整地创建数据库集簇,它会移除在它发现无法完成任务之前创建的任何文件。这个选项会抑制这种整理并且对调试有用。
其他选项:
-V
--version
-
打印initdb版本并退出。
-?
--help
-
显示有关initdb命令行参数的帮助并退出。
环境
PGDATA
-
指定数据库集簇应该被存放的目录,可以使用
-D
选项覆盖。 PG_COLOR
-
规定在诊断消息中是否使用颜色。可能的值为
always
、auto
、never
。 TZ
-
指定创建的数据集簇的默认时区。值应该是一个完整的时区名称(见第 8.5.3 节)。
和大部分其他PostgreSQL工具相似,这个工具也使用libpq(见第 33.14 节)支持的环境变量。
注解
initdb
可以通过pg_ctl initdb
被调用。