NAME¶

SYNOPSIS¶

DESCRIPTION 描述¶

因此，pg_dumpall 是備份你的數據庫的一體化解決方案。 但是請注意它的侷限性：它無法轉儲"大對象"，因爲 pg_dump 無法把這樣的對象轉儲到純文本文件中。如果你的數據庫裏有大對象， 那麼你應該使用 pg_dump 的非文本輸出格式之一轉儲它們。

因爲 pg_dumpall 從所有數據庫中讀取表， 所以你很可能需要以數據庫超級用戶的身份聯接，這樣才能生成完整的轉儲。 同樣，你也需要超級用戶的權限執行保存下來的腳本，這些才能增加用戶和組， 以及創建數據庫。

SQL腳本將寫出到標準輸出。你應該使用合適的 shell 操作符把它重定向到文件。

pg_dumpall 需要和 PostgreSQL 服務器連接多次，可能每次都問你口令。這種情況下寫一個 $HOME/.pgpass 可能會比較方便。

OPTIONS 選項¶

-a

--data-only

只轉儲數據，不轉儲模式（數據定義）。

-c

--clean

包括那些重建之前清理（刪除）數據庫對象的SQL命令。

-d

--inserts

把數據當作 INSERT 命令輸出（而不是 COPY）。這樣將令恢復過程非常緩慢， 但是會令輸出更容易移植到其他 SQL 數據庫包中。

-D

--column-inserts

--attribute-inserts

把數據以某種帶着明確字段名（INSERT INTO table (column, ...) VALUES ...）的 INSERT 命令形式轉儲出來。 這樣會令恢復非常慢，但是如果需要重排字段順序就是必須的。

-g

--globals-only

只轉儲全局對象（用戶和組），而不轉儲數據庫。

-i

--ignore-version

忽略 pg_dumpall 和數據庫服務器之間的版本差別。

pg_dumpall 可以處理來自以前版本的 PostgreSQL 的數據庫，但是太老的數據庫就不再支持了（目前到 7.0）。 如果你需要覆蓋版本檢查，那麼可以使用這個選項（如果 pg_dumpall 失敗了，可別說我們沒警告你。）

-o

--oids

爲每個錶轉儲對象標識符（OID）。 如果你的應用在某種角度引用了 OID 字段，那麼使用這個選項 （比如，在外鍵約束裏）。否則，不應該使用這個選項。

-s

--schema-only

只轉儲模式（數據定義），不轉儲數據。

-v

--verbose

聲明冗餘模式。這樣將令 pg_dumpall 向標準錯誤打印進度信息。

-x

--no-privileges

--no-acl

避免轉儲訪問權限（授權/撤銷命令）。

下面的命令行參數控制數據庫連接參數。

-h host

聲明數據庫服務器所運行的機器的主機名。 如果數值以斜扛開頭，那麼就把它用做 Unix 域套接字的目錄。 缺省是從 PGHOST 環境變量裏拿來的（如果設置了）， 否則使用 Unix 域套接字。

-p port

聲明服務器監聽的 TCP 端口號或者 Unix 域套接字文件擴展。 缺省是 PGPORT 環境變量（如果設置了）， 或者是編譯時的缺省。

-U username

以給定用戶身分聯接。

-W

強制口令提示。如果服務器需要口令認證，那麼這個動作應該自動發生。

ENVIRONMENT 環境¶

PGHOST

PGPORT

PGUSER

缺省連接參數。

NOTES 注意¶

恢復完之後，我們建議在每個已恢復的對象上運行 ANALYZE。 這樣優化器就可以得到有用的統計。 你也可以用 vacuumdb -a -z 清理所有數據庫。

EXAMPLES 例子¶

$ pg_dumpall > db.out

重新載入這個數據庫：

$ psql -f db.out template1

SEE ALSO 參見¶

譯者¶

跋¶