#BACKUP ARCHIVELOG

# 通用描述

BACKUP ARCHIVELOG用于执行对当前数据库归档日志文件的备份。

只能在数据库状态为OPEN时备份数据库的归档日志文件，且归档模式必须为开启状态（使用ALTER DATABASE语句调整归档模式）。

该语句不适用于存算一体分布式集群部署。

通过DBA_ARCHIVE_BACKUPSET视图可以查询生成的备份集信息，通过V$BACKUP_PROGRESS视图可以查询备份的过程信息。

关于备份恢复的详细操作描述请参考备份与恢复。

# 语句定义

backup archivelog::=

语法图

代码

syntax

archive_log_range_specifier::=

语法图

代码

syntax

syntax::= ((
(FROM SCN | SCN BETWEEN integer AND | UNTIL SCN ) integer | 
(FROM SEQUENCE | SEQUENCE BETWEEN integer AND | UNTIL SEQUENCE ) integer [THREAD integer] | 
(FROM TIME | TIME BETWEEN date_string AND | UNTIL TIME ) date_string | ALL))

backupCommonSpecifier::=

语法图

代码

syntax

syntax::= (COMPRESSION [ALGORITHM (ZSTD|LZ4) [LOW|MEDIUM|HIGH]]|
ENCRYPTION [AES128|AES192|AES256|SM4] IDENTIFIED BY password|
PARALLELISM integer|
TAG tag_name|
FORMAT backup_path|
SECTION SIZE size_clause)
{" " (COMPRESSION [ALGORITHM (ZSTD|LZ4) [LOW|MEDIUM|HIGH]]|
ENCRYPTION [AES128|AES192|AES256|SM4] IDENTIFIED BY password|
PARALLELISM integer|
TAG tag_name|
FORMAT backup_path|
SECTION SIZE size_clause)}

# 1. archivelogRangeSpecifier

用于指定需备份的归档日志范围。

若范围区间内有指定的归档日志文件不存在（例如文件已被删除、某一序列号对应的归档日志文件暂未生成等）现象，备份操作会失败并提示错误码YAS-02544。

# 1.1. SCN

用于指定需备份的归档日志SCN范围，SCN为64位无符号整数。

通过V$ARCHIVED_LOG视图可以获取当前已存在的归档日志文件中第一条日志的SCN（FIRST_CHANGE#字段）、最后一条日志的SCN（NEXT_CHANGE#字段）以及其他详细信息。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG SCN BETWEEN 505411989407080448 AND 505412089999663104 FORMAT 'SCNRANGE' TAG 'SCNRANGE' COMPRESSION;

# 1.2. SEQUENCE

用于指定需备份的归档日志序列号范围，序列号为32位无符号整数。

通过GV$ARCHIVED_LOG/V$ARCHIVED_LOG视图可以获取当前已存在的归档日志文件的序列号（SEQUENCE#字段）以及其他详细信息。

在共享集群/分布式集群部署中，推荐使用SCN或TIME指定归档日志的备份范围。若采用序列号则执行1次BACKUP ARCHIVELOG SEQUENCE ...只能备份1个实例（默认为INST_ID=1的实例）上的归档日志文件，必须重复执行该语句并通过THREAD关键字指定不同的实例ID直至完成集群中所有实例上归档日志文件的备份。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG SEQUENCE BETWEEN 2 AND 10 FORMAT 'ASNRANGE' TAG 'ASNRANGE' PARALLELISM 8 SECTION SIZE 128M;

# 1.3. TIME

用于指定需备份的归档日志的时间范围，最早默认不早于当前环境的安装时间，最晚可以设置为未来时间但实际备份的内容截止于最大归档文件序列号所对应文件中的最后一条日志的SCN所对应的时间。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG TIME BETWEEN TO_DATE('2023-10-28 08:14:01','yyyy-mm-dd hh24:mi:ss') AND TO_DATE('2023-11-28 11:14:01','yyyy-mm-dd hh24:mi:ss') FORMAT 'TIMERANGE' TAG 'TIMERANGE' COMPRESSION;

# 1.4. FROM

在归档备份语句中，与SCN、SEQUENCE或TIME配合使用指定归档日志备份的起点。

指定FROM指令备份归档日志时，备份的终点为当前数据库已存在的最大归档文件序列号所对应文件中的最后一条日志，通过V$ARCHIVED_LOG视图可以获取当前已存在的归档日志文件相关信息。

若指定的起点大于（或晚于）终点，则提示错误码YAS-02541，没有符合条件的归档文件。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG FROM SCN 505412089999663104 FORMAT 'FROMSCN' TAG 'FROMSCN' COMPRESSION;

BACKUP ARCHIVELOG FROM SEQUENCE 10 FORMAT 'FROMASN' TAG 'FROMASN' PARALLELISM 8 SECTION SIZE 128M;

BACKUP ARCHIVELOG FROM TIME TO_DATE('2023-11-28 11:14:01','yyyy-mm-dd hh24:mi:ss')  FORMAT 'FROMTIME' TAG 'FROMTIME' COMPRESSION;

# 1.5. BETWEEN … AND …

在归档备份语句中，与SCN、SEQUENCE或TIME配合使用指定归档日志备份的区间。

指定BETWEEN …（起点） AND …（终点）指令备份归档日志时，备份的起点和终点均为指定值，通过V$ARCHIVED_LOG视图可以获取当前已存在的归档日志文件相关信息并按需选定起点和终点。

若指定的起点大于（或晚于）终点，则提示错误码YAS-02541，没有符合条件的归档文件。

# 1.6. UNTIL

在归档备份语句中，与SCN、SEQUENCE或TIME配合使用指定为归档日志备份的终点。

指定UNTIL指令备份归档日志时，备份的起点为当前数据库已存在的最小归档文件序列号所对应文件中的第一条日志，通过V$ARCHIVED_LOG视图可以获取当前已存在的归档日志文件相关信息。

若指定的终点小于（或早于）起点，则提示错误码YAS-02541，没有符合条件的归档文件。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG UNTIL SCN  505412089999663104 FORMAT 'UNTILSCN' TAG 'UNTILSCN' COMPRESSION;

BACKUP ARCHIVELOG UNTIL SEQUENCE 10 FORMAT 'UNTILASN' TAG 'UNTILASN' PARALLELISM 8 SECTION SIZE 128M;

BACKUP ARCHIVELOG UNTIL TIME TO_DATE('2023-11-28 11:14:01','yyyy-mm-dd hh24:mi:ss')  FORMAT 'UNTILTIME' TAG 'UNTILTIME' COMPRESSION;

# 2. backupCommonSpecifier

用于指定备份操作的压缩、加密、并行度等通用配置。

# 2.1. COMPRESSION

指定备份集的压缩属性，包括压缩算法和压缩级别。若仅指定COMPRESSION关键字（算法与级别均省略）则默认采用ZSTD算法和LOW级别进行压缩。

增量备份的每个备份集允许采用不同的压缩算法及级别，不影响对其的恢复。

压缩算法

压缩算法通过ALGORITHM关键字指定，支持以下算法：

ZSTD：压缩率相对更高。
LZ4：压缩速率相对更高。

压缩级别

压缩级别包括：

LOW（表示最低的压缩率，相应压缩速度最高）
MEDIUM
HIGH

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG ALL COMPRESSION;
BACKUP ARCHIVELOG SEQUENCE BETWEEN 2 AND 10 COMPRESSION ALGORITHM lz4 HIGH;

# 2.2. ENCRYPTION

指定备份集的加密属性，包括加密算法和密钥。若不明确指定加密算法，则默认采用SM4。

增量备份的每个备份集需要保证统一的都加密或都不加密，且每个备份集的密钥必须保持一致。

加密算法

支持以下加密算法：

AES128
AES192
AES256
SM4

密钥

加密备份时的密钥通过IDENTIFIED BY关键字指定，密钥的约束规则同数据库用户的密码规则。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG ALL ENCRYPTION IDENTIFIED BY 12345;

# 2.3. PARALLELISM

指定多线程备份的并行度，取值范围为[1,16]，省略时默认为2。

# 2.4. TAG

指定备份集的别名，该别名最大长度为64（包含结束符'\0'）。

# 2.5. FORMAT

指定备份集文件名称（可包含路径），省略则默认为$YASDB_DATA/backup/bak_{date}。若指定时未包含路径，默认创建在$YASDB_DATA/backup文件夹下。

在共享集群/分布式集群部署中，可指定为YFS路径将备份集保存至共享存储，若指定为本地路径则将备份集保存至实例所在服务器上。

# 2.6. SECTION SIZE

指定文件的分片规格，超过该值的文件会被拆分为多个小文件执行备份，取值范围为[128M,32T]，省略时默认为系统自动计算的最优值。

配置建议如下：

建议结合实际的数据文件大小指定分片规格。

假设当前YashanDB中单个数据文件最大大小为MAXSIZE，建议分片规格小于MAXSIZE/(PARALLELISM*2)。
建议分片规格小于4G。

若指定的数值不是1M的整数倍，会向下取整按1M对齐。

# 2.7. SECTION SIZE

指定文件的分片规格，超过该值的文件会被拆分为多个小文件执行备份，取值范围为[128M,32T]，省略时默认为系统自动计算的最优值。

配置建议如下：

建议结合实际的数据文件大小指定分片规格。

假设当前YashanDB中单个数据文件最大大小为MAXSIZE，建议分片规格小于MAXSIZE/(PARALLELISM*2)。
建议分片规格小于4G。

若指定的数值不是1M的整数倍，会向下取整按1M对齐。

示例（单机/共享集群/分布式集群部署）

BACKUP ARCHIVELOG ALL COMPRESSION PARALLELISM 8 SECTION SIZE 128M;