pg_dumpall工具可以一個集簇中所有的PostgreSQL數據庫轉儲到一個腳本文件。該腳本文件包含可以用作`psql`的輸入SQL命令來恢復數據庫。它會對集簇中的每個數據庫調用`pg_dump`。        pg_dumpall還轉儲對所有數據庫公用的全局對象（`pg_dump`不保存這些對象），也就是說數據庫角色和表空間都會被轉儲。 **命令格式：** pg_dumpall [OPTION]... > **General options:：** >* **\-f, --file=FILENAME**：指定導出到指定文件的文件名 >* **-v, --verbose**：指定詳情模式。這將導致pg_dumpall向標準錯誤輸出詳細的對象注釋以及轉儲文件的開始/停止時間，還有進度消息 >* **\-V, --version**：打印版本 >* **\--lock-wait-timeout=TIMEOUT**：在轉儲的開始從不等待共享表鎖的獲得。而是在指定的`timeout`內不能鎖定一個表時失敗。超時時長可以用`SET statement_timeout`接受的任何格式指定 >* **\-?, --help**：顯示幫助信息并退出 > > **Options controlling the output content：** >* **-a, --data-only**：只轉儲數據，不轉儲模式（數據定義） >* **-c, --clean**：包括在重建數據庫之前清除（移除）它們的 SQL 命令。角色和表空間的`DROP`命令也會被加入進來 >* **-E, --encoding=ENCODING**：以指定的字符集編碼創建轉儲。在默認情況下，該轉儲會以該數據庫的編碼創建 >* **-g, --globals-only**：只轉儲全局對象（角色和表空間），而不轉儲數據庫 >* **-O, --no-owner**：默認情況下，pg\_dumpall發出`ALTER OWNER`或`SET SESSION AUTHORIZATION`語句來設置被創建的模式元素的所有權。除非腳本是由一個超級用戶（或者是擁有腳本中所有對象的同一個用戶）所運行，這些語句在腳本運行時會失敗。要使得一個腳本能被任意用戶恢復，但又不想給予該用戶所有對象的所有權，可以指定`-O` >* **-r, --roles-only**：只轉儲角色，不轉儲數據庫和表空間 >* **-s, --schema-only**：只轉儲對象定義（模式），不轉儲數據。 >* **-S, --superuser=NAME**：指定要在禁用觸發器時使用的超級用戶的用戶名。只有使用`--disable-triggers`時，這個選項才有效 >* **-t, --tablespaces-only**：只轉儲表空間，不轉儲數據庫和角色 >* **-x, --no-privileges**：不轉儲權限命令(grant/revoke) >* **--binary-upgrade**：這個選項僅用于升級功能 >* **--column-inserts**：該選項為表數據每一行生成**具有列名的INSERT命令**，當數據庫恢復時遇到一行錯誤時，它只會導致錯誤的這一行數據丟失，而不是全部數據。 >* **--disable-dollar-quoting**：這個選項禁止在函數體中使用美元符號引用，并且強制它們使用 SQL 標準字符串語法被引用 >* **--disable-triggers**：只有在只轉儲數據時，這個選項才有效。它指示pg\_dumpall包括在數據被重新載入時能夠臨時禁用目標表上的觸發器的命令。如果你在表上有引用完整性檢查或其他觸發器，并且你在數據重新載入期間不想調用它們，請使用這個選項。 >* **--exclude-database=PATTERN**：不轉儲名字與*`pattern`*匹配的數據庫。可以通過編寫多個`--exclude-database`開關來排除多個模式 >* **--extra-float-digits=NUM**：在轉儲浮點數據時使用extra\_float\_digits規定的值，而不是最大可用精度 >* **--if-exists**：在轉儲的語句中增加一個`IF EXISTS`子句來清除數據庫和其他對象。 只有同時指定了`--clean`時，這個選項才可用 >* **--inserts**：將數據轉儲為`INSERT`命令（而不是`COPY`） >* **--load-via-partition-root**：在為一個分區表轉儲數據時，讓`COPY`語句或者`INSERT`語句將根表作為目標，在數據被裝載時，會為每一個行重新確定合適的分區 >* **--no-comments**：不轉儲注釋 >* **--no-publications**：不轉儲publication >* **--no-role-passwords**：不為角色轉儲口令。在恢復完后，角色的口令將是空口令，并且在設置口令之前口令認證都不會成功。由于指定這個選項時并不需要口令值，角色信息將從目錄視圖`pg_roles`而不是`pg_authid`中讀出。因此，如果對`pg_authid`的訪問被某條安全性策略所限制，那么這個選項也會有所幫助。 >* **--no-security-labels**：不轉儲安全標簽 >* **--no-subscriptions**：不轉儲subscription >* **--no-sync**：默認情況下，`pg_dumpall`將等待所有文件被安全地寫入到磁盤。這個選項會讓`pg_dumpall`不做這種等待而返回，這樣會更快，但是意味著后續的操作系統崩潰可能留下被損壞的轉儲 >* **--no-tablespaces**：不轉儲表空間，通過這個選項，在恢復期間所有的對象都會被創建在任何作為默認的表空間中 >* **--no-unlogged-table-data**：不轉儲未標記的表數據 >* **--on-conflict-do-nothing**：添加`ON CONFLICT DO NOTHING`到`INSERT`命令。 除非`--inserts`或`--column-inserts`也被設置，否則此選項不生效。 >* **--quote-all-identifiers**：強制引用所有標識符。默認情況下，pg\_dumpall只會對為其主版本中保留詞的標識符加上引號。在與其他版本的具有不同保留詞集合的服務器交互時，這有時會導致兼容性問題。使用`--quote-all-identifiers`可以阻止這類問題，但是代價是轉儲腳本會更加難讀。 >* **--rows-per-insert=NROWS**：將數據轉儲為`INSERT`命令（而不是`COPY`）。控制每個`INSERT`命令的最大行數。 指定的值必須是大于零的數。重新加載期間的任何錯誤都將導致僅丟失有問題的`INSERT`的行，而不是整個表內容。 >* **\--use-set-session-authorization**：輸出 SQL-標準的`SET SESSION AUTHORIZATION`命令取代`ALTER OWNER`命令來確定對象的所有關系。這讓該轉儲更加兼容標準，但是取決于該轉儲中對象的歷史，該轉儲可能無法正常恢復。而且，一個使用`SET SESSION AUTHORIZATION`的轉儲將一定會要求超級用戶特權來正確地恢復，而`ALTER OWNER`要求更少的特權 > > **Connection options：** >* **-d, --dbname=CONNSTR**：指定用于連接到服務器的參數，比如連接字符串 >* **-h, --host=HOSTNAME**：指定服務器正在運行的機器的主機名 >* **-l, --database=DBNAME**：指定要連接到哪個數據庫轉儲全局對象以及發現要轉儲哪些其他數據庫。如果沒有指定，將會使用`postgres`數據庫，如果`postgres`不存在，就使用`template1`。 >* **-p, --port=PORT**：指定端口 >* **-U, --username=NAME**：指定用戶連接 >* **-w, --no-password**：不提示輸入密碼 >* **-W, --password**：強制提示密碼輸入 >* **--role=ROLENAME**：指定一個用來創建該轉儲的角色名。這個選項導致pg\_dump在連接到數據庫后發出一個`set role rolename`命令