PostgreSQL pg_dumpall

只轉儲數(shù)據(jù)，不轉儲模式（數(shù)據(jù)定義）。

包括在重建數(shù)據(jù)庫之前清除（移除）它們的 SQL 命令。角色和表空間的DROP命令也會被加入進來。

用指定的字符集編碼創(chuàng)建轉儲。默認情況下，轉儲使用數(shù)據(jù)庫的編碼創(chuàng)建（另一種得到相同結果的方法是設置PGCLIENTENCODING環(huán)境變量為想要的轉儲編碼）。

將輸出發(fā)送到指定的文件中。如果省略，將使用標準輸出。

只轉儲全局對象（角色和表空間），而不轉儲數(shù)據(jù)庫。

不輸出用于設置對象所有權以符合原始數(shù)據(jù)庫的命令。默認情況下，pg_dumpall發(fā)出ALTER OWNER或SET SESSION AUTHORIZATION語句來設置被創(chuàng)建的模式元素的所有權。除非腳本是由一個超級用戶（或者是擁有腳本中所有對象的同一個用戶）所運行，這些語句在腳本運行時會失敗。要使得一個腳本能被任意用戶恢復，但又不想給予該用戶所有對象的所有權，可以指定 -O。

只轉儲角色，不轉儲數(shù)據(jù)庫和表空間。

只轉儲對象定義（模式），不轉儲數(shù)據(jù)。

指定要在禁用觸發(fā)器時使用的超級用戶的用戶名。只有使用--disable-triggers時，這個選項才相關（通常，最好省去這個選項，而作為超級用戶來啟動結果腳本來取而代之）。

只轉儲表空間，不轉儲數(shù)據(jù)庫和角色。

指定細節(jié)模式。這將導致pg_dumpall向標準錯誤輸出詳細的對象注釋以及轉儲文件的開始/停止時間，還有進度消息。它也會啟用pg_dump中的細節(jié)輸出。

打印pg_dumpall版本并退出。

防止轉儲訪問特權（授予/收回命令）。

這個選項用于就地升級功能。我們不推薦也不支持把它用于其他目的。這個選項在未來的發(fā)行中可能被改變而不做通知。

將數(shù)據(jù)轉儲為帶有顯式列名的INSERT命令（INSERT INTO table (column, ...) VALUES ...）。這將使得恢復過程非常慢，這主要用于使轉儲能夠被載入到非PostgreSQL數(shù)據(jù)庫中。

這個選項禁止在函數(shù)體中使用美元符號引用，并且強制它們使用 SQL 標準字符串語法被引用。

只有在創(chuàng)建一個只轉儲數(shù)據(jù)的轉儲時，這個選項才相關。它指示pg_dumpall包括在數(shù)據(jù)被重新載入時能夠臨時禁用目標表上的觸發(fā)器的命令。如果你在表上有引用完整性檢查或其他觸發(fā)器，并且你在數(shù)據(jù)重新載入期間不想調用它們，請使用這個選項。

當前，為--disable-triggers發(fā)出的命令必須作為超級用戶來執(zhí)行。因此，你還應當使用-S指定一個超級用戶名，或者寧可作為一個超級用戶啟動結果腳本。

不要轉儲名字與 pattern 匹配的數(shù)據(jù)庫?？梢酝ㄟ^編寫多個--exclude-database開關來排除多個模式。 pattern參數(shù)被解釋為模式，根據(jù)psql的\d命令使用的相同規(guī)則 (請參見下面的 Patterns)，因此，通過在模式中編寫通配符也可以排除多個數(shù)據(jù)庫。 使用通配符時，請謹慎的引用模式，如果需要防止shell通配符擴展。

在轉儲浮點數(shù)據(jù)時使用extra_float_digits規(guī)定的值，而不是最大可用精度。備份目的進行的常規(guī)轉儲不使用此選項。

時間條件性命令（即增加一個IF EXISTS子句）來清除數(shù)據(jù)庫和其他對象。 只有同時指定了--clean時，這個選項才可用。

將數(shù)據(jù)轉儲為INSERT命令（而不是COPY）。這將使得恢復非常慢，這主要用于使轉儲能夠被載入到非PostgreSQL數(shù)據(jù)庫中。注意如果你已經(jīng)重新安排了列序，該恢復可能會一起失敗。--column-inserts選項對于列序改變是安全的，但是會更慢。

在為一個分區(qū)表轉儲數(shù)據(jù)時，讓COPY語句或者INSERT語句把包含它的分區(qū)層次的根而不是分區(qū)自身作為目標。這導致在數(shù)據(jù)被裝載時，會為每一個行重新確定合適的分區(qū)。如果在一臺服務器上重新裝載數(shù)據(jù)時會出現(xiàn)行并不是總是落入到和原始服務器上相同的分區(qū)中的情況，這個選項就很有用。例如，如果分區(qū)列是文本類型并且兩個系統(tǒng)中用于排序分區(qū)列的排序規(guī)則有著不同的定義，就會發(fā)生這種情況。

在轉儲的開始從不等待共享表鎖的獲得。而是在指定的timeout內不能鎖定一個表時失敗。超時時長可以用SET statement_timeout接受的任何格式指定（允許的值根據(jù)你從其轉出的服務器版本變化，但是從 7.3 以來的所有版本都接受一個整數(shù)表示的毫秒數(shù)。如果從 7.3 以前的服務器轉出，這個選項會被忽略。）。

不轉儲注釋。

不轉儲publication。

不為角色轉儲口令。在恢復完后，角色的口令將是空口令，并且在設置口令之前口令認證都不會成功。由于指定這個選項時并不需要口令值，角色信息將從目錄視圖pg_roles而不是pg_authid中讀出。因此，如果對pg_authid的訪問被某條安全性策略所限制，那么這個選項也會有所幫助。

不轉儲安全標簽。

不轉儲subscription。

默認情況下，pg_dumpall將等待所有文件被安全地寫入到磁盤。這個選項會讓pg_dumpall不做這種等待而返回，這樣會更快，但是意味著后續(xù)的操作系統(tǒng)崩潰可能留下被損壞的轉儲。通常來說，這個選項對測試有用，但不應該在從生產(chǎn)安裝中轉儲數(shù)據(jù)時使用。

不要輸出選擇表空間的命令。通過這個選項，在恢復期間所有的對象都會被創(chuàng)建在任何作為默認的表空間中。

不轉儲非日志記錄表的內容。這個選項對于表定義（模式）是否被轉儲沒有影響，它只會限制轉儲表數(shù)據(jù)。

添加ON CONFLICT DO NOTHING到INSERT命令。 除非--inserts或--column-inserts也被規(guī)定，否則此選項不生效。

強制引用所有標識符。在從一個與pg_dumpall主版本不同的PostgreSQL服務器轉儲數(shù)據(jù)庫時或者要將輸出載入到一個不同主版本的服務器時，推薦使用這個選項。默認情況下，pg_dumpall只會對為其主版本中保留詞的標識符加上引號。在與其他版本的具有不同保留詞集合的服務器交互時，這有時會導致兼容性問題。使用 --quote-all-identifiers可以阻止這類問題，但是代價是轉儲腳本會更加難讀。

將數(shù)據(jù)轉儲為INSERT命令（而不是COPY）?？刂泼總€INSERT命令的最大行數(shù)。 指定的值必須是大于零的數(shù)。重新加載期間的任何錯誤都將導致僅丟失有問題的INSERT的行，而不是整個表內容。

輸出 SQL-標準的SET SESSION AUTHORIZATION命令取代ALTER OWNER命令來確定對象的所有關系。這讓該轉儲更加兼容標準，但是取決于該轉儲中對象的歷史，該轉儲可能無法正常恢復。

顯示有關pg_dumpall命令行參數(shù)的幫助并退出。

指定用于連接到服務器的參數(shù)，比如連接字符串；這些將覆蓋所有沖突的命令行選項。

這個選項被稱為--dbname是為了和其他客戶端應用一致，但是因為pg_dumpall需要連接多個數(shù)據(jù)庫，連接字符串中的數(shù)據(jù)庫名將被忽略。使用-l選項指定一個數(shù)據(jù)庫，該數(shù)據(jù)庫被用于初始連接，這將轉儲全局對象并且發(fā)現(xiàn)需要轉儲哪些其他數(shù)據(jù)庫。

指定服務器正在運行的機器的主機名。如果該值開始于一個斜線，它被用作一個 Unix 域套接字的目錄。默認是從PGHOST環(huán)境變量中取得（如果被設置），否則將嘗試一次 Unix 域套接字連接。

指定要連接到哪個數(shù)據(jù)庫轉儲全局對象以及發(fā)現(xiàn)要轉儲哪些其他數(shù)據(jù)庫。如果沒有指定，將會使用postgres數(shù)據(jù)庫，如果postgres不存在，就使用 template1。

指定服務器正在監(jiān)聽連接的 TCP 端口或本地 Unix 域套接字文件擴展名。默認是放在PGPORT環(huán)境變量中（如果被設置），否則使用編譯在程序中的默認值。

要作為哪個用戶連接。

從不發(fā)出一個口令提示。如果服務器要求口令認證并且沒有其他方式提供口令（例如一個.pgpass文件），那兒連接嘗試將失敗。這個選項對于批處理任務和腳本有用，因為在其中沒有一個用戶來輸入口令。

強制pg_dumpall在連接到一個數(shù)據(jù)庫之前提示要求一個口令。

這個選項從來不是必須的，因為如果服務器要求口令認證，pg_dumpall將自動提示要求一個口令。但是，pg_dumpall將浪費一次連接嘗試來發(fā)現(xiàn)服務器想要一個口令。在某些情況下，值得鍵入-W來避免額外的連接嘗試。

注意對每個要被轉儲的數(shù)據(jù)庫，口令提示都會再次出現(xiàn)。通常，最好設置一個~/.pgpass文件來減少手工口令輸入。

指定一個用來創(chuàng)建該轉儲的角色名。這個選項導致pg_dump在連接到數(shù)據(jù)庫后發(fā)出一個SET ROLE rolename命令。當已認證用戶（由-U指定）缺少pg_dump所需的特權但是能夠切換到一個具有所需權利的角色時，這個選項很有用。一些安裝有針對直接作為超級用戶登錄的策略，使用這個選項可以讓轉儲在不違反該策略的前提下完成。

默認連接參數(shù)

規(guī)定在診斷消息中是否使用顏色。可能的值為always、 auto、never。