reindexdb · PostgreSQL 中文文檔 9.3

# reindexdb ## Name reindexdb?--?重建PostgreSQL數據庫索引 ## Synopsis `reindexdb` [`_connection-option_`...] [ `--table` | `-t` `_table_` ] ... [ `--index` | `-i` `_index_` ] ... [`_dbname_`] `reindexdb` [`_connection-option_`...] `--all` | `-a` `reindexdb` [`_connection-option_`...] `--system` | `-s` [`_dbname_`] ## 描述 reindexdb是一個重建數據庫索引的工具。 reindexdb是 SQL 命令[REINDEX](#calibre_link-614)的包裝。因此，用哪種方法重建索引都一樣。 ## 選項 reindexdb accepts the following command-line arguments: reindexdb接受下列命令行參數： `-a``--all` 對所有數據庫重建索引。 `[-d]` `_dbname_` `[--dbname=]``_dbname_` 指定要重建索引的數據庫的名字。如果沒有指定并且也沒有使用`-a` （或`--all`），那么數據庫名從環境變量`PGDATABASE` 中讀取。如果沒有設置環境變量，那么就使用連接使用的用戶名。 `-e` `--echo` 回顯reindexdb生成并發送給數據庫的命令。 `-i` `_index_` `--index=``_index_` 僅對`_index_`索引進行重建。可以通過寫多個`-i`選項重建多個索引。 `-q` `--quiet` 不顯示進程信息。 `-s` `--system` 對數據庫的系統表重建索引。 `-t` `_table_` `--table=``_table_` 僅對`_table_`表重建索引。可以通過寫多個`-t`選項給多個表重建索引。 `-V` `--version` 打印reindexdb的版本然后退出。 `-?` `--help` 顯示關于reindexdb命令行參數的幫助然后退出。 reindexdb還接受下列命令行參數作為連接參數： `-h` `_host_` `--host=``_host_` 指定運行服務器的主機名。如果數值以斜杠開頭，則被用作到 Unix 域套接字的路徑。 `-p` `_port_` `--port=``_port_` 指定服務器正在偵聽的 TCP 端口或本地 Unix 域套接字文件的擴展(描述符)。 `-U` `_username_` `--username=``_username_` 連接的用戶名。 `-w` `--no-password` 從不發出密碼提示問題。如果服務器要求密碼認證并且密碼不可用于其他意思如 `.pgpass`文件，則連接嘗試將會失敗。該選項在批量工作和不存在用戶輸入密碼的腳本中很有幫助。 `-W` `--password` 強制reindexdb在連接到數據庫之前提示一個密碼。這個選項從來不是至關重要的，因為如果服務器需求密碼認證，則reindexdb 自動提示一個密碼。不過，reindexdb 將在找出服務器想要一個密碼上浪費一個連接嘗試。在某些情況下，值得輸入`-W` 以避免額外的連接嘗試。 `--maintenance-db=``_dbname_` 指定要連接到的數據庫的名字以發現其他應該重建索引的數據庫。如果沒有指定，那么將使用`postgres`數據庫，如果該數據庫不存在，則使用`template1`。 ## 環境變量 `PGDATABASE` `PGHOST` `PGPORT` `PGUSER` 缺省連接參數這個功用，類似大多數其他PostgreSQL實用工具，也使用由libpq支持的環境變量（參閱[Section 31.14](#calibre_link-39)）。 ## 診斷如果遇到麻煩，參閱[REINDEX](#calibre_link-614)和[psql](#calibre_link-23) 獲取潛在問題和錯誤信息的論述。數據庫服務器必須在目標主機上運行。同樣，任何libpq前端庫可獲得的缺省設置和環境變量都將生效。 ## 注意 reindexdb可能需要多次連接PostgreSQL 服務器，且每次都詢問密碼。此時使用`~/.pgpass`文件將會很方便。參見[Section 31.15](#calibre_link-457)獲取更多信息。 ## 例子重建數據庫`test`中的所有索引： ``` <samp class="literal">$</samp> <kbd class="literal">reindexdb test</kbd> ``` 重建數據庫`abcd`中名為`foo`的表上的`bar`索引： ``` <samp class="literal">$</samp> <kbd class="literal">reindexdb --table foo --index bar abcd</kbd> ``` ## 又見 [REINDEX](#calibre_link-614)