說明：

FILE沒有短選項或長選項。用來指定歸檔文件所處的位置。
作為前提條件，需輸入dbname或-l選項。不允許用戶同時輸入dbname和-l選項。
gs_restore默認是以追加的方式進行數(shù)據(jù)導(dǎo)入。為避免多次導(dǎo)入造成數(shù)據(jù)異常，在進行導(dǎo)入時，建議使用“-c” 參數(shù)，在重新創(chuàng)建數(shù)據(jù)庫對象前，清理（刪除）已存在于將要還原的數(shù)據(jù)庫中的數(shù)據(jù)庫對象。
日志打印無開關(guān)，若需隱藏日志，請將日志重定向到日志文件。若恢復(fù)表數(shù)據(jù)時，數(shù)據(jù)量很大，會分批恢復(fù)，因此會多次出現(xiàn)“表數(shù)據(jù)已完成導(dǎo)入”的日志。

表 1 常用參數(shù)說明

參數(shù)	參數(shù)說明	舉例
-U	連接數(shù)據(jù)庫的用戶名。	-U jack
-W	指定用戶連接的密碼。如果主機的認證策略是trust，則不會對數(shù)據(jù)庫管理員進行密碼驗證，即無需輸入-W選項；如果沒有-W選項，并且不是數(shù)據(jù)庫管理員，會提示用戶輸入密碼。	-W abcd@123
-d	連接數(shù)據(jù)庫dbname，并直接將數(shù)據(jù)導(dǎo)入到該數(shù)據(jù)庫中。	-d backupdb
-p	指定服務(wù)器所偵聽的TCP端口或本地Unix域套接字后綴，以確保連接。	-p 8000
-e	當(dāng)發(fā)送SQL語句到數(shù)據(jù)庫時如果出現(xiàn)錯誤，則退出。默認狀態(tài)下會忽略錯誤任務(wù)并繼續(xù)執(zhí)行導(dǎo)入，且在導(dǎo)入后會顯示一系列錯誤信息。	-
-c	在重新創(chuàng)建數(shù)據(jù)庫對象前，清理（刪除）已存在于將要導(dǎo)入的數(shù)據(jù)庫中的數(shù)據(jù)庫對象。	-
-s	只導(dǎo)入模式定義，不導(dǎo)入數(shù)據(jù)。當(dāng)前的序列值也不會被導(dǎo)入。	-

示例

特例：執(zhí)行g(shù)sql程序，使用如下選項導(dǎo)入由gs_dump/gs_dumpall生成導(dǎo)出文件夾（純文本格式）的MPPDB_backup.sql文件到postgres數(shù)據(jù)庫。

gsql -d postgres -p 15400 -W Bigdata@123 -f /home/omm/test/MPPDB_backup.sql
SET
SET
SET
SET
SET
ALTER TABLE
ALTER TABLE
ALTER TABLE
ALTER TABLE
ALTER TABLE
CREATE INDEX
CREATE INDEX
CREATE INDEX
SET
CREATE INDEX
REVOKE
REVOKE
GRANT
GRANT
total time: 30476  ms

gs_restore用來導(dǎo)入由gs_dump生成的導(dǎo)出文件。

示例1：執(zhí)行g(shù)s_restore，將導(dǎo)出的MPPDB_backup.dmp文件（自定義歸檔格式）導(dǎo)入到postgres數(shù)據(jù)庫。

gs_restore -W Bigdata@123 backup/MPPDB_backup.dmp -p 15400 -d postgres
gs_restore: restore operation successful
gs_restore: total time: 13053  ms

示例2：執(zhí)行g(shù)s_restore，將導(dǎo)出的MPPDB_backup.tar文件（tar格式）導(dǎo)入到postgres數(shù)據(jù)庫。

gs_restore backup/MPPDB_backup.tar -p 15400 -d postgres 
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 21203  ms

示例3：執(zhí)行g(shù)s_restore，將導(dǎo)出的MPPDB_backup文件（目錄格式）導(dǎo)入到postgres數(shù)據(jù)庫。

gs_restore backup/MPPDB_backup -p 15400 -d postgres
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 21003  ms

示例4：執(zhí)行g(shù)s_restore，使用自定義歸檔格式的MPPDB_backup.dmp文件來進行如下導(dǎo)入操作。導(dǎo)入PUBLIC模式下所有對象的定義和數(shù)據(jù)。在導(dǎo)入時會先刪除已經(jīng)存在的對象，如果原對象存在跨模式的依賴則需手工強制干預(yù)。

gs_restore backup/MPPDB_backup.dmp -p 15400 -d postgres -e -c -n PUBLIC
gs_restore: [archiver (db)] Error while PROCESSING TOC:
gs_restore: [archiver (db)] Error from TOC entry 313; 1259 337399 TABLE table1 gaussdba
gs_restore: [archiver (db)] could not execute query: ERROR:  cannot drop table table1 because other objects depend on it
DETAIL:  view t1.v1 depends on table table1
HINT:  Use DROP ... CASCADE to drop the dependent objects too.
    Command was: DROP TABLE public.table1;

手工刪除依賴，導(dǎo)入完成后再重新創(chuàng)建。

gs_restore backup/MPPDB_backup.dmp -p 15400 -d postgres -e -c -n PUBLIC
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 2203  ms

示例5：執(zhí)行g(shù)s_restore，使用自定義歸檔格式的MPPDB_backup.dmp文件來進行如下導(dǎo)入操作。只導(dǎo)入PUBLIC模式下表table1的定義。

gs_restore backup/MPPDB_backup.dmp -p 15400 -d postgres -e -c -s -n PUBLIC -t table1
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 21000  ms

示例6：執(zhí)行g(shù)s_restore，使用自定義歸檔格式的MPPDB_backup.dmp文件來進行如下導(dǎo)入操作。只導(dǎo)入PUBLIC模式下表table1的數(shù)據(jù)。

gs_restore backup/MPPDB_backup.dmp -p 15400 -d postgres -e -a -n PUBLIC -t table1
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 20203  ms