.\" auto-generated by docbook2man-spec $Revision: 1.1 $
.TH "VACUUMDB" "1" "2003-11-02" "Application" "PostgreSQL Client Applications"
.SH NAME
vacuumdb \- 收集垃圾並且分析一個PostgreSQL 數據庫

.SH SYNOPSIS
.sp
\fBvacuumdb\fR\fR [ \fR\fB\fIconnection-option\fB\fR...\fB \fR\fR]\fR \fR[\fR \fB--full\fR\fR | \fR\fB-f\fR\fR ]\fR \fR[\fR \fB--verbose\fR\fR | \fR\fB-v\fR\fR ]\fR \fR[\fR \fB--analyze\fR\fR | \fR\fB-z\fR\fR ]\fR\fR [ \fR\fB--table | -t \fItable\fB\fR [ \fB( \fIcolumn\fB [,...] ) \fR]\fB \fR\fR]\fR\fR [ \fR\fB\fIdbname\fB \fR\fR]\fR

\fBvacuumdb\fR\fR [ \fR\fB\fIconnection-options\fB\fR...\fB \fR\fR]\fR \fR[\fR \fB--all\fR\fR | \fR\fB-a\fR\fR ]\fR \fR[\fR \fB--full\fR\fR | \fR\fB-f\fR\fR ]\fR \fR[\fR \fB--verbose\fR\fR | \fR\fB-v\fR\fR ]\fR \fR[\fR \fB--analyze\fR\fR | \fR\fB-z\fR\fR ]\fR
.SH "DESCRIPTION 描述"
.PP
\fBvacuumdb\fR 是一個用於整理 PostgreSQL 數據庫的工具。 vacuumdb 還將會生成用於 PostgreSQL 查詢優化器的內部統計數據。
.PP
\fBvacuumdb\fR 是 SQL 命令 VACUUM [\fBvacuum\fR(7)] 的封裝。 因此，用哪種方法清理數據庫都沒什麼特別的。
.SH "OPTIONS 選項"
.PP
\fBvacuumdb\fR 接受下列命令行參數：
.TP
\fB-a\fR
.TP
\fB--all\fR
 清理所有數據庫。
.TP
\fB[-d] \fIdbname\fB\fR
.TP
\fB[--dbname] \fIdbname\fB\fR
 聲明要被清理或分析的數據庫名稱。 如果沒有聲明這個參數並且沒有使用 -a（或 --all）， 那麼從環境變量 PGDATABASE 裏讀取數據庫名。 如果那個也沒有設置，則使用連接的用戶名。
.TP
\fB-e\fR
.TP
\fB--echo\fR
 回顯 vacuumdb 生成的查詢並且把它發送到服務器。
.TP
\fB-f\fR
.TP
\fB--full\fR
 執行"完全"清理．
.TP
\fB-q\fR
.TP
\fB--quiet\fR
 不顯示響應。
.TP
\fB-t \fItable\fB [ (\fIcolumn\fB [,...]) ]\fR
.TP
\fB--table \fItable\fB [ (\fIcolumn\fB [,...]) ]\fR
 只是清理或分析 table。 字段名稱只是在與 --analyze 選項聯合使用時才需要聲明。
.sp
.RS
.B "Tip:"
提示:  如果你聲明瞭要清理的字段，你可能不得不在 shell 上逃逸圓括弧（見下面的例子）。
.RE
.sp
.TP
\fB-v\fR
.TP
\fB--verbose\fR
 在處理過程中打印詳細信息。
.TP
\fB-z\fR
.TP
\fB--analyze\fR
 計算用於優化器的該數據庫的統計值。
.PP
.PP
\fBvacuumdb\fR 還接受下面的命令行參數用於聯接參數：
.TP
\fB-h \fIhost\fB\fR
.TP
\fB--host \fIhost\fB\fR
 聲明運行服務器的機器的主機名。 如果主機名以斜扛開頭，則它被用做到 Unix 域套接字的路徑。
.TP
\fB-p \fIport\fB\fR
.TP
\fB--port \fIport\fB\fR
 聲明服務器在偵聽聯接的 TCP 端口號或一個本地的 Unix 域套接字文件句柄。
.TP
\fB-U \fIusername\fB\fR
.TP
\fB--username \fIusername\fB\fR
 進行聯接的用戶名。
.TP
\fB-W\fR
.TP
\fB--password\fR
 強制口令輸入提示。
.PP
.SH "ENVIRONMENT 環境"
.TP
\fBPGDATABASE\fR
.TP
\fBPGHOST\fR
.TP
\fBPGPORT\fR
.TP
\fBPGUSER\fR
 缺省連接參數
.SH "DIAGNOSTICS 診斷"
.PP
 如果出差錯了。參閱 VACUUM [\fBvacuum\fR(7)]  和 \fBpsql\fR(1)  獲取關於錯誤信息和可能問題的詳細描述。 數據庫服務器必須在目標主機上運行。同時，前端庫 libpq 使用的任何缺省連接設置和環境變量都適用。
.SH "NOTES 注意"
.PP
\fBvacuumdb\fR 可能需要與 PostgreSQL  服務器連接若干次，每次都詢問口令。在這種情況下，設立一個 \fI$HOME/.pgpass\fR  是比較方便的。參閱 Section 27.11 獲取更多信息。
.SH "EXAMPLES 例子"
.PP
 整理數據庫 test：
.sp
.nf
$ \fBvacuumdb test\fR
.sp
.fi
.PP
 爲優化器清理和分析一個名爲 bigdb 的數據庫：
.sp
.nf
$ \fBvacuumdb --analyze bigdb\fR
.sp
.fi
.PP
 爲清理數據庫xyzzy裏表 foo， 並且爲優化器分析列 bar：
.sp
.nf
$ \fBvacuumdb --analyze --verbose --table 'foo(bar)' xyzzy\fR
.sp
.fi
.SH "SEE ALSO 參見"
VACUUM [\fBvacuum\fR(7)]

.SH "譯者"
.B Postgresql 中文網站
.B 何偉平 <laser@pgsqldb.org>
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR