本节主要介绍如何使用 OceanBase 数据库的备份功能进行备份。

备份前准备

  1. 使用 sys 租户的 root 用户登录数据库。

  2. 根据业务需要，配置 backup_region 配置项。

    该配置项用于控制数据备份的 Region。配置后，系统会优先执行指定 Region 的调度备份任务；如果不配置，则会执行所有 Region 的调度备份任务。

  3. 配置备份目的地。

    在进行备份前，需要执行 ALTER SYSTEM 语句配置备份的目的地。目前，OceanBase 数据库支持 NFS 、 OSS 文件系统和腾讯云 COS 作为备份目的地 。

    例如：

    • NFS

      1. obclient> ALTER SYSTEM SET backup_dest='file:///data/nfs/backup';

    • OSS

      1. obclient> ALTER SYSTEM SET backup_dest='oss://antsys-oceanbasebackup/backup_rd/?host=cn-hangzhou-alipay-b.oss-cdn.aliyun-inc.com&access_id=xxx&access_key=xxx';

    • 腾讯云 COS

      1. obclient> ALTER SYSTEM SET backup_dest='cos://backup-1304745170/backup_rd/20210127?host=cos.ap-nanjing.myqcloud.com&access_id=xxx&access_key=xxx&appid=xxx';

  4. （可选）开启归档日志压缩功能。

    执行以下语句开启归档日志压缩，默认使用压缩算法 lz4_1.0。

    1. obclient> ALTER SYSTEM SET backup_log_archive_option='compression= enable';

    日志压缩支持动态修改压缩算法，目前支持的压缩算法有：zstd_1.3.8 和 lz4_1.0。如果需要使用其他压缩算法，则可以执行以下命令：

    1. obclient> ALTER SYSTEM SET backup_log_archive_option='compression= zstd_1.3.8';
    3. obclient> ALTER SYSTEM SET backup_log_archive_option='compression= lz4_1.0';

    说明

    开启后，后续如果需要关闭归档日志压缩功能，可执行 ALTER SYSTEM SET backup_log_archive_option='compression= disable'; 语句关闭。

  5. （可选）配置备份模式。

    备份支持 optional 模式和 mandatory 模式：

    • optional 模式表示以用户业务优先。在该模式下，当备份（日志归档）来不及的情况下，日志可能来不及备份就回收了，可能会发生备份断流。

    • mandatory 模式表示以备份优先。在该模式下如果备份跟不上用户数据的写入，可能会导致用户无法写入。

    默认为 optional 模式，两种模式之间可以切换。切换配置模式的示例命令如下：

    1. obclient> ALTER SYSTEM SET backup_log_archive_option = 'optional';
    3. obclient> ALTER SYSTEM SET backup_log_archive_option = 'mandatory';

    说明

    您也可以使用 ALTER SYSTEM SET backup_log_archive_option = 'optional compression= enable'; 命令同时配置备份模式并开启归档日志压缩功能。

  6. 执行以下语句，启动 OceanBase 数据库的归档功能。

    1. obclient> ALTER SYSTEM ARCHIVELOG;

    启动成功后，OceanBase 数据库会自动将集群产生的事务日志定期备份到之前指定的备份目的地。

  7. 执行以下语句，确认日志备份任务是否已开始。

    1. obclient> SELECT * FROM CDB_OB_BACKUP_ARCHIVELOG_SUMMARY;

    当 STATUS 为 DOING 时，表示日志备份任务已开始。

全量备份

  1. 使用 sys 租户的 root 用户登录数据库。

  2. 在执行全量备份前，执行以下语句，对集群进行一次合并。

    1. obclient> ALTER SYSTEM MAJOR FREEZE;

  3. 执行以下语句，查看合并进度。

    1. obclient> SELECT * FROM __all_zone WHERE name='merge_status';

    结果如下所示：

    1. +----------------------------+----------------------------+-------+--------------+-------+------+
    2. | gmt_create                 | gmt_modified               | zone  | name         | value | info |
    3. +----------------------------+----------------------------+-------+--------------+-------+------+
    4. | 2020-05-26 17:50:11.107352 |  2020-05-26 17:50:45.871523 |       | merge_status |     0 | IDLE |
    5. | 2020-05-26 17:50::11.109678 |  2020-05-26 17:50:55.780264 | zone1 | merge_status |     0 | IDLE |
    6. +----------------------------+----------------------------+-------+--------------+-------+------+

    当 info 为 IDLE 时，则表示合并结束。

  4. 执行以下语句，进行集群的全量备份。

    1. obclient> ALTER SYSTEM BACKUP DATABASE;

    备份过程中，您可以通过执行以下语句，在视图中查看备份任务的状态和详细信息：

    • 查看正在备份的任务

      1. obclient> SELECT * FROM CDB_OB_BACKUP_PROGRESS;

      示例结果如下：

      1. obclient> SELECT * FROM CDB_OB_BACKUP_PROGRESS; 
      2. +-------------+--------+-------------+-----------+-----------------+-------------------+------------------------+--------------------------+-------------+--------------+----------------------------+----------------------------+---------+
      3. | INCARNATION | BS_KEY | BACKUP_TYPE | TENANT_ID | PARTITION_COUNT | MACRO_BLOCK_COUNT | FINISH_PARTITION_COUNT | FINISH_MACRO_BLOCK_COUNT | INPUT_BYTES | OUTPUT_BYTES | START_TIME                 | COMPLETION_TIME            | STATUS  |
      4. +-------------+--------+-------------+-----------+-----------------+-------------------+------------------------+--------------------------+-------------+--------------+----------------------------+----------------------------+---------+
      5. |           1 |      3 | I           |         1 |               0 |                 0 |                      0 |                        0 |           0 |            0 | 2020-09-16 11:51:21.743752 | 2020-09-16 11:51:22.624217 | RUNNING |
      6. |           1 |      3 | I           |      1001 |             119 |                 0 |                      0 |                        0 |           0 |            0 | 2020-09-16 11:51:21.743752 | 2020-09-16 11:51:22.281717 | RUNNING |
      7. |           1 |      3 | I           |      1002 |            5317 |                 0 |                      0 |                        0 |           0 |            0 | 2020-09-16 11:51:21.743752 | 2020-09-16 11:51:22.064521 | RUNNING |
      8. +-------------+--------+-------------+-----------+-----------------+-------------------+------------------------+--------------------------+-------------+--------------+----------------------------+----------------------------+---------+
      9. 3 rows in set (0.01 sec)

    • 查看备份任务的历史

      1. obclient> SELECT * FROM CDB_OB_BACKUP_SET_DETAILS;

      示例结果如下：

      1. obclient> SELECT * FROM CDB_OB_BACKUP_SET_DETAILS;
      2. +-------------+-----------+--------+-------------+-----------------+----------------------------+----------------------------+------------------+------+------------+-------------+------------+--------------+-------------------+-------------------+----------------------+---------------------------+--------------------+
      3. | INCARNATION | TENANT_ID | BS_KEY | BACKUP_TYPE | ENCRYPTION_MODE | START_TIME                 | COMPLETION_TIME            | ELAPSED_SECONDES | KEEP | KEEP_UNTIL | DEVICE_TYPE | COMPRESSED | OUTPUT_BYTES | OUTPUT_RATE_BYTES | COMPRESSION_RATIO | OUTPUT_BYTES_DISPLAY | OUTPUT_RATE_BYTES_DISPLAY | TIME_TAKEN_DISPLAY |
      4. +-------------+-----------+--------+-------------+-----------------+----------------------------+----------------------------+------------------+------+------------+-------------+------------+--------------+-------------------+-------------------+----------------------+---------------------------+--------------------+
      5. |           1 |         1 |      2 | D           | NONE            | 2020-09-16 08:12:15.982675 | 2020-09-16 08:17:19.874385 |                0 | NO   |            | FILE        | NO         |            0 |            0.0000 |              NULL | 0.00MB               | 0.00MB/S                  | 00:05:03.891710    |
      6. |           1 |         1 |      3 | I           | NONE            | 2020-09-16 11:51:21.743752 | 2020-09-16 12:00:06.640995 |                0 | NO   |            | FILE        | NO         |            0 |            0.0000 |              NULL | 0.00MB               | 0.00MB/S                  | 00:08:44.897243    |
      7. |           1 |      1001 |      2 | D           | NONE            | 2020-09-16 08:12:15.982675 | 2020-09-16 08:12:22.288826 |                0 | NO   |            | FILE        | NO         |            0 |            0.0000 |              NULL | 0.00MB               | 0.00MB/S                  | 00:00:06.306151    |
      8. |           1 |      1001 |      3 | I           | NONE            | 2020-09-16 11:51:21.743752 | 2020-09-16 11:51:34.535564 |                0 | NO   |            | FILE        | NO         |            0 |            0.0000 |              NULL | 0.00MB               | 0.00MB/S                  | 00:00:12.791812    |
      9. |           1 |      1002 |      2 | D           | NONE            | 2020-09-16 08:12:15.982675 | 2020-09-16 08:17:18.426037 |                0 | NO   |            | FILE        | NO         |            0 |            0.0000 |              NULL | 0.00MB               | 0.00MB/S                  | 00:05:02.443362    |
      10. |           1 |      1002 |      3 | I           | NONE            | 2020-09-16 11:51:21.743752 | 2020-09-16 12:00:05.837062 |                0 | NO   |            | FILE        | NO         |            0 |            0.0000 |              NULL | 0.00MB               | 0.00MB/S                  | 00:08:44.093310    |
      11. +-------------+-----------+--------+-------------+-----------------+----------------------------+----------------------------+------------------+------+------------+-------------+------------+--------------+-------------------+-------------------+----------------------+---------------------------+--------------------+
      12. 6 rows in set (0.00 sec)

      CDB_OB_BACKUP_SET_DETAILS 中，部分字段的说明如下表所示。

      字段

      说明

      OUTPUT_BYTES

      表示写在外部存储介质的数据量，单位为 Bytes

      OUTPUT_RATE_BYTES

      表示 1 秒内上传的数据量，单位为 Bytes

      COMPRESSION_RATIO

      表示压缩比例，计算公式：COMPRESSION_RATIO = OUTPUT_BYTES / INPUT_BYTES

      其中，INPUT_BYTES 是 OBServer 本次需要备份的数据的大小，故可以通过 COMPRESSION_RATIO 的值计算出 INPUT_BYTES 的值，即 INPUT_BYTES = OUTPUT_BYTES / COMPRESSION_RATIO

      OUTPUT_BYTES_DISPLAY

      对于 OUTPUT_BYTES 单位转换之后的展示，单位为 MB 、GB、TB 和 PB 中的一种

      OUTPUT_RATE_BYTES_DISPLAY

      对于 OUTPUT_RATE_BYTES 单位转换之后的展示，单位为 MB 、GB、TB 和 PB 中的一种

      TIME_TAKEN_DISPLAY

      以 TIMESTAMP 的方式展示 COMPLETION_TIME - START_TIME

增量备份

增量备份是从上一个全量备份开始，备份所有修改过的宏块。建议在执行增量备份前确保已经有全量备份存在。

  1. 使用 sys 租户的 root 用户登录数据库。

  2. 执行以下语句，启动增量备份。

    1. obclient> ALTER SYSTEM BACKUP INCREMENTAL DATABASE;