diff --git "a/content/zh/docs/DatabaseOMGuide/\347\211\251\347\220\206\345\244\207\344\273\275\344\270\216\346\201\242\345\244\215.md" "b/content/zh/docs/DatabaseOMGuide/\347\211\251\347\220\206\345\244\207\344\273\275\344\270\216\346\201\242\345\244\215.md" index 1672e3406adf6a2ec0bd5d31fe29181269ba645e..a82f584e7e5633be63ce68fbabee2148c4a092bb 100644 --- "a/content/zh/docs/DatabaseOMGuide/\347\211\251\347\220\206\345\244\207\344\273\275\344\270\216\346\201\242\345\244\215.md" +++ "b/content/zh/docs/DatabaseOMGuide/\347\211\251\347\220\206\345\244\207\344\273\275\344\270\216\346\201\242\345\244\215.md" @@ -1138,7 +1138,7 @@ gs\_probackup目前支持进度打印,会分别在文件备份、文件验证 ``` gs_probackup init -B backup_dir ``` - >![](public_sys-resources/icon-notice.png) **注意:** + >![](public_sys-resources/icon-notice.png) **注意:** >在非资源池化模式下,虽然指定目录下会创建wal子目录,但WAL文件(即pg_xlog文件)会存放在backups目录下。 2. 添加一个新的备份实例。gs\_probackup可以在同一个备份目录下存放多个数据库实例的备份。 @@ -1153,6 +1153,9 @@ gs\_probackup目前支持进度打印,会分别在文件备份、文件验证 gs_probackup backup -B backup_dir --instance instance_name -b backup_mode ``` + >![](public_sys-resources/icon-notice.png) **须知:** + >备份默认只会对pgdata-path路径下的内容进行备份,如果存在外目录或者绝对路径表空间,需要在备份时指定参数-E。 + 4. 从指定实例的备份中恢复数据。 ``` @@ -1161,6 +1164,7 @@ gs\_probackup目前支持进度打印,会分别在文件备份、文件验证 >![](public_sys-resources/icon-notice.png) **须知:** >在恢复备份前,必须先停止gaussdb进程,并且将原始实例目录(参数-D后面的目录)下面的内容清空。 >使用restore子命令前,应先停止gaussdb进程。 + >如果在备份时指定了外目录,在恢复时需要指定--external-mapping和--tablespace-mapping参数进行恢复。 ### 故障处理 diff --git a/content/zh/docs/ToolandCommandReference/gs_probackup.md b/content/zh/docs/ToolandCommandReference/gs_probackup.md index d094699d4336d6b5aadf6263c0cc6a9b204c9731..30c066866044ef220e55bed627a9aecaedc2718e 100644 --- a/content/zh/docs/ToolandCommandReference/gs_probackup.md +++ b/content/zh/docs/ToolandCommandReference/gs_probackup.md @@ -745,17 +745,20 @@ gs\_probackup工具的主要功能如下: 3. 创建指定实例的备份。在进行增量备份之前,必须至少创建一次全量备份。 ``` - gs_probackup backup -B backup-path --instance instance_name -b backup_mode + gs_probackup backup -B backup-path --instance instance_name -b backup_mode [-E external-directories-paths] ``` + >![](public_sys-resources/icon-notice.png) **须知:** + >备份默认只会对pgdata-path路径下的内容进行备份,如果存在外目录或者绝对路径表空间,需要在备份时指定参数-E。 4. 从指定实例的备份中恢复数据。 ``` - gs_probackup restore -B backup-path --instance instance_name -D pgdata-path -i backup_id + gs_probackup restore -B backup-path --instance instance_name -D pgdata-path -i backup_id [--external-mapping=OLDDIR=NEWDIR --tablespace-mapping=OLDDIR=NEWDIR] ``` >![](public_sys-resources/icon-notice.png) **须知:** >在恢复备份时,必须先将原始实例目录(参数-D后面的目录)下面的内容清空。 >使用restore子命令前,应先停止gaussdb进程。 + >如果在备份时指定了外目录,在恢复时需要指定--external-mapping和--tablespace-mapping参数进行恢复。 ## cm工具管理集群全量备份恢复流程(资源池化模式) @@ -779,7 +782,8 @@ gs\_probackup工具的主要功能如下: ``` gs_probackup backup -B backup-path --instance instance_name -b backup_mode -d db_name -p port ``` - **说明:** 此操作与非资源池化模式相同。 + >![](public_sys-resources/icon-notice.png) **须知:** + >备份默认只会对pgdata-path路径下的内容进行备份,如果存在外目录或者绝对路径表空间,需要在备份时指定参数-E。 4. 执行cm_ctl stop关闭集群。 @@ -837,7 +841,7 @@ gs\_probackup工具的主要功能如下: gs_probackup restore -B backup-path --instance instance_name -D pgdata-path -i backup_id kill -9 xxx(dssserver的pid) 或 dsscmd stopdss ``` - **说明:** 确保dssserver进程关闭后再执行后续操作 + **说明:** 确保dssserver进程关闭后再执行后续操作; 如果在备份时指定了外目录,在恢复时需要指定--external-mapping和--tablespace-mapping参数进行恢复。 10. 当要恢复的集群相对于备份来讲重新安装过或者不是原来的集群时,将步骤7拷贝的的文件覆盖到恢复的主机dn目录,否则跳过。 @@ -868,7 +872,7 @@ gs\_probackup工具的主要功能如下: ``` gs_probackup restore -B backup-path --instance instance_name -D pgdata-path -i backup_id -I incremental-mode ``` - **说明:** 在增量恢复时,无需先清空dn目录和磁阵,也不需要在备节点执行进行一系列操作,因此需要指定参数-I为lsn或checksum,不能指定为none。 + **说明:** 在增量恢复时,无需先清空dn目录和磁阵,也不需要在备节点执行进行一系列操作,因此需要指定参数-I为lsn或checksum,不能指定为none。如果在备份时指定了外目录,在恢复时需要指定--external-mapping和--tablespace-mapping参数进行恢复。 4. 关闭dssserver。 @@ -945,7 +949,7 @@ gs\_probackup工具的主要功能如下: gs_probackup restore -B backup-path --instance instance_name -D pgdata-path -i backup_id kill -9 xxx(dssserver的pid) 或 dsscmd stopdss ``` - **说明:** 确保dssserver进程关闭后再执行后续操作 + **说明:** 确保dssserver进程关闭后再执行后续操作; 如果在备份时指定了外目录,在恢复时需要指定--external-mapping和--tablespace-mapping参数进行恢复。 7. 当要恢复的集群相对于备份来讲重新安装过或者不是原来的集群时,将步骤7拷贝的的文件覆盖到恢复的主机dn目录,否则跳过。