disql备份还原

disql备份还原

前言

本文档根据官方文档，进行整理。

一、概述

在 disql 工具中使用 BACKUP 语句你可以备份整个数据库。通常情况下，在数据库实例配置归档后输入以下语句即可备份数据库：

BACKUP DATABASE BACKUPSET 'db_bak_01';

语句执行完后会在默认的备份路径下生成名为“db_bak_01”的备份集目录。默认的备份路径为 dm.ini 中 BAK_PATH 配置的路径，若未配置 BAK_PATH，则默认使用 SYSTEM_PATH 下的 bak 目录。这是最简单的数据库备份语句，如果要设置其他的备份选项需了解联机备份数据库的语法。

1、语法

BACKUP DATABASE[<备份类型>] [<指定备份集子句>] [TO <备份名>] [BACKUPSET '<备份集路径>'] [DEVICE TYPE <介质类型> [PARMS '<介质参数>']] 
[BACKUPINFO '<备份描述>'] [MAXPIECESIZE <备份片限制大小>] 
[LIMIT <read_limit>|<write_limit>] 
[IDENTIFIED BY <密码>|"<密码>" [WITH ENCRYPTION <TYPE>][ENCRYPT WITH <加密算法>]]
[COMPRESSED [LEVEL <压缩级别>]] [WITHOUT LOG][WITHOUT MIRROR]
[TRACE FILE '<TRACE文件名>'] [TRACE LEVEL <TRACE日志级别>] 
[TASK THREAD <线程数>][PARALLEL [<并行数>] [READ SIZE <拆分块大小>]];
<备份类型>::= FULL|
			[FULL] DDL_CLONE|
			[FULL] SHADOW|
			INCREMENT <increment_statement>
<increment_statement>::= [FROM LSN <lsn>] | <inc_sub_statement>
<inc_sub_statement>::= [CUMULATIVE][<指定基备份子句>]
<指定基备份子句>::= BASE ON BACKUPSET '<基备份目录>'
<指定备份集子句>：：= WITH BACKUPDIR ‘<备份集搜索路径>’{,‘<备份集搜索路径>’}
<read_limit>::= READ SPEED <读速度上限> [WRITE SPEED <写速度上限>]
<write_limit>::= WRITE SPEED <写速度上限>

参数说明：

注意

增量备份时，DM不会在默认备份目录或当前备份目录的子目录中搜索基备份集，因此若基备份集在默认备份目录或当前备份目录的子目录中，则需要指定基备份的搜索目录或直接指定基备份集路径，否则将无法搜索到相应的基备份集，备份操作将会失败。

2、常用的备份命令

2.1 设置联机备份路径(BACKUPSET)

• 指定备份集路径为“/dmdata/dmbak/db_bak_3_01”

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_3_01';

2.2 设置备份名(TO)

• 创建备份集，备份名设置为“FULLBAK01”,备份路径为what

BACKUP DATABASE TO FULLBAK01 BACKUPSET 'what'

备份集名称为FULLBAK01 ，保存路径是/dmdata/dmbak/what

2.3 添加备份描述(BACKUPINFO)

• 创建备份为备份集添加描述信息为“测试备份”

BACKUP DATABASE BACKUPINFO '测试备份';

2.4 限制备份片大小(MAXPIECESIZE)

• 创建备份限制备份片大小为 300MB

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_3_05' MAXPIECESIZE 300;

2.5 备份压缩(COMPRESSED LEVEL)

• 执行备份压缩，压缩级别设置为 5

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_3_06' COMPRESSED LEVEL 5;

2.6 并行备份(PARALLEL)

• 创建并行备份，指定并行数为 8

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_3_07' PARALLEL 8;

二、数据备份

1、数据库备份

执行数据库备份，数据库必须处于 OPEN 状态，MOUNT 和 SUSPEND 状态下不允许执行数据库备份。，除此之外，还要运行在归档模式

1.1 完全备份

完全备份数据库步骤如下：

1. 配置归档；
2. 保证数据库处于 OPEN 状态；
3. DIsql 中输入备份数据库语句，最简单的不设置其他参数的完全备份语句如下：

BACKUP DATABASE FULL BACKUPSET '/dmdata/dmbak/db_full_bak_01';

备份语句中的参数 FULL 可以省略，不指定备份类型会默认指定备份类型为完全备份。

1.2 增量备份

增量备份指基于指定的库（或者表空间）的某个备份（完全备份或者增量备份），备份自该备份以来所有发生修改的数据页。

增量备份数据库步骤如下：

1. 配置归档；

2. 保证数据库处于 OPEN 状态；

3. disql 中输入备份数据库语句

1.2.1 差异增量备份

• 最简单的不设置其他参数的增量备份语句如下：

BACKUP DATABASE INCREMENT WITH BACKUPDIR '/dmdata/dmbak' BACKUPSET '/dmdata/dmbak/db_increment_bak_02';

• 指定基备份集路径/dmdata/dmbak/DB_DAMENG_FULL_20240210_163606_932454

BACKUP DATABASE INCREMENT BASE ON BACKUPSET '/dmdata/dmbak/DB_DAMENG_FULL_20240210_163606_932454' BACKUPSET '/dmdata/dmbak/INC';

以/dmdata/dmbak/DB_DAMENG_FULL_20240210_163606_932454这个备份集作为基备份集

• 指定基备份扫描路径/dmdata/dmbak

BACKUP DATABASE INCREMENT WITH BACKUPDIR '/dmdata/dmbak' BACKUPSET 'DB_DAMENG_INCRE_2024_02_10_16_52_32';

扫描目录'/dmdata/dmbak'，找到其中最新的备份集，将其作为基备份集。

WITH BACKUPDIR 参数用来指定基备份集的搜索目录

1.2.2 累积增量备份

BACKUP DATABASE INCREMENT CUMULATIVE;

2、表空间备份

在 disql 工具中使用 BACKUP 语句也可以备份单个表空间。同备份数据库一样，执行表空间备份数据库实例也必须运行在归档模式下

2.1 语法

BACKUP TABLESPACE <表空间名> [FULL | INCREMENT <increment_statement>] [<指定备份集子句>] [TO  <备份名>] [BACKUPSET '<备份集路径>'][DEVICE TYPE <介质类型> [PARMS '<介质参数>']]
[BACKUPINFO '<备份描述>'] [MAXPIECESIZE <备份片限制大小>] 
[LIMIT <read_limit>|<write_limit>] 
[IDENTIFIED BY <密码>|"<密码>" [WITH ENCRYPTION<TYPE>][ENCRYPT WITH <加密算法>]] [COMPRESSED [LEVEL <压缩级别>]][WITHOUT LOG][WITHOUT MIRROR]
[TRACE FILE '<TRACE文件名>'] [TRACE LEVEL <TRACE日志级别>]
[TASK THREAD <线程数>][PARALLEL [<并行数>][READ SIZE <拆分块大小>]];
<inc_sub_statement>::= 参考3.2.2.1.1概述
<read_limit>::= READ SPEED <读速度上限> [WRITE SPEED <写速度上限>]
<write_limit>::= WRITE SPEED <写速度上限>

2.2 完全备份

• 备份MAIN表空间

BACKUP TABLESPACE MAIN BACKUPSET 'ts_bak_01';

2.3 增量备份

下面以增量备份用户 MAIN 表空间为例

BACKUP TABLESPACE MAIN BACKUPSET 'ts_full_bak_01';
BACKUP TABLESPACE MAIN INCREMENT BACKUPSET 'ts_increment_bak_01';
BACKUP TABLESPACE MAIN INCREMENT BASE ON BACKUPSET 'ts_full_bak_01' BACKUPSET 'ts_increment_bak_02';

上述示例中，增量备份 ts_increment_bak_02 若不指定备份集 ts_full_bak_01 作为基备份，那么默认会使用最近一次的备份集 ts_increment_bak_01 作为基备份。

3、表备份

与备份数据库与表空间不同，备份表不需要服务器配置归档。

3.1 语法

BACKUP TABLE <表名> [TO <备份名>] [BACKUPSET '<备份集路径>'] 
[DEVICE TYPE <介质类型> [PARMS '<介质参数>']] [BACKUPINFO '<备份描述>'] [MAXPIECESIZE <备份片限制大小>] [LIMIT <read_limit>|<write_limit>] 
[IDENTIFIED BY <密码>|"<密码>" [WITH ENCRYPTION <TYPE>][ENCRYPT WITH <加密算法>]] 
[COMPRESSED [LEVEL <压缩级别>]]
[TRACE FILE '<TRACE文件名>'] [TRACE LEVEL <TRACE日志级别>];
<read_limit>::= READ SPEED <读速度上限> [WRITE SPEED <写速度上限>]
<write_limit>::= WRITE SPEED <写速度上限>

使用说明：

1. 仅支持对用户的非分区的行存储表和堆表进行备份，不支持对分区表的备份。在非分区表中，也不支持对临时表、物化视图表、物化视图附属表、日志表和特定模式（DBG_PKG/INFORMATION_SCHEMA/INFO_SCHEM/SYSREP/SYSGEO/SYSJOB/SYSCPT/SYS）下的表进行表备份。
2. 表的**列类型为对象类型的表不支持表备份**。
3. 表备份不备份表上的注释以及 default 表达式中的函数定义，因此还原时需用户自行确认。
4. 不支持在加密库上进行表备份与还原。
5. 当备份数据超过限制大小时，会生成新的备份文件，新的备份文件名是初始文件名后加文件编号。
6. 表备份时，其所属表空间必须处于联机状态。
7. 目前表备份不支持备份到 TAPE 介质上。

3.2 完整备份步骤

1. 保证数据库处于 OPEN 状态；
2. 创建待备份的表 TAB_01：

CREATE TABLE TAB_01(C1 INT);

3. disql 中输入备份表语句，简单的备份语句如下：

BACKUP TABLE TAB_01 BACKUPSET '/dmdata/dmbak/tab_bak_01';

4、归档备份

4.1 归档备份前提

1. 归档文件的 db_magic、permanent_magic 值和库的 db_magic、permanent_magic 值必须一样；

2. 服务器必须配置归档；

3. 归档日志必须连续，如果出现不连续的情况，前面的连续部分会忽略，仅备份最新的连续部分。如果备份时未收集到指定范围内的归档，则直接报错。联机备份的时候经常会切换归档文件，最后一个归档总是空的，所以最后一个归档不会被备份。

4.2 语法

BACKUP <ARCHIVE LOG |ARCHIVELOG> [ALL | [FROM LSN <lsn>]| [UNTIL LSN <lsn>]|
[LSN BETWEEN <lsn> AND <lsn>] | [FROM TIME '<time>']|[UNTIL TIME '<time>']|
[TIME BETWEEN'<time>'> AND '<time>']][<notBackedUpSpec>][<指定备份集子句>][DELETE INPUT]
[TO <备份名>][<备份集子句>];
<备份集子句>：：=BACKUPSET ['<备份集路径>'][DEVICE TYPE <介质类型> [PARMS '<介质参数>']]
[BACKUPINFO '<备份描述>'] [MAXPIECESIZE <备份片限制大小>] 
[LIMIT <read_limit>|<write_limit>] 
[IDENTIFIED BY <密码>|"<密码>" [WITH ENCRYPTION <TYPE>][ENCRYPT WITH <加密算法>]]
[COMPRESSED [LEVEL <压缩级别>]] [WITHOUT LOG]
[TRACE FILE '<TRACE文件名>'] [TRACE LEVEL <TRACE日志级别>]
[TASK THREAD <线程数>][PARALLEL [<并行数>][READ SIZE <拆分块大小>]]
<notBackedUpSpec>::=NOT BACKED UP [<num> TIMES]|[SINCE TIME '<datetime_string>']
<read_limit>::= READ SPEED <读速度上限> [WRITE SPEED <写速度上限>]
<write_limit>::= WRITE SPEED <写速度上限>

参数说明：

4.3 备份步骤

1. 配置归档；
2. 保证数据库处于 OPEN 或者 MOUNT 状态；
3. DIsql 中输入备份数据库语句。

如何通过 LSN BETWEEN … AND …来指定起始和截至 LSN

• 首先，确定 LSN 范围

select ARCH_LSN, CLSN, PATH from V$ARCH_FILE;

ARCH_LSN             CLSN                 PATH
----------- ---------- ------------------------------------------------------------------
314973      315394     /dmdata/arch/ARCHIVE_LOCAL1_0x2DFFFDD8_EP0_2024-02-10_21-50-01.log
315395      315713     /dmdata/arch/ARCHIVE_LOCAL1_0x2DFFFDD8_EP0_2024-02-10_21-57-56.log
……
//通过查询结果选出备份的起始LSN和截至LSN。比如315395	315713

• 备份归档

BACKUP ARCHIVELOG LSN BETWEEN 315395 AND 315713 BACKUPSET '/dmdata/dmbak/arch_bak_time_14-78';

三、数据备份高级

DM 的数据库、表空间、表备份和归档备份**均支持创建加密备份和备份时设置跟踪日志文件**，本节仅以数据库备份为例说明这两种类型备份的创建。

1、加密备份

备份语句中通过指定 IDENTIFIED BY…WITH ENCRYPTION…ENCRYPT WITH…执行加密备份。其中，IDENTIFIED BY 子句指定加密密码，密码长度为 9 到 48 个字节，若密码长度不符合要求会报错；

WITH ENCRYPTION 子句指定加密类型，加密类型分为简单加密和复杂加密，简单加密是对备份文件设置口令，但文件内容仍以明文存储，复杂加密则对备份文件进行完全的加密，备份文件以密文方式存储，用户可根据备份数据的重要程度选择加密类型；ENCRYPT WITH 子句指定加密算法，默认使用的加密算法为 AES256_CFB。

加密备份过程中 IDENTIFIED BY 子句必须指定，子句 WITH ENCRYPTION 和子句 ENCRYPT WITH 可不指定，此时 WITH ENCRYPTION 默认值为 1，ENCRYPT WITH 默认值为 AES256_CFB。

• 简单加密

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_for_encrypt' IDENTIFIED BY "cdb546789";

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_for_encrypt' IDENTIFIED BY "cdb546789" ENCRYPT WITH RC4;

• 复杂加密

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_for_encrypt' IDENTIFIED BY "cdb546789" WITH ENCRYPTION 2;

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_for_encrypt' IDENTIFIED BY "cdb546789" WITH ENCRYPTION 2 ENCRYPT WITH RC4;

• 若指定了加密密码，但加密类型 WITH ENCRYPTION 指定为 0，则为非加密备份

BACKUP DATABASE BACKUPSET '/dmdata/dmbak/db_bak_for_encrypt' IDENTIFIED BY "cdb546789" WITH ENCRYPTION 0;

注意：

• 对于增量备份加密，如果基备份存在加密，则增量备份使用的加密密码、加密类型和加密算法必须与基备份保持一致；
• 如果基备份未进行加密处理，则对增量备份使用的加密密码、加密类型和加密算法没有特殊要求。

2、设置跟踪日志文件

DM 备份时支持设置 SBT 接口跟踪日志文件，日志记录了 SBT 接口的调用过程，用户通过查看日志可跟踪备份还原过程。

与生成跟踪日志文件相关的参数有两个：TRACE FILE 和 TRACE LEVEL。 TRACE FILE 用于指定生成的跟踪日志文件路径，TRACE LEVEL 表示是否启用 TRACE。TRACE LEVEL 有效值包括 1 和 2。1 表示不启用 TRACE 功能，2 表示启用，系统默认值为 1。

2.1 指定TRACE FILE

• TRACE LEVEL = 1（默认值）

-- 下面两个语句等价，1.log日志内容为空，保存在$DM_HOME/bin/1.log
backup database trace file '1.log';   
backup database trace file '1.log' trace level 1;

指定参数 TRACE FILE 但 TRACE LEVEL 值设置为 1 即不启用 TRACE 功能，则会生成 TRACE 文件，但不会写入 TRACE 信息。

• TRACE LEVEL = 2

backup database trace file '2.log' trace level 2;  -- 2.log日志内容不为空，保存在$DM_HOME/bin/2.log
backup database trace file '/dmdata/3.log' trace level 2;  -- 3.log日志内容不为空，保存在/dmdata/3.log

注意：

• 若 TRACE FILE 使用相对路径，日志文件生成在执行码同级目录下**$DM_HOME/bin**。
• 若 TRACE FILE 使用绝对路径，日志文件生成在指定的绝对路径。
• 如果指定的 TRACE 文件已存在，则报错。

2.2 不指定TRACE FILE

• TRACE LEVEL = 2

backup database trace level 2;  -- 在$DM_HOME/log路径下生成.log文件

TRACE LEVEL 值设置为 2 即启用 TRACE 功能，但若 TRACE FILE 没有指定，则系统默认在执行码路径的 log 目录$DM_HOME/log生成 DM_SBTTRACE_年月.log 文件。

四、管理备份

1、备份管理相关系统过程与函数总结

1.1 函数

1.2 过程

注意：

上面函数存储过程的使用说明，内容太多，参考官方文档。

2、备份管理相关动态视图总结

五、数据还原

DM 仅支持表的联机还原，数据库、表空间和归档日志的还原必须通过脱机工具 DMRMAN 执行。

1、表还原

表还原之后不需要恢复操作。

1.1 语法

RESTORE TABLE [<表名>] [STRUCT] [KEEP TRXID] 

FROM BACKUPSET'<备份集路径>' [DEVICE TYPE <介质类型> [PARMS '<介质参数>']] 

[IDENTIFIED BY <密码>|"<密码>" [ENCRYPT WITH <加密算法>]] 

[TRACE FILE '<TRACE文件名>'] [TRACE LEVEL <TRACE日志级别>];

1.2 还原限制

• 仅支持对普通用户表进行还原，包括堆表。其中，系统表、临时表、物化视图表、物化视图附属表、日志表以及特定模式（DBG_PKG/INFORMATION_SCHEMA/INFO_SCHEM/SYSREP/SYSGEO/SYSJOB/SYSCPT/SYS）下的表不支持还原。

• 列类型为对象类型的表不支持表还原。

• 若还原表中存在位图连接索引和位图连接虚索引则不支持还原。

• 若为加密库，表还原时要求源库与目标库加密算法一致。

• 备份集路径指备份集所在目录，其中应包含完整备份数据，包括元数据文件(.meta)和备份片文件(.bak)。仅支持从表备份集中还原表。

• 表名设置为可选参数。若指定，则数据库中必须存在该表且表定义必须与备份表严格一致；若不指定，则使用备份集中记录的备份表作为还原目标表。

• 还原时若不指定目标表，则表还原操作需要 DBA 权限；若指定目标表，则目标表的创建者可以进行表还原操作。

• 目标表所在的表空间必须处于联机状态。

• 数据守护环境下，主库允许表备份还原，备库不允许。

• MOUNT 和 SUSPEND 状态下不允许进行表还原，必须处于OPEN状态。

• MPP 环境不允许进行表还原。

• 若在语句中指定 STRUCT 关键字，则执行表结构还原。表结构还原会根据备份集中备份表还原要求，对目标表定义进行校验，并删除目标表中已存在的二级索引和约束。

• 若不指定 STRUCT 关键字，则执行表数据还原，表数据还原默认仅会将备份表中聚集索引上的数据进行还原。表数据还原默认仅会在目标表定义与备份表一致且不存在二级索引和约束的情况下执行。

• 若在未指定 STRUCT 的情况下，执行还原出现存在二级索引或冗余约束的错误，或在不指定目标表的情况下，报目标不存在的错误，可先执行 STRUCT 还原后，再继续执行实际数据的还原。

• 若用户指定 TRACE FILE，则指定的文件不能为已经存在的文件，否则报错；也不可以为 ASM 文件。

• 若表中存在大字段列，且表备份时 INI 参数 BLOB_OUTROW_REC_STOR 大于 0，但建立还原目标表时 INI 参数 BLOB_OUTROW_REC_STOR 等于 0，那么若大字段列存在行外数据，则在执行表还原时会报错，且表数据会丢失。

• 表还原不检查目标表的缺省表达式（default 值）。

• 若表列进行了加密，则表还原时不能跨库或跨表还原，只能还原到自身。

1.3. 不包含索引或约束的还原步骤

1. 保证数据库为 OPEN 状态；
2. 创建待备份的表

CREATE TABLE TAB_FOR_RES_01(C1 INT);

3. 备份表数据

BACKUP TABLE TAB_FOR_RES_01 BACKUPSET '/dmdata/dmbak/tab_bak_for_res_01';

4. 校验备份，此步骤为可选

SELECT SF_BAKSET_CHECK('DISK','/dmdata/dmbak/tab_bak_for_res_01');

5. 还原表数据

RESTORE TABLE TAB_FOR_RES_01 FROM BACKUPSET '/dmdata/dmbak/tab_bak_for_res_01';

1.4 包含索引或约束的还原步骤

1. 保证数据库为 OPEN 状态；
2. 创建待备份的表

CREATE TABLE TAB_FOR_RES_02(C1 INT);

3. 创建索引

CREATE INDEX I_TAB_FOR_RES_02 ON TAB_FOR_RES_02(C1);

4. 备份表

BACKUP TABLE TAB_FOR_RES_02 BACKUPSET '/dmdata/dmbak/tab_bak_for_res_02';

5. 校验备份，此步骤为可选

SELECT SF_BAKSET_CHECK('DISK','/dmdata/dmbak/tab_bak_for_res_02');

6. 执行表结构还原，表备份和目标表中都包含索引，如果直接执行表数据还原会报错：还原表中存在二级索引或冗余约束

RESTORE TABLE TAB_FOR_RES_02 STRUCT FROM BACKUPSET '/dmdata/dmbak/tab_bak_for_res_02';

7. 执行表数据还原

RESTORE TABLE TAB_FOR_RES_02 FROM BACKUPSET '/dmdata/dmbak/tab_bak_for_res_02';

1.5 指定还原时不重建索引

表备份时会默认备份表中的索引，还原时使用 RESTORE TABLE...WITHOUT INDEX...语句可选择不还原索引

1. 建表跟索引

CREATE TABLE TAB_FOR_IDX_01(C1 INT);

CREATE INDEX I_TAB_FOR_IDX_01 ON TAB_FOR_IDX_01 (C1);

2. 备份（略）

3. 还原，但不重建索引

RESTORE TABLE TAB_FOR_RES WITHOUT INDEX FROM BACKUPSET '/dmdata/dmbak/tab_bak_for_res_01';

1.6 指定还原时不重建约束

表备份时会默认备份表中的索引定义，还原时使用 RESTORE TABLE...WITHOUT CONSTRAINT...语句可选择还原时不重建约束

1. 建表跟索引

CREATE TABLE TAB_FOR_CONS_01(C1 INT);

CREATE INDEX I_TAB_FOR_CONS_01 ON TAB_FOR_CONS_01 (C1);

2. 备份（略）

3. 还原，但不重建约束

RESTORE TABLE TAB_FOR_RES WITHOUT CONSTRAINT FROM BACKUPSET '/dmdata/dmbak/tab_bak_for_res_01';

达梦社区：https://eco.dameng.com