指定要轉儲的資料庫名稱。如果未指定，則使用環境變數 PGDATABASE。如果該變數未設定，則使用連線指定的使用者名稱稱。

僅轉儲資料，而不轉儲模式（資料定義）或統計資訊。轉儲表資料、大物件和序列值。

此選項與指定 --section=data 類似，但由於歷史原因並不完全相同。

在轉儲中包含大物件。這是預設行為，除非指定了 --schema、--table、--schema-only、--statistics-only 或 --no-data。因此，-b 開關僅在請求了特定模式或表時用於將大物件新增到轉儲中。請注意，大物件被視為資料，因此在使用 --data-only 時會包含它們，但在使用 --schema-only 或 --statistics-only 時不會。

排除轉儲中的大物件。

當同時給出 -b 和 -B 時，行為是在轉儲資料時輸出大物件，請參閱 -b 的文件。

在輸出建立它們的命令之前，輸出用於 DROP 所有轉儲的資料庫物件的命令。當恢復時需要覆蓋現有資料庫時，此選項非常有用。如果目標資料庫中不存在任何物件，則在恢復期間將報告可忽略的錯誤訊息，除非還指定了 --if-exists。

當發出歸檔（非文字）輸出檔案時，此選項將被忽略。對於歸檔格式，可以在呼叫 pg_restore 時指定該選項。

在輸出開始時新增一個建立資料庫本身的命令，並重新連線到已建立的資料庫。（使用此形式的指令碼，在執行指令碼之前連線到目標安裝中的哪個資料庫並不重要。）如果還指定了 --clean，則指令碼將先刪除目標資料庫，然後再重新建立它，之後再重新連線。

使用 --create 時，輸出還包括資料庫的註釋（如果存在），以及特定於此資料庫的任何配置變數設定，即任何提及此資料庫的 ALTER DATABASE ... SET ... 和 ALTER ROLE ... IN DATABASE ... SET ... 命令。資料庫本身的訪問許可權也會被轉儲，除非指定了 --no-acl。

當發出歸檔（非文字）輸出檔案時，此選項將被忽略。對於歸檔格式，可以在呼叫 pg_restore 時指定該選項。

僅轉儲與 模式 匹配的擴充套件。當未指定此選項時，將轉儲目標資料庫中的所有非系統擴充套件。可以透過編寫多個 -e 開關來選擇多個擴充套件。模式 引數被解釋為與 psql 的 \d 命令使用的規則相同的模式（請參閱 模式），因此透過在模式中寫入萬用字元也可以選擇多個擴充套件。使用萬用字元時，請務必引用模式（如果需要），以防止 shell 擴充套件萬用字元。

透過 pg_extension_config_dump 註冊的任何配置關係都將包含在轉儲中，如果其擴充套件由 --extension 指定。

以指定的字元集編碼建立轉儲。預設情況下，轉儲以資料庫編碼建立。（獲得相同結果的另一種方法是將 PGCLIENTENCODING 環境變數設定為所需的轉儲編碼。）支援的編碼在 第 23.3.1 節 中描述。

將輸出傳送到指定的檔案。對於基於檔案的輸出格式，可以省略此引數，在這種情況下將使用標準輸出。但是，對於目錄輸出格式，必須提供此引數，在這種情況下，它指定目標目錄而不是檔案。在這種情況下，目錄將由 pg_dump 建立，並且必須預先不存在。

選擇輸出的格式。格式 可以是以下之一

透過同時轉儲 njobs 個表來並行執行轉儲。此選項可以減少轉儲所需的時間，但也會增加資料庫伺服器的負載。只能將此選項與目錄輸出格式一起使用，因為這是唯一允許多個程序同時寫入其資料的輸出格式。

pg_dump 將開啟 njobs + 1 個到資料庫的連線，因此請確保您的 max_connections 設定足夠高，可以容納所有連線。

在並行轉儲執行時請求資料庫物件的獨佔鎖可能會導致轉儲失敗。原因是 pg_dump 領導者程序請求要轉儲的物件上的共享鎖（ACCESS SHARE），以確保在轉儲執行時沒有人刪除它們。如果另一個客戶端隨後請求表的獨佔鎖，該鎖將不會被授予，而是排隊等待領導者程序的共享鎖被釋放。因此，對錶的任何其他訪問都將不會被授予，並將排隊在獨佔鎖請求之後。這包括嘗試轉儲表的輔助程序。在沒有任何預防措施的情況下，這會是一個經典的死鎖情況。為了檢測此衝突，pg_dump 輔助程序請求另一個共享鎖，使用 NOWAIT 選項。如果輔助程序未能獲得此共享鎖，則意味著此時必須有人請求了獨佔鎖，並且無法繼續轉儲，因此 pg_dump 別無選擇，只能中止轉儲。

要執行並行轉儲，資料庫伺服器需要支援同步快照，這是在 PostgreSQL 9.2 的主伺服器和 10 的備用伺服器中引入的功能。透過此功能，資料庫客戶端可以確保它們看到相同的資料集，即使它們使用不同的連線。pg_dump -j 使用多個數據庫連線；它使用領導者程序連線一次資料庫，併為每個輔助作業連線一次。如果沒有同步快照功能，則不能保證不同的輔助作業會在每個連線中看到相同的資料，這可能導致不一致的備份。

僅轉儲與 模式 匹配的模式；這將同時選擇模式本身及其包含的所有物件。當未指定此選項時，將轉儲目標資料庫中的所有非系統模式。可以透過編寫多個 -n 開關來選擇多個模式。模式 引數被解釋為與 psql 的 \d 命令使用的規則相同的模式（請參閱 模式），因此透過在模式中寫入萬用字元也可以選擇多個模式。使用萬用字元時，請務必引用模式（如果需要），以防止 shell 擴充套件萬用字元；請參閱下面的 示例。

不要轉儲與 模式 匹配的任何模式。模式的解釋方式與 -n 相同。-N 可以多次給出，以排除與多個模式中的任何一個匹配的模式。

當同時給出 -n 和 -N 時，行為是僅轉儲至少匹配一個 -n 開關但不匹配任何 -N 開關的模式。如果 -N 出現在沒有 -n 的情況下，那麼與 -N 匹配的模式將從正常的轉儲中排除。

不要輸出命令來設定物件的所有權以匹配原始資料庫。預設情況下，pg_dump 會發出 ALTER OWNER 或 SET SESSION AUTHORIZATION 語句來設定建立的資料庫物件的所有權。除非指令碼由超級使用者（或擁有指令碼中所有物件的同一使用者）啟動，否則執行指令碼時這些語句將失敗。要建立一個任何使用者都可以還原的指令碼，但會給予該使用者所有物件的許可權，請指定 -O。

當發出歸檔（非文字）輸出檔案時，此選項將被忽略。對於歸檔格式，可以在呼叫 pg_restore 時指定該選項。

此選項已過時，但仍接受以向後相容。

僅轉儲物件定義（模式），不轉儲資料或統計資訊。

此選項不能與 --data-only 或 --statistics-only 一起使用。它與指定 --section=pre-data --section=post-data 類似，但由於歷史原因並不完全相同。

（不要將其與 --schema 選項混淆，後者在不同含義上使用了“schema”一詞。）

要僅排除資料庫中一部分表的表資料，請參閱 --exclude-table-data。

指定在使用停用觸發器時要使用的超級使用者使用者名稱。這僅在使用了 --disable-triggers 時才相關。（通常，最好省略此項，而是以超級使用者身份啟動生成的指令碼。）

僅轉儲名稱與 模式 匹配的表。可以透過編寫多個 -t 開關來選擇多個表。模式 引數被解釋為與 psql 的 \d 命令使用的規則相同的模式（請參閱 模式），因此透過在模式中寫入萬用字元也可以選擇多個表。使用萬用字元時，請務必引用模式（如果需要），以防止 shell 擴充套件萬用字元；請參閱下面的 示例。

除了表之外，此選項還可用於轉儲匹配的檢視、物化檢視、外部表和序列的定義。它不會轉儲檢視或物化檢視的內容，並且只有在使用 --include-foreign-data 指定了相應的外部伺服器時，才會轉儲外部表的內容。

當使用 -t 時，-n 和 -N 開關無效，因為無論這些開關如何，都會轉儲由 -t 選擇的表，而不會轉儲非表物件。

不要轉儲與 模式 匹配的任何表。模式的解釋方式與 -t 相同。-T 可以多次給出，以排除與多個模式中的任何一個匹配的表。

當同時給出 -t 和 -T 時，行為是僅轉儲至少匹配一個 -t 開關但不匹配任何 -T 開關的表。如果 -T 出現在沒有 -t 的情況下，那麼與 -T 匹配的表將從正常的轉儲中排除。

指定詳細模式。這將導致 pg_dump 將詳細的物件註釋和開始/停止時間輸出到轉儲檔案，並將進度訊息輸出到標準錯誤流。重複該選項將導致額外的除錯級別訊息出現在標準錯誤流上。

列印 pg_dump 版本並退出。

阻止轉儲訪問許可權（GRANT/REVOKE 命令）。

指定要使用的壓縮方法和/或壓縮級別。壓縮方法可以設定為 gzip、lz4、zstd 或 none（無壓縮）。可以選擇性地指定壓縮詳細資訊字串。如果詳細資訊字串是整數，則指定壓縮級別。否則，它應該是一個由逗號分隔的專案列表，每個專案形式為 關鍵字 或 關鍵字=值。目前，支援的關鍵字是 level 和 long。

如果未指定壓縮級別，則將使用預設壓縮級別。如果僅指定級別而未提及演算法，則當級別大於 0 時將使用 gzip 壓縮，當級別為 0 時則不進行壓縮。

對於自定義和目錄歸檔格式，此選項指定對各個表資料段進行壓縮，預設使用 gzip 以中等級別進行壓縮。對於純文字輸出，設定非零壓縮級別將導致整個輸出檔案被壓縮，如同透過 gzip、lz4 或 zstd 進行過管道傳輸一樣；但預設情況下不進行壓縮。使用 zstd 壓縮時，long 模式可能會提高壓縮率，但會增加記憶體使用。

tar 歸檔格式目前根本不支援壓縮。

此選項供就地升級實用程式使用。不推薦或不支援將其用於其他目的。該選項的行為可能在未來的版本中更改，恕不另行通知。

以帶有顯式列名的 INSERT 命令（INSERT INTO 表 (列, ...) VALUES ...）的形式轉儲資料。這將使恢復速度非常慢；它主要用於製作可以載入到非 PostgreSQL 資料庫中的轉儲。恢復期間的任何錯誤只會導致有問題的 INSERT 中的行丟失，而不是整個表內容丟失。

此選項停用函式體中使用美元引號，並強制使用 SQL 標準字串語法對其進行引用。

此選項僅在建立包含資料但不包含模式的轉儲時相關。它指示 pg_dump 在恢復資料期間包含臨時停用目標表上觸發器的命令。如果您在表上有參照完整性檢查或其他觸發器，但不想在資料恢復期間呼叫它們，請使用此選項。

目前，為 --disable-triggers 發出的命令必須以超級使用者身份執行。因此，您還應使用 -S 指定超級使用者名稱，或者最好注意以超級使用者身份啟動生成的指令碼。

當發出歸檔（非文字）輸出檔案時，此選項將被忽略。對於歸檔格式，可以在呼叫 pg_restore 時指定該選項。

此選項僅在轉儲具有行安全策略的表的內容時相關。預設情況下，pg_dump 將 row_security 設定為關閉，以確保從表中轉儲所有資料。如果使用者沒有足夠的許可權繞過行安全策略，則會引發錯誤。此引數指示 pg_dump 將 row_security 設定為開啟，從而允許使用者轉儲他們有權訪問的表內容的各個部分。

請注意，如果您使用此選項，您可能還希望轉儲為 INSERT 格式，因為 COPY FROM 在恢復期間不支援行安全策略。

不要轉儲與 模式 匹配的任何擴充套件。模式的解釋方式與 -e 相同。--exclude-extension 可以多次給出，以排除與多個模式中的任何一個匹配的擴充套件。

當同時給出 -e 和 --exclude-extension 時，行為是僅轉儲至少匹配一個 -e 開關但不匹配任何 --exclude-extension 開關的擴充套件。如果 --exclude-extension 出現在沒有 -e 的情況下，那麼與 --exclude-extension 匹配的擴充套件將從正常的轉儲中排除。

這與 -T/--exclude-table 選項相同，但它還排除了與 模式 匹配的表及其任何分割槽或繼承的子表。

不要轉儲與 模式 匹配的任何表的任何資料。模式的解釋方式與 -t 相同。--exclude-table-data 可以多次給出，以排除與多個模式中的任何一個匹配的表。此選項對於在需要某個特定表的定義但不需要其中資料時非常有用。

要排除資料庫中所有表的 D資料，請參閱 --schema-only 或 --statistics-only。

這與 --exclude-table-data 選項相同，但它還排除了與 模式 匹配的表以及這些表的任何分割槽或繼承的子表的資料。

轉儲浮點資料時使用指定的 extra_float_digits 值，而不是最大可用精度。常規轉儲以用於備份目的不應使用此選項。

指定一個檔名，從中讀取要包含或排除在轉儲中的物件的模式。模式的解釋方式與相應選項相同：-t/--table、--table-and-children、-T/--exclude-table 和 --exclude-table-and-children 用於表，-n/--schema 和 -N/--exclude-schema 用於模式，--include-foreign-data 用於外部伺服器上的資料，--exclude-table-data 和 --exclude-table-data-and-children 用於表資料，以及 -e/--extension 和 --exclude-extension 用於擴充套件。要從 STDIN 讀取，請使用 - 作為檔名。--filter 選項可以與上述用於包含或排除物件的選項結合使用，並且可以多次指定以用於多個過濾器檔案。

檔案每行列出一個物件模式，格式如下

{ include | exclude } { extension | foreign_data | table | table_and_children | table_data | table_data_and_children | schema } PATTERN

第一個關鍵字指定要過濾的物件是否要包含或排除。第二個關鍵字指定要使用模式過濾的物件型別

以 # 開頭的行被視為註釋並被忽略。註釋也可以放在物件模式行之後。空行也被忽略。有關如何在模式中進行引用的資訊，請參見 模式。

示例檔案列在下面的 示例 部分。

使用 DROP ... IF EXISTS 命令來刪除 --clean 模式中的物件。這會抑制可能報告的“不存在”錯誤。此選項僅在也指定了 --clean 時才有效。

轉儲與 foreignserver 模式匹配的任何外部表的表資料。可以透過編寫多個 --include-foreign-data 開關來選擇多個外部伺服器。此外，foreignserver 引數被解釋為與 psql 的 \d 命令使用的規則相同的模式（請參閱 模式），因此透過在模式中寫入萬用字元也可以選擇多個外部伺服器。使用萬用字元時，請務必引用模式（如果需要），以防止 shell 擴充套件萬用字元；請參閱下面的 示例。唯一例外是禁止空模式。

以 INSERT 命令（而不是 COPY）的形式轉儲資料。這將使恢復速度非常慢；它主要用於製作可以載入到非 PostgreSQL 資料庫中的轉儲。恢復期間的任何錯誤只會導致有問題的 INSERT 中的行丟失，而不是整個表內容丟失。請注意，如果重新排列了列順序，恢復可能會完全失敗。--column-inserts 選項對於列順序更改是安全的，儘管速度會更慢。

在轉儲表分割槽的 D資料時，使 COPY 或 INSERT 語句指向包含它的分割槽層次結構的根，而不是分割槽本身。這會導致在載入資料時為每一行重新確定適當的分割槽。當在行不總是落入與原始伺服器相同的分割槽中的伺服器上恢復資料時，這可能很有用。例如，如果分割槽列是 text 型別，並且兩個系統對用於對分割槽列進行排序的排序規則有不同的定義，則可能會發生這種情況。

不要永遠等待在轉儲開始時獲取共享表鎖。相反，如果在指定的 超時 內無法鎖定表，則失敗。超時可以是 SET statement_timeout 接受的任何格式。（允許的格式因您從中轉儲的伺服器版本而異，但所有版本都接受以毫秒為單位的整數。）

不要轉儲 COMMENT 命令。

不要轉儲 D資料。

不要轉儲行安全策略。

不要轉儲釋出。

不要轉儲模式（資料定義）。

不要轉儲安全標籤。

不要轉儲統計資訊。這是預設行為。

不要轉儲訂閱。

預設情況下，pg_dump 將等待所有檔案安全地寫入磁碟。此選項導致 pg_dump 在不等待的情況下返回，這更快，但意味著後續的作業系統崩潰可能會使轉儲損壞。通常，此選項對於測試很有用，但不應在從生產安裝轉儲資料時使用。

不輸出用於選擇表訪問方法的命令。使用此選項，所有物件都將使用恢復期間的預設表訪問方法建立。

當發出歸檔（非文字）輸出檔案時，此選項將被忽略。對於歸檔格式，可以在呼叫 pg_restore 時指定該選項。

不要輸出選擇表空間的命令。使用此選項，所有物件都將在恢復期間預設的表空間中建立。

當發出歸檔（非文字）輸出檔案時，此選項將被忽略。對於歸檔格式，可以在呼叫 pg_restore 時指定該選項。

不要輸出設定TOAST壓縮方法的命令。使用此選項，所有列都將以預設壓縮設定進行恢復。

不要轉儲未記錄表和序列的內容。此選項對是否轉儲表和序列定義（模式）沒有影響；它僅抑制轉儲表和序列 D資料。從備用伺服器轉儲時，未記錄表和序列中的 D資料始終被排除。

將 ON CONFLICT DO NOTHING 新增到 INSERT 命令。此選項無效，除非還指定了 --inserts、--column-inserts 或 --rows-per-insert。

強制引用所有識別符號。當從 PostgreSQL 主版本不同於 pg_dump 的伺服器轉儲資料庫時，或者當輸出旨在載入到不同主版本的伺服器時，建議使用此選項。預設情況下，pg_dump 僅引用其自身主版本中的保留字識別符號。這有時會在處理具有略有不同的保留字集的其他版本伺服器時導致相容性問題。使用 --quote-all-identifiers 可以防止此類問題，但代價是轉儲指令碼更難閱讀。

使用提供的字串作為轉儲輸出中的 psql \restrict 鍵。這隻能為純文字轉儲指定，即當 --format 設定為 plain 或省略 --format 選項時。如果未指定 restrict 鍵，pg_dump 將在需要時生成一個隨機鍵。鍵只能包含字母數字字元。

此選項主要用於測試目的和其他需要可重複輸出（例如，比較轉儲檔案）的場景。不建議常規使用，因為帶有金鑰預知能力的惡意伺服器可能能夠注入任意程式碼，這些程式碼將在執行 psql 並使用轉儲輸出的機器上執行。

以 INSERT 命令（而不是 COPY）的形式轉儲資料。控制每個 INSERT 命令的最大行數。指定的值必須是大於零的數字。恢復期間的任何錯誤只會導致有問題的 INSERT 中的行丟失，而不是整個表內容丟失。

僅轉儲命名節。節名可以是 pre-data、data 或 post-data。可以多次指定此選項以選擇多個節。預設是轉儲所有節。

資料節包含實際表資料、大物件內容、序列值以及表、物化檢視和外部表的統計資訊。後資料項包括索引、觸發器、規則、索引統計資訊以及除已驗證的檢查和非空約束之外的約束的定義。預資料項包括所有其他資料定義項。

在轉儲中包含序列資料。這是預設行為，除非指定了 --no-data、--schema-only 或 --statistics-only。

使用 serializable 事務進行轉儲，以確保使用的快照與後續資料庫狀態一致；但透過等待事務流中的一個點來做到這一點，這樣就不會有轉儲失敗或導致其他事務回滾的風險 serialization_failure。有關事務隔離和併發控制的更多資訊，請參閱 第 13 章。

此選項對於僅用於災難恢復的轉儲沒有好處。它可能有助於用於載入資料庫副本以進行報告或其他只讀負載共享的轉儲，同時原始資料庫繼續被更新。沒有它，轉儲可能反映一個與任何事務的序列執行都不一致的狀態。例如，如果使用批處理處理技術，一個批次在轉儲中可能顯示為已關閉，但批次中的所有項都沒有出現。

如果沒有活動讀寫事務在 pg_dump 啟動時啟用，此選項將沒有區別。如果存在活動讀寫事務，轉儲的開始可能會延遲 indeterminate 時間。一旦執行，無論是否有開關，效能都是相同的。

在對資料庫進行轉儲時，使用指定的同步快照（請參閱 表 9.100 以獲取更多詳細資訊）。

此選項對於需要將轉儲與邏輯複製槽（請參閱 第 47 章）或與併發會話同步非常有用。

在並行轉儲的情況下，將使用此選項定義的快照名稱，而不是獲取新快照。

轉儲統計資訊。

僅轉儲統計資訊，而不轉儲模式（資料定義）或 D資料。轉儲表、物化檢視、外部表和索引的統計資訊。

要求每個擴充套件（-e/--extension）、模式（-n/--schema）和表（-t/--table）模式都能匹配資料庫中至少一個要轉儲的擴充套件/模式/表。這同樣適用於與 --filter 一起使用的過濾器。請注意，如果任何擴充套件/模式/表模式均未找到匹配項，pg_dump 將生成一個錯誤，即使沒有 --strict-names。

此選項對 --exclude-extension、-N/--exclude-schema、-T/--exclude-table 或 --exclude-table-data 沒有影響。未能匹配任何物件的排除模式不被視為錯誤。

當設定為 fsync（預設值）時，pg_dump --format=directory 將遞迴開啟並同步歸檔目錄中的所有檔案。

在 Linux 上，可以使用 syncfs 來要求作業系統同步包含歸檔目錄的整個檔案系統。有關使用 syncfs 時需要注意的注意事項，請參閱 recovery_init_sync_method。

當使用 --no-sync 或 --format 未設定為 directory 時，此選項無效。

這與 -t/--table 選項相同，但它還包括與 模式 匹配的表及其任何分割槽或繼承的子表。

輸出 SQL 標準 SET SESSION AUTHORIZATION 命令，而不是 ALTER OWNER 命令來確定物件所有權。這使得轉儲更符合標準，但根據轉儲物件歷史，可能無法正確恢復。此外，使用 SET SESSION AUTHORIZATION 的轉儲肯定需要超級使用者許可權才能正確恢復，而 ALTER OWNER 需要較低的許可權。

顯示有關 pg_dump 命令列引數的幫助，然後退出。

指定要連線的資料庫名稱。這等同於在命令列上將 資料庫名 指定為第一個非選項引數。資料庫名 可以是 連線字串。如果是這樣，連線字串引數將覆蓋任何衝突的命令列選項。

指定伺服器執行所在計算機的主機名。如果值以斜槓開頭，則將其用作 Unix 域套接字的目錄。預設值取自 PGHOST 環境變數（如果已設定），否則嘗試 Unix 域套接字連線。

指定伺服器正在監聽連線的 TCP 埠或本地 Unix 域套接字副檔名。預設值為 PGPORT 環境變數（如果已設定），或者編譯時預設值。

要連線的使用者。:

絕不發出密碼提示。如果伺服器需要密碼身份驗證且密碼不可用（例如透過 .pgpass 檔案），則連線嘗試將失敗。此選項在沒有使用者在場輸入密碼的批處理作業和指令碼中很有用。

強制 pg_dump 在連線到資料庫之前提示輸入密碼。

此選項永遠不是必需的，因為如果伺服器要求密碼認證，pg_dump 會自動提示輸入密碼。但是，pg_dump 會浪費一次連線嘗試來確定伺服器需要密碼。在某些情況下，鍵入 -W 以避免額外的連線嘗試是值得的。

指定一個角色名，用於建立轉儲。此選項會導致 pg_dump 在連線到資料庫後發出 SET ROLE 角色名 命令。當認證使用者（由 -U 指定）缺乏 pg_dump 所需的許可權，但可以切換到具有所需許可權的角色時，此選項很有用。一些安裝有禁止直接以超級使用者身份登入的策略，使用此選項可以在不違反策略的情況下進行轉儲。

預設連線引數。

指定是否在診斷訊息中使用顏色。可能的值為 always、auto 和 never。