一篇文章教會你使用gs_restore導入數(shù)據(jù)

更新時間：2022年09月05日 16:04:07 作者：大話數(shù)據(jù)庫

gs_restore是GaussDB(DWS)提供的針對gs_dump導出數(shù)據(jù)的導入工具,下面這篇文章主要給大家介紹了關(guān)于如何通過一篇文章教會你使用gs_restore導入數(shù)據(jù)的相關(guān)資料,需要的朋友可以參考下

背景信息

gs_restore是openGauss提供的針對gs_dump導出數(shù)據(jù)的導入工具。通過此工具可將由gs_dump生成的導出文件進行導入。

gs_restore工具由操作系統(tǒng)用戶omm執(zhí)行。

主要功能包含：

導入到數(shù)據(jù)庫

如果連接參數(shù)中指定了數(shù)據(jù)庫，則數(shù)據(jù)將被導入到指定的數(shù)據(jù)庫中。其中，并行導入必須指定連接的密碼。導入時生成列會自動更新，并像普通列一樣保存。

導入到腳本文件

如果未指定導入數(shù)據(jù)庫，則創(chuàng)建包含重建數(shù)據(jù)庫所必須的SQL語句腳本并寫入到文件或者標準輸出。等效于直接使用gs_dump導出為純文本格式。

命令格式

gs_restore [OPTION]... FILE

說明：

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

表 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ù)導入到該數(shù)據(jù)庫中。	-d backupdb
-p	指定服務(wù)器所偵聽的TCP端口或本地Unix域套接字后綴，以確保連接。	-p 8000
-e	當發(fā)送SQL語句到數(shù)據(jù)庫時如果出現(xiàn)錯誤，則退出。默認狀態(tài)下會忽略錯誤任務(wù)并繼續(xù)執(zhí)行導入，且在導入后會顯示一系列錯誤信息。	-
-c	在重新創(chuàng)建數(shù)據(jù)庫對象前，清理（刪除）已存在于將要導入的數(shù)據(jù)庫中的數(shù)據(jù)庫對象。	-
-s	只導入模式定義，不導入數(shù)據(jù)。當前的序列值也不會被導入。	-

示例

特例：執(zhí)行g(shù)sql程序，使用如下選項導入由gs_dump/gs_dumpall生成導出文件夾（純文本格式）的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用來導入由gs_dump生成的導出文件。

示例1：執(zhí)行g(shù)s_restore，將導出的MPPDB_backup.dmp文件（自定義歸檔格式）導入到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，將導出的MPPDB_backup.tar文件（tar格式）導入到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，將導出的MPPDB_backup文件（目錄格式）導入到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文件來進行如下導入操作。導入PUBLIC模式下所有對象的定義和數(shù)據(jù)。在導入時會先刪除已經(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;

手工刪除依賴，導入完成后再重新創(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文件來進行如下導入操作。只導入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文件來進行如下導入操作。只導入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