PG_DUMP(1) | PostgreSQL Client Applications | PG_DUMP(1) |
pg_dump - 將一個PostgreSQL數據庫抽出到一個腳本文件或者其它歸檔文件中
pg_dump [ option... ] [ dbname ]
pg_dump 是一個用於備份 PostgreSQL 數據庫的工具。它甚至可以在數據庫正在併發使用的時候進行完整一致的備份。 pg_dump 並不阻塞其它用戶對數據庫的訪問(讀或者寫)。
轉儲格式可以是一個腳本或者歸檔文件。
這個腳本文件的格式是純文本,它包含許多
SQL 命令, 這些 SQL
命令可以用於重建該數據庫並將之恢復到保存成腳本的時候的狀態。
要恢復這些腳本,使用
psql(1)。
它們甚至可以用於在其它機器甚至是其它硬件體系的機器上重建該數據庫,
通過對腳本進行一些修改,甚至可以在其它
SQL
數據庫產品上重建該數據庫。
另外,還有候選的歸檔文件格式可以和
pg_restore(1)
一起使用重建數據庫,
並且它們也允許
pg_restore(1)
對恢復什麼東西進行選擇,
或者甚至是在恢復之前對需要恢復的條目進行重新排序。
歸檔文件也是設計成可以跨平臺移植的。
如果一種候選文件格式和
pg_restore(1)
結合,那麼pg_dump就能提供一種靈活的歸檔和傳輸機制。
pg_dump
可以用於備份整個數據庫,
然後就可以使用 pg_restore
檢查這個歸檔和/或選擇要恢復的數據庫部分。
最靈活等輸出文件格式是
``custom(客戶化)''
格式(-Fc)。
它允許對歸檔元素進行選取和重新排列,
並且缺省時是壓縮的。tar
格式(-Ft)不是壓縮的並且我們在裝載等時候不可能重排列,
不過它也很靈活;還有,它可以用其它工具,比如
tar 處理。
在運行 pg_dump
的時候,我們應該檢查輸出,
看看是否有任何警告存在(在標準錯誤上打印),特別是下面列出的限制。
下面的命令行參數用於控制輸出格式。
這個選項只是對純文本格式有意義。對於其它格式,你可以在調用
pg_restore
的時候聲明選項。
這個選項只是對純文本格式有意義。對於其它格式,你可以在調用
pg_restore
的時候聲明選項。
這個選項只對純文本格式有意義。對於其它格式,你可以在調用
pg_restore
的時候聲明該選項。
pg_dump 可以處理來自以前版本的PostgreSQL 的數據庫,但是太老的版本則不被支持了(目前是支持到 7.0)。 如果你需要跨越版本檢查時才使用這個選項( 而且如 pg_dump 失效,別說我沒警告你)。
這個選項只是對純文本格式有意義。對於其它格式,在你調用
pg_restore
的時候你可以聲明該選項。
目前,爲 --disable-triggers
發出的命令必須用超級用戶來做。
因此,你應該同時用
-S
聲明一個超級用戶名,或者最好是用一個超級用戶的身份來啓動這個生成的腳本。
這個選項只對純文本格式有意義。對於其它格式,你可以在調用
pg_restore
的時候聲明這個選項。
下面的命令行參數控制數據庫爲聯接參數。
pg_dump 在內部使用 SELECT 語句。如果你運行 pg_dump 時碰到問題,確認你能夠使用象 psql(1) 這樣的程序從數據庫選取信息。
如果你的數據庫給template1數據庫增加了任何你自己的東西, 那麼請注意把 pg_dump 的輸出恢復到一個真正空的數據庫中; 否則你可能會收到因爲重複定義所追加的對象而造成的錯誤信息。要製作一個沒有任何本地附屬物的數據庫, 可以從template0而不是template1拷貝,比如:
CREATE DATABASE foo WITH TEMPLATE template0;
pg_dump 有幾個限制:
tar
歸檔的成員的大小限制於
8 GB。(這個限制是 tar
文件格式的固有限制。)
因此這個格式無法用於那些一個表的大小超過這個尺寸的原文表現。
tar
歸檔和任何其它輸出格式的總大小是不受限制的,只是可能會又操作系統的限制。
恢復完之後,我們建議在每個已恢復的對象上運行
ANALYZE。
這樣優化器就可以得到有用的統計。
轉儲一個數據庫:
$ pg_dump mydb > db.out
重載這個數據庫:
$ psql -d database -f db.out
輸出一個叫 mydb 的包含BLOB
的數據庫到一個 tar
文件:
$ pg_dump -Ft -b mydb > db.tar
把這個數據庫(連同BLOB)一起恢復到一個現有的叫
newdb 的數據庫:
$ pg_restore -d newdb db.tar
pg_dump 工具最早出現在 Postgres95 版本 0.02。 非純文本輸出格式在 PostgreSQL 版本 7.1 時引入。
Postgresql 中文網站 何偉平 <laser@pgsqldb.org>
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
2003-11-02 | Application |