initdb · PostgreSQL 中文文檔 9.3

# initdb ## Name initdb?--?創建一個新的PostgreSQL數據庫簇（cluster） ## Synopsis `initdb` [`_option_`...] [`--pgdata` | `-D`]` _directory_` ## 描述 `initdb`創建一個新的 PostgreSQL數據庫簇（cluster）。一個數據庫簇（cluster）是由單個服務端實例管理的多個數據庫的集合。創建數據庫系統包括創建數據庫數據的宿主目錄，生成共享的系統表（不屬于任何特定數據庫的表）和創建`template1` 和`postgres`數據庫。當你以后再創建一個新數據庫時，`template1` 數據庫里所有內容都會拷貝過來。（因此，任何在`template1` 里面安裝的東西都自動拷貝到以后創建的數據庫中。） `postgres`數據庫是一個缺省數據庫，用于給用戶、工具、第三方應用提供缺省數據庫。盡管`initdb`會嘗試創建相應的數據目錄，但經常會沒有權限做這件事。因為所要創建目錄的父目錄通常被 root所擁有。要初始化這種設置，用root創建一個空數據目錄，然后用 `chown`把該目錄的所有權交給數據庫用戶帳號，然后 `su`成數據庫用戶，最后以數據庫用戶身份運行 `initdb`。 `initdb`必須以運行數據庫服務端的用戶身份運行，因為服務端需要訪問`initdb`創建的目錄和文件。因為服務端通常是以非root身份運行的，因此一般也就不以root用戶運行 `initdb`（事實上將拒絕你以root用戶運行它）。 `initdb`初始化該數據庫簇（cluster）的缺省區域和字符集編碼。字符編碼排序(`LC_COLLATE`)和字符集類 (`LC_CTYPE`, 也就是大寫、小寫、數字等)可以在數據庫創建的時候獨立設置。 `initdb`決定了`template1`數據庫，這個設置將成為所有其它（以后新建）數據庫的缺省。要更改默認的排序順序或字符集分類，使用 `--lc-collate`和`--lc-ctype`選項。使用`C`或`POSIX`之外的字符編碼排序還會有性能影響。因此在運行`initdb`的時候就做出正確的選擇是非常重要的。在服務端啟動時，你可以使用`--locale` 設置缺省的所有語言環境類別，包括排序順序和字符集種類。其余的語言環境類別以后可以修改。所有服務器區域值(`lc_*`) 可以用`SHOW ALL`顯示。更多細節可以在[Section 22.1](#calibre_link-1271)找到。要修改缺省編碼，可以使用`--encoding`選項。更多細節可以在[Section 22.3](#calibre_link-1272)找到。 ## 選項 `-A` `_authmethod_``--auth=``_authmethod_` 這個選項指定本地用戶在`pg_hba.conf`里面設置的認證方法。 (`host` 和`local` 所在行)。除非你信任所有本地系統用戶。否則不要使用 `trust`。`trust`是缺省的。 `--auth-host=``_authmethod_` 這個選項指定本地TCP/IP聯接用戶在`pg_hba.conf`里面設置的認證方法。 (`host` 所在行)。 `--auth-local=``_authmethod_` 這個選項指定本地Unix-domain socket聯接用戶在`pg_hba.conf`里面設置的認證方法。 (`local` 所在行)。 `-D` `_directory_` `--pgdata=``_directory_` 這個選項聲明數據庫簇（cluster）應該存放在哪個目錄。這是 `initdb`惟一（必須）需要的信息，但是你可以通過設置 `PGDATA`環境變量來避免鍵入，這樣做可能方便一些，因為稍后數據庫服務器 (`postgres`) 可以通過同一個變量找到數據庫目錄。 `-E` `_encoding_` `--encoding=``_encoding_` 選擇模板數據庫的編碼方式。這將是你以后創建的數據庫的缺省編碼方式，除非你創建數據庫時覆蓋了它。缺省是從區域設置中獲得的，如果沒有區域設置，就是 `SQL_ASCII`。PostgreSQL 服務器支持的字符集在[Section 22.3.1](#calibre_link-1463)里描述。 `-k` `--data-checksums` 使用數據頁產生校驗和，以幫助I/O系統，否則將靜音檢測損壞。啟用校驗和可能產生明顯的性能損失。此選項只能在初始化過程中設置，并且以后不能更改。如果設置，那么在所有數據庫中計算所有對象的校驗和。 `--locale=``_locale_` 為數據庫簇（cluster）設置缺省的區域。如果沒有指定這個選項，那么區域是從`initdb` 運行的環境中繼承過來的。區域設置在[Section 22.1](#calibre_link-1271)里描述。 `--lc-collate=``_locale_` `--lc-ctype=``_locale_` `--lc-messages=``_locale_` `--lc-monetary=``_locale_` `--lc-numeric=``_locale_` `--lc-time=``_locale_` 類似`--locale`，但是只設置特殊范疇的區域。 `--no-locale` 相當于`--locale=C`。 `-N` `--nosync` 缺省情況下`initdb`會等待所有的文件被安全地寫入到磁盤中。此選項會導致`initdb`不進行等待，這樣更快，但意味著隨后的操作系統崩潰可能把數據目錄損壞。 `--pwfile=``_filename_` 令`initdb`從文件中讀取數據庫超級用戶的密碼。該文件的第一行被作為密碼。 `-S` `--sync-only` 安全地寫入所有數據庫文件到磁盤然后退出。這并不進行任何普通initdb操作。 `-T` `_CFG_` `--text-search-config=``_CFG_` 設置缺省的文本搜索配置。見[default_text_search_config](#calibre_link-1138)了解更多信息。 `-U` `_username_` `--username=``_username_` 選擇數據庫超級用戶的用戶名。缺省是運行 `initdb`的用戶的有效用戶。超級用戶的名字是什么并不重要，但是可以選擇習慣的名字postgres，即使和操作系統的用戶名不一樣也沒關系。 `-W` `--pwprompt` 令`initdb`提示輸入數據庫超級用戶的口令。如果你不準備使用口令認證，這個選項并不重要。否則你將不能使用口令認證，直到你設置了口令。 `-X` `_directory_` `--xlogdir=``_directory_` 此選項指定事務日志應該存放在哪個目錄。其它不常用的參數還有： `-d` `--debug` 從初始化后端打印調試輸出以及一些其它的一些普通用戶不太感興趣的信息。初始化后端是`initdb` 用于創建系統表的程序。這個選項生成大量非常枯燥的輸出。 `-L` `_directory_` 告訴`initdb`初始化數據庫時所需要的輸入文件的位置。通常不需要。如果需要你明確指定的話，程序會提示你輸入。 `-n` `--noclean` 缺省時，當`initdb`創建數據庫簇（cluster）時出錯，它將在檢測到不能結束工作之前將其創建的所有文件刪除。這個選項禁止任何清理動作，因而對調試很有用。其它參數： `-V` `--version` 輸出initdb命令的版本信息，然后退出。 `-?` `--help` 顯示initdb命令的幫助信息，然后退出。 ## 環境變量 `PGDATA` 指定數據庫簇（cluster）存儲的目錄; 可以使用`-D`選項覆蓋。此實用工具，像大多其他的PostgreSQL 實用工具，還使用libpq支持的環境變量libpq (見 [Section 31.14](#calibre_link-39))。 ## 注意 `initdb`還可以通過調用 `pg_ctl initdb`. ## 另請參閱 [pg_ctl](#calibre_link-544), [postgres](#calibre_link-1033)