Provided by: manpages-zh_1.5.1-1_all bug

NAME

       pg_restore - 從一茈 pg_dump 創建的備份檔案中恢復 PostgreSQL 數據庫。

SYNOPSIS

       pg_restore [ option... ] [ filename ]

DESCRIPTION yz
       pg_restore  是一種用於恢復由 pg_dump(1)  創建的任何非純文本輸出格式中的
       PostgreSQL             數據庫的應用。              它將發出必n的命令來-
       奐s構造數據庫,以便於把它恢復成保存它的時啋獐豸l。
       歸檔(備份)檔案還允貪_restore
       有選擇地進行恢復,         甚至在恢復前奐s排列條目的順序。歸檔的檔案設-
       p成可以在不同的硬體體系之間移植。

       pg_restore                   可以以兩種模式操作:如果聲明了數據庫名字,
       那麼歸檔是直接恢復到數據庫裏。大對象只能用直接數據庫聯接進行恢復。
       否則,先創建一茈]含垂媦畬w所必須的   SQL    命令的稿本(並且寫入到一-
       蚗仵蚸峈抯郱擖X),  類似 pg_dump 輸出純文字格式的時堀衎堛漕犖婼Z本。
       因此,一些控制稿本輸出的選項就是摹擬 pg_dump 的操作。

       顯然,pg_restore                   無法恢復那些不存在歸檔檔案中的信息;
       比如,如果歸檔是用"把數據轉儲為 INSERT命令"選項製作的, 那麼 pg_restore
       將不能使用 COPY 語句裝載數據。

OPTIONS項
       pg_restore 接受下列命令行參數。

       filename
               聲明n恢復的備份檔案的位置。如果沒有聲明,則使用標準輸入。

       -a

       --data-only
               只恢復數據,而不恢復表模式(數據定義)。

       -c

       --clean
               創建數據庫對象前先清理(刪除)它怴C

       -C

       --create
               在恢復數據庫之前先創建它。(如果出現了這蚇龠窗A和            -d
              在一起的數據庫名只是用於發出最初的    CREATE   DATABASE   命令。
              所有數據都恢復到名字出現在歸檔中的數據庫中去。)

       -d dbname

       --dbname=dbname
               與數據庫 dbname 聯接並且直接恢復到該數據庫中。

       -f filename

       --file=filename
               聲明生成的稿本的輸出檔案,或者出現                           -l
              選項時用於列表的檔案,預設是標準輸出。

       -F format

       --format=format
               聲明備份檔案的格式。因為pg_restore
              會自動判斷格式,所以如果聲明了,它可以是下惜坐@:

              t       備份是一  tar  歸檔。  使用這荇璁﹞像在恢復數據庫的時-
                     奐s排序和/或把表模式元素排除出去。 同時還可能在恢復的時-
                     制裝載的數據。

              c            備份的格式是來自       pg_dump       的客戶化格式。
                     這是最靈活的格式,因為它允釩新對數據排序,也允-
                     姜表模式元素。 預設時這荇璁′O壓縮的。

       -i

       --ignore-version
               忽略數據庫版本檢查。

       -I index

       --index=index
               只恢復命名的索引。

       -l

       --list       列出備份的內容。這蚞犑@的輸出可以用      -L      選項制和-
              垮珓黕_的項目。

       -L list-file

       --use-list=list-file
               只恢復在     list-file     裏悸漱葛嚏A以它怞b檔案中出現的順序。
              你可以移動各茼璅疇B也可以通過在行開頭放                      ';'
              的方式注釋。(見下文獲取例子。)

       -N

       --orig-order
               以最初在       pg_dump      裏生成的轉儲順序恢復項目。      這-
              蚇龠筐S有什麼實際的用途,因為 pg_dump 會以自己方便的順序生成項,
              這荈陽ㄔi能是恢復這些數據的安全順序。                    (這-
              荈陽ㄛO項最後在歸檔的內容列表中列出的順序。) 又見 -r。

       -o

       --oid-order
               以     OID     順序恢復項目。這蚇龠等帠B很小,     因為     OID
              只是最初創建順序的一茠韘指示。     如果還聲明了     -N,那麼這-
              蚇龠聒棯郅它。又見 -r。

       -O

       --no-owner
               不n輸出設置對象的權,以便與最初的數據庫匹配的命令。
              預設時,pg_restore     發出     SET     SESSION    AUTHORIZATION
              語句設置創建出來的模式元素的所有者權。
              如果最初的數據庫連接不是由超級使用者(或者是擁有所有創建出來的對象的同一-
              茖洏峈怴^發起的,那麼這些語句將失敗。                       使用
              -O,那麼任何使用者都可以用於初始的連接,並且這-
              茖洏峈戔N擁有所有創建出來的對象。

       -P function-name(argtype [, ...])

       --function=function-name(argtype [, ...])
               只恢復指定的命名函數。請注意仔細拼寫函數名及其參數,應該和轉儲的內容列表中的完全一樣。

       -r

       --rearrange
               以對象類型垮等堙]這茧o生在以    -N   或者   -o   排序之後)。
              垮O為了給出最大可能的性能。

              如果沒有  -N,   -o,   和-r,那麼   pg_restore   以項目出現在歸檔
              的內容列表中的順序恢復他怴A    或者按照他怞b    list-file    裏-
              悸熄陽黕_他 -- 假如給出了 -L 的話。  -o  和  -r  的組合複製了
              pg_dump    在創建歸檔的內容列表    之前進行的排序,    因此,這-
              蚇龠絨q常沒必n聲明。

       -R

       --no-reconnect
               這蚇龠竣w經廢棄了,但是為了保持向下相容仍然接受。

       -s

       --schema-only
               只恢復表結構(數據定義)。不恢復數據,序列N姜m。

       -S username

       --superuser=username
               設置關閉觸發器時聲明超級使用者的使用者名。         只有在設置了
              --disable-triggers 的時啎~有用。

       -t table

       --table=table
               只恢復表指定的表的定義和/或數據。

       -T trigger

       --trigger=trigger
               只恢復指定的觸發器。

       -v

       --verbose
               聲明冗餘模式。

       -x

       --no-privileges

       --no-acl
               避免 ACL 的恢復(grant/revoke 命令)。

       -X use-set-session-authorization

       --use-set-session-authorization
               這蚇龠竣w經廢棄了,但是出於向下相容,仍然接受。      pg_restore
              現在總是表現得像以前選中這蚇龠竣@樣。

       -X disable-triggers

       --disable-triggers
               這蚇龠等u有在執行僅恢復數據的時啎~相關。它告訴       pg_restore
              在裝載數據的時埶鶡璊@些命令臨時關閉在目標表上的觸發器。
              如果你在表上有完整性檢查或者其它觸發器,
              而你又不希望在裝載數據的時埥E活它怴A那麼可以使用這蚇龠窗C

               目前,為   --disable-triggers  發出的命令必須以超級使用者發出。
              因此,你應該也n用 -S 聲明一荈W級使用者名,或者更好是設置  --use-
              set-session-authorization  並且以  PostgreSQL  超級使用者言鷞B行
              pg_restore。

       pg_restore 還接受下悸漫R令行參數做為聯接參數:

       -h host

       --host=host
               聲明伺服器運行的機器的主機名。  如果數H斜扛開頭,那麼它被用做
              Unix          域套接字的目錄。          預設是從          PGHOST
              環境變量中獲取的(如果設置了), 否則將嘗試進行 Unix 域套接字。

       -p port

       --port=port
               聲明伺服器偵聽的  TCP  端口或者本地的  Unix  域套接字檔案擴展。
              預設是環境變量           PGPORT          的]如果設置了的話),
              否則就說編譯的預設。

       -U username
               以給出使用者角擱p接。

       -W      強制給出口令提示。如果伺服器n求口令認証,那麼這蚗雩茼菾妗o生。

ENVIRONMENT境
       PGHOST

       PGPORT

       PGUSER  預設連接參數。

DIAGNOSTICSE
        當使用-d選項聲明了直接數據庫聯接時,   pg_restore    在內部執行    SQL
       語句。如果你運行   pg_restore   出了毛病,   請確保你能用類似   psql(1)
       這樣的東西從數據庫中選取信息。

NOTES`N
        如果你的安裝給template1數據庫增加了任何你自己的東西,     那麼請注意把
       pg_dump     的輸出恢復到一荅u正空的數據庫中;     否則你可能會收到因為-
       契_定義所追加的對象而造成的錯誤訊息。n製作一-
       茖S有任何本地附屬物的數據庫,
       可以從template0而不是template1拷貝,比如:

       CREATE DATABASE foo WITH TEMPLATE template0;

       pg_restore 的局在下惘C出。

       o      當向一茪w經存在的表恢復數據,並且還使用了     --disable-triggers
         選項時, pg_restore  在插入數據前放出一些查詢關閉使用者表上的觸發器,
         在數據插入完成後奐s打開它-
         怴C如果恢復的中途停止,那麼系統表可能處於錯誤狀態。

       o pg_restore            將不會為單一的表恢復大對象。            如果一-
         蚋k檔包含大對象,那麼所有大對象都將被恢復。

        又見參 pg_dump(1) 的文擋獲取有關 pg_dump 的局的細節。

        一旦完成恢復,最好在每茷黕_的對象上運行                      ANALYZE,
       以便給優化器有用的統p。

EXAMPLESl
        把一茈]含大對象的叫 mydb 的數據庫轉儲到一茭ar檔案:

       $ pg_dump -Ft -b mydb > db.tar

        把這蚍畬w恢復到現有的叫 newdb 的數據庫中(連同BLOB):

       $ pg_restore -d newdb db.tar

        n對項目奐s排序,漸必須轉儲歸檔的目錄:

       $ pg_restore -l archive.file > archive.list

        這蚗仵蚰悀@行頭和每荈等堣@行組成,比如。

       ;
       ; Archive created at Fri Jul 28 22:28:36 2000
       ;     dbname: birds
       ;     TOC Entries: 74
       ;     Compression: 0
       ;     Dump Version: 1.4-0
       ;     Format: CUSTOM
       ;
       ;
       ; Selected TOC Entries:
       ;
       2; 145344 TABLE species postgres
       3; 145344 ACL species
       4; 145359 TABLE nt_header postgres
       5; 145359 ACL nt_header
       6; 145402 TABLE species_records postgres
       7; 145402 ACL species_records
       8; 145416 TABLE ss_old postgres
       9; 145416 ACL ss_old
       10; 145433 TABLE map_resolutions postgres
       11; 145433 ACL map_resolutions
       12; 145443 TABLE hs_old postgres
       13; 145443 ACL hs_old

        這裏分號是注釋分隔符,而行開頭的數字代表賦給每荈等堛漱熙¯k檔 ID。

        檔案內的行可以注釋掉,刪除和/或奐s排列。比如,

       10; 145433 TABLE map_resolutions postgres
       ;2; 145344 TABLE species postgres
       ;4; 145359 TABLE nt_header postgres
       6; 145402 TABLE species_records postgres
       ;8; 145416 TABLE ss_old postgres

        可以用做 pg_restore 的輸入並且只會恢復項目 10 和 6,(以這荈陽^:

       $ pg_restore -L archive.list archive.file

HISTORYv
       pg_restore 工具第一次出現在 PostgreSQL 7.1。

SEE ALSO見
       pg_dump(1), pg_dumpall(1), psql(1)

者
       Postgresql  <laser@pgsqldb.org>