vacuumdb · PostgreSQL 中文文檔 9.3

# vacuumdb ## Name vacuumdb?--? 收集垃圾并分析一個PostgreSQL數據庫 ## Synopsis `vacuumdb` [`_connection-option_`...] [`_option_`...] [ `--table` | `-t` `_table_` [( `_column_` [,...] )] ] ... [`_dbname_`] `vacuumdb` [`_connection-option_`...] [`_option_`...] `--all` | `-a` ## 描述 vacuumdb是一個用于整理PostgreSQL 數據庫的工具。vacuumdb還將會生成用于 PostgreSQL查詢優化器的內部統計數據。 vacuumdb是 SQL 命令[VACUUM](#calibre_link-748)的封裝。因此，用哪種方法清理數據庫都一樣。 ## 選項 vacuumdb接受下列命令行參數： `-a``--all` 清理所有數據庫。 `[-d]` `_dbname_` `[--dbname=]``_dbname_` 聲明要被清理或分析的數據庫名稱。如果沒有聲明這個參數并且沒有使用`-a` 或`--all`，那么從將環境變量`PGDATABASE`里讀取數據庫名。如果那個也沒有設置，則使用連接的用戶名。 `-e` `--echo` 回顯vacuumdb生成并發送給服務器的命令。 `-f` `--full` 執行"完全"清理。 `-F` `--freeze` 強制"凍結"元組。 `-q` `--quiet` 不顯示進程信息。 `-t` `_table_` [ (`_column_` [,...]) ] `--table=``_table_` [ (`_column_` [,...]) ] 只是清理或分析`_table_`。字段名稱只是在與`--analyze`或`--analyze-only` 選項聯合使用時才需要聲明。可以通過寫多個`-t`選項清理多個表。 > **Tip:** 如果你聲明了要清理的字段，你可能不得不在 shell 上逃逸圓括弧(見下面的例子)。 `-v` `--verbose` 在處理過程中打印詳細信息。 `-V` `--version` 打印vacuumdb版本然后退出。 `-z` `--analyze` 計算用于優化器的統計數據。 `-Z` `--analyze-only` 只計算用于優化器的該數據庫的統計值（不清理）。 `-?` `--help` 顯示關于vacuumdb命令行參數的幫助然后退出。 vacuumdb還接受下列命令行參數作為連接參數： `-h` `_host_` `--host=``_host_` 指定運行服務器的主機名。如果數值以斜杠開頭，則被用作到 Unix 域套接字的路徑。 `-p` `_port_` `--port=``_port_` 指定服務器正在偵聽的 TCP 端口或本地 Unix 域套接字文件的擴展(描述符)。 `-U` `_username_` `--username=``_username_` 連接的用戶名。 `-w` `--no-password` 從不發出密碼提示問題。如果服務器要求密碼認證并且密碼不可用于其他意思如 `.pgpass`文件，則連接嘗試將會失敗。該選項在批量工作和不存在用戶輸入密碼的腳本中很有幫助。 `-W` `--password` 強制vacuumdb在連接到數據庫之前提示一個密碼。這個選項從來不是至關重要的，因為如果服務器需求密碼認證，則vacuumdb 自動提示一個密碼。不過，vacuumdb 將在找出服務器想要一個密碼上浪費一個連接嘗試。在某些情況下，值得輸入`-W` 以避免額外的連接嘗試。 `--maintenance-db=``_dbname_` 指定要連接到的數據庫的名字以發現其他應該清理的數據庫。如果沒有指定，那么將使用`postgres`數據庫，如果該數據庫不存在，則使用`template1`。 ## 環境變量 `PGDATABASE` `PGHOST` `PGPORT` `PGUSER` 缺省連接參數這個工具，類似大多數其他PostgreSQL實用工具，也使用由libpq支持的環境變量（參閱[Section 31.14](#calibre_link-39)）。 ## 診斷如果出差錯了。參閱[VACUUM](#calibre_link-748)和[psql](#calibre_link-23) 獲取關于錯誤信息和可能問題的詳細描述。數據庫服務器必須在目標主機上運行。同樣，任何libpq前端庫可獲得的缺省設置和環境變量都將生效。 ## 注意 vacuumdb可能需要與PostgreSQL 服務器連接若干次，每次都詢問口令。在這種情況下，設立一個`~/.pgpass` 文件是比較方便的。參閱[Section 31.15](#calibre_link-457)獲取更多信息。 ## 例子整理數據庫`test`： ``` <samp class="literal">$</samp> <kbd class="literal">vacuumdb test</kbd> ``` 為優化器清理和分析一個名為`bigdb`的數據庫： ``` <samp class="literal">$</samp> <kbd class="literal">vacuumdb --analyze bigdb</kbd> ``` 清理數據庫`xyzzy`中名為`foo`的表，并且為優化器分析列`bar`： ``` <samp class="literal">$</samp> <kbd class="literal">vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy</kbd> ``` ## 又見 [VACUUM](#calibre_link-748)