pg_dump · PHP知識總結

       pg_dump可以將表結構及數據以SQL語句的形式導出到文件中，恢復數據時，將導出的文件作為輸入，執行其中的SQL語句，即可恢復數據。        pg_dump不阻塞其他用戶訪問數據庫（讀取或寫入）。        pg_dump只轉儲單個數據庫。要備份一個集簇或者集簇中對于所有數據庫公共的全局對象（例如角色和表空間），應使用pg_dumpall。        轉儲可以被輸出到腳本或歸檔文件格式。腳本轉儲是包含 SQL 命令的純文本文件，可以通過`psql`進行調用執行以達到數據恢復的效果；歸檔文件格式必須與`pg_restore`配合使用來重建數據庫。它們允許`pg_restore`能選擇恢復什么，或者甚至在恢復之前對條目重排序。歸檔文件格式被設計為在架構之間可移植。 **命令格式：** pg_dump [OPTION]... [DBNAME] > **General options：** > * **-f, --file=FILENAME**：指定導出到指定文件的文件名 > * **-F, --format=c|d|t|p** ：指定導出格式 > * p / plan：一個純文本形式的SQL腳本文件（默認值） > * c / custom：輸出一個適合于作為pg\_restore輸入的自定義格式歸檔。和目錄輸出格式一起，這是最靈活的輸出格式，它允許在恢復時手動選擇和排序已歸檔的項。這種格式在默認情況還會被壓縮。 > * d / directory：輸出一個適合作為pg_restore輸入的目錄格式歸檔。這將創建一個目錄，其中每個被轉儲的表和大對象都有一個文件，外加一個目錄文件，該文件以一種pg_restore能讀取的機器可讀格式描述被轉儲的對象。 > * t / tar：輸出一個適合于輸入到pg\_restore中的`tar`\-格式歸檔。tar 格式可以兼容目錄格式，抽取一個 tar 格式的歸檔會產生一個合法的目錄格式歸檔。不過，tar 格式不支持壓縮。還有，在使用 tar 格式時，表數據項的相對順序不能在恢復過程中被更改 > * **-j, --jobs=NUM**：執行多個并行任務來執行備份轉存工作，需確保你的`max_connections`設置足夠高以容納所有的連接。只能和目錄輸出格式一起使用這個選項，因為這是唯一一種讓多個進程能在同一時間寫其數據的輸出格式。 > * **-v, --verbose**：指定詳情模式，pg\_dump向標準錯誤輸出詳細的對象注釋以及轉儲文件的開始/停止時間，還有進度消息 > * **-V, --version**：打印版本 > * **-Z, --compress=0-9** ：指定要使用的壓縮級別。零意味著不壓縮。對于自定義歸檔格式，這會指定個體表數據段的壓縮，并且默認是進行中等級別的壓縮。對于純文本輸出，設置一個非零壓縮級別會導致整個輸出文件被壓縮，就好像它被gzip處理過一樣，但是默認是不壓縮。tar 歸檔格式當前完全不支持壓縮 > * **--lock-wait-timeout=TIMEOUT** ：在轉儲的開始從不等待共享表鎖的獲得。而是在指定的`timeout`內不能鎖定一個表時失敗。超時時長可以用`SET statement_timeout`接受的任何格式指定 > * **--no-sync**：默認情況下，`pg_dump`將等待所有文件被安全地寫入磁盤。這個選項會讓`pg_dump`不等待直接返回，這樣會更快，但是也意味著后續的一次操作系統崩潰會讓該轉儲損壞。通常這個選項對測試有用，但是不應該在從生產安裝中轉儲數據時使用 > * **-?, --help**：顯示幫助信息并退出 > > **Options controlling the output content：** > * **-a, --data-only**：只轉儲數據，而不轉儲模式（數據定義）。表數據、大對象和序列值都會被轉儲 > * **-b, --blobs**：在轉儲中包括大對象。這是當`--schema`、`--table`或`--schema-only`被指定時的默認行為 > * **-B, --no-blobs**：在轉儲中排除大對象。當-b和-B同時指定時，默認是 -b 導出大對象 > * **-c, --clean**：此選項針對純文本，指定輸出的腳本中是否生成清理該數據庫對象的語句 > * **-C, --create**：此選項針對純文本。指定腳本中是否輸出一條 create database 語句和連接到該數據庫的語句。一般在備份的源數據庫與恢復的目標數據庫名稱一致時，才指定這個參數。如果也指定了`--clean`，腳本會在重新連接到目標數據庫之前先刪除它然后再重建 > * **-E, --encoding=ENCODING** ：以指定的字符集編碼創建轉儲。在默認情況下，該轉儲會以該數據庫的編碼創建 > * **-n, --schema=PATTERN**：只轉儲匹配schema的模式內容，包括模式本身以及其中包含的對象。如果沒有聲明這個選項，所有目標數據庫中的非系統模式都會被轉儲出來。可以使用多個 -n 選項指定多個模式轉儲 > * **-N, --exclude-schema=PATTERN**：不轉儲匹配`pattern`模式的任何模式。`-N`可以被給定多次來排除匹配幾個模式中任意一個的模式。 > * **-O, --no-owner**：此參數針對純文本格式。表示不把轉儲的對象的所有權設置為對應源數據庫中的owner。pg_dump 默認發出 ALTER OWNER 或 SET SESSION AUTHORAZATION 語句來設置創建的數據庫對象的所有者。如果這些腳本將來沒有被超級用戶（或擁有腳本中全部對象的用戶）運行，會導致恢復失敗， -O 選項就是為了讓該腳本可以被任何用戶使用。 > * **-s, --schema-only**：只轉儲對象定義（模式），而非數據。此選項用于備份表結構 > * **-S, --superuser=NAME**：此參數指定關閉觸發器時需要用到的超級用戶名。它只在使用了 --disable-triggers 時才有作用。 > * **-t, --table=PATTERN** ：只轉儲名字匹配`pattern`的表。通過寫多個`-t`開關可以選擇多個表。當`-t`選項被使用時，`-n`和`-N`選項不會有效果。 > * **-T, --exclude-table=PATTERN**：不轉儲匹配`pattern`模式的任何表。`-T`可以被給定多次來排除匹配幾個模式中任意一個的模式。當`-t`和`-T`都被給定時，該行為是只轉儲匹配至少一個`-t`開關但是不匹配`-T`開關的表。如果只有`-T`而沒有`-t`，那么匹配`-T`的表會被從一個正常轉儲中排除。 > * **-x, --no-privileges**：禁止轉儲訪問權限（grant、revoke 命令）。 > * **--binary-upgrade**：這個選項僅用于升級功能。 > * **--column-inserts**：該選項為表數據每一行生成**具有列名的INSERT命令**，當數據庫恢復時遇到一行錯誤時，它只會導致錯誤的這一行數據丟失，而不是全部數據。 > * **--disable-dollar-quoting**：這個選項禁止在函數體中使用美元符號引用，并且強制它們使用 SQL 標準字符串語法被引用 > * **--disable-triggers** ：此選項針對純文本格式。它告訴 pg\_dump 在恢復數據時，臨時關閉目標表上觸發器的命令。如果表上有參照完整性檢查或其他觸發器，且恢復數據時不需要重載它們，就使用此選項。為 --disable-trigger 發出的命令必須作為超級用戶執行。因此，還應該使用-S指定超級用戶名 > * **--enable-row-security**：只有在轉儲具有行安全性的表的內容時，這個選項才相關。默認情況下，pg\_dump將把`row_security`設置為 off 來確保從該表中轉儲出所有的數據。如果用戶不具有足夠能繞過行安全性的特權，那么會拋出一個錯誤這個參數指示pg\_dump將``row_security``設置為 on，允許用戶只轉儲該表中它們能夠訪問到的部分內容。 > * **--exclude-table-data=PATTERN**：此選項表示不轉儲匹配table模式的任何表中的數據。–exclude-table-data可以被給定多次來排除匹配多個模式的表。應用于當你需要一個特定表的定義但不想要其中的數據時 > * **--extra-float-digits=NUM**：在轉儲浮點數據時使用規定的`extra_float_digits`值，而不是最大可用精度 > * **--if-exists**：只有同時指定了`--clean`時，這個選項才可用，增加一個`IF EXISTS`子句 > * **--include-foreign-data=PATTERN**：包含外部服務器上與模式匹配的外部表的數據。可以通過編寫多個`--include-foreign-data`開關來選擇多個外部服務器 > * **--inserts**：將數據轉儲為`INSERT`命令（而不是`COPY`）。重新加載期間的任何錯誤都將導致有問題的`INSERT`相關的行將丟失，而不是整個表內容。與`--column-inserts`的區別是`--column-inserts`導出時，insert語句攜帶了列名，而`--inserts`參數導出時，insert不帶列名。 > * **--load-via-partition-root**：在為一個分區表轉儲數據時，讓`COPY`語句或者`INSERT`語句將根表作為目標，在數據被裝載時，會為每一個行重新確定合適的分區 > * **--no-comments**：不轉儲注釋 > * **--no-publications**：不轉儲publication。 > * **--no-security-labels**：不轉儲安全標簽 > * **--no-subscriptions**：不轉儲訂閱 > * **--no-synchronized-snapshots**：這個選項允許對 9.2 以前的服務器運行`pg_dump -j`，詳見`-j`參數的文檔 > * **--no-tablespaces**：不轉存表空間，通過這個選項，在恢復期間所有的對象都會被創建在任何作為默認的表空間中。這個選項只對純文本格式有意義。對于歸檔格式，你可以在調用`pg_restore`時指定該選項 > * **--no-unlogged-table-data**：不轉儲未標記的表數據 > * **--on-conflict-do-nothing**：增加`ON CONFLICT DO NOTHING`到`INSERT`commands。除非規定了`--inserts`,`--column-inserts`或`--rows-per-insert`，否則此選項是無效的 > * **--quote-all-identifiers**：強制引用所有標識符，默認情況下，pg\_dump只對在其主版本中是被保留詞的標識符加上引號。在轉儲其他版本服務器時，這種默認行為有時會導致兼容性問題，因為那些版本可能具有些許不同的被保留詞集合。使用`--quote-all-identifiers`能阻止這種問題，但代價是轉儲腳本更難閱讀 > * **--rows-per-insert=NROWS**：數據轉儲為`INSERT`命令（而不是`COPY`）。控制每個`INSERT`命令的最大行數。指定的值必須大于零。重新加載期間的任何錯誤都將導致有問題的`INSERT`相關的行將丟失，而不是整個表內容。 > * **--section=SECTION**：轉儲命名節（預數據、數據或后數據） > * **--serializable-deferrable**：為轉儲使用一個`可序列化`事務，以保證所使用的快照與后來的數據庫狀態是一致的。但是這樣做是在事務流中等待一個點，在該點上不能存在異常，這樣就不會有轉儲失敗或者導致其他事務帶著`serialization_failure`回滾的風險 > * **--snapshot=SNAPSHOT**：在做一個數據庫的轉儲時指定一個同步的快照`` > * **--strict-names**：要求每一個模式（`-n`/`--schema`）和表（`-t`/`--table`）限定符匹配要轉儲的數據庫中至少一個模式/表。這個選項對`-N`/`--exclude-schema`、`-T`/`--exclude-table`或者`--exclude-table-data`沒有效果。無法匹配任何對象的排除模式不會被當作錯誤。 > * **--use-set-session-authorization**：輸出 SQL-標準的`SET SESSION AUTHORIZATION`命令取代`ALTER OWNER`命令來確定對象的所有關系。這讓該轉儲更加兼容標準，但是取決于該轉儲中對象的歷史，該轉儲可能無法正常恢復。而且，一個使用`SET SESSION AUTHORIZATION`的轉儲將一定會要求超級用戶特權來正確地恢復，而`ALTER OWNER`要求更少的特權 > > > **Connection options：** > * **-d, --dbname=DBNAME** ：指定要轉儲的數據庫 > * **-h, --host=HOSTNAME** ：指定運行服務器的機器的主機名 > * **-p, --port=PORT**：指定端口 > * **-U, --username=NAME**：指定用戶 > * **-w, --no-password**：不提示輸入密碼 > * **-W, --password**：強制密碼提示 > * **--role=ROLENAME**：指定一個用來創建該轉儲的角色名。這個選項導致pg\_dump在連接到數據庫后發出一個`SET ROLE`*`rolename`*命令 | 命令 | 解釋 | | --- | --- | | pg_dump test > test.sql <br>pg_dump test -f test_db.sql<br>pg_dump -d test -f test_db.sql | 將test數據庫轉儲到test.sql文件 | | pg_dump -t '(al\|te)*' -f test.sql| 只轉儲al開頭或者te開頭的表 | | pg_dump -t '(al\|te)*' --column-inserts -f test.sql |將al開頭或者te開頭的表轉儲為攜帶列名的sql文件。默認轉儲的格式為copy命令 | | pg_dump -t '(al\|te)*' --column-inserts --rows-per-insert=100 -f test.sql | --column-inserts參數將表數據轉儲為insert語句，默認一行轉儲為一條insert語句，--rows-per-insert將表數據轉儲為insert語句，每條insert包含對應數量的數據 |