基于湖库一体架构,统一管理结构化、半结构化与非结构化等多模态数据,一个系统承载事务处理、实时分析与 AI 工作负载。
执行物理恢复
更新时间:2026-11-19 10:57:58
本节主要介绍如何通过命令的方式进行租户级物理恢复,目前 OceanBase AI 数据库支持租户级别的基于时间点的全量恢复。有关全量恢复的区别请参见 物理备份与恢复概述。
OceanBase AI 数据库的恢复支持在同集群内恢复,也支持在不同的集群内恢复。
恢复会先根据用户输入的命令,从备份目的端将需要的宏块数据从对应的全量备份中恢复到目标租户,并同步拉取和回放事务日志。
前提条件
执行物理恢复前,请确认已完成恢复前准备,具体操作请参见 恢复前准备。
注意事项
- 在数据备份的同时备份了租户级配置项,但备份的租户级配置项仅用于为用户提供配置参考,物理恢复时不会直接恢复到租户中。有关备份配置项的详细介绍,参见 备份配置项。
操作步骤
使用
root用户登录集群的sys租户。(可选)执行以下语句,设置备份的恢复密码。
仅在数据备份时添加了密码的场景下才需要设置备份的恢复密码。
SET DECRYPTION IDENTIFIED BY 'password';其中,
password需要替换为备份时添加的密码。示例如下:
SET DECRYPTION IDENTIFIED BY '******';执行以下语句,设置加密信息。
说明
如果未加密或恢复时可以访问原来的密钥管理服务,则跳过本步骤。
obclient [(none)]> SET @kms_encrypt_info = '<加密string>';其中,
<加密string>为EXTERNAL_KMS_INFO的值,EXTERNAL_KMS_INFO为租户级配置项。说明
external_kms_info用于存储一些密钥管理信息。有关该配置项的详细介绍,请参见 external_kms_info。执行以下语句,开始执行恢复任务。
语句如下:
恢复到指定时间戳
ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL TIME='timestamp' WITH 'pool_list=pool_list[&locality=locality][&primary_zone=zone_name][&concurrency=int_num][&kms_encrypt={true | false}][&method=full]' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION description];恢复到指定 SCN
ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL SCN=scn WITH 'pool_list=pool_list[&locality=locality][&primary_zone=zone_name][&concurrency=int_num][&kms_encrypt={true | false}][&method=full]' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION description];恢复到最新位点
ALTER SYSTEM RESTORE dest_tenant_name FROM uri WITH 'pool_list=pool_list[&locality=locality][&primary_zone=zone_name][&concurrency=int_num][&kms_encrypt={true | false}][&method=full]' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION description];
语句中的部分参数说明如下:
TIME='timestamp'、SCN=scn:指定恢复的终点,恢复到该位点位置,且包含该位点。语句中TIME或SCN选取的详细说明,参见 物理恢复相关参数介绍。uri:指定备份时设置的数据备份路径backup_data_dest与日志归档路径log_archive_dest,该值至少包含一条数据备份路径和一条日志归档路径,路径之间使用英文逗号(,)分隔。pool_list:填写用户的资源池。多个资源池之间用英文逗号(,)分隔。locality、primary_zone:指定新租户副本分布的 Locality 信息以及Leader 副本的偏好位置。可选。有关这些参数的详细说明,参见 ALTER SYSTEM - RESTORE。concurrency:指定数据恢复的并发度,可选。默认等于该租户被分配的 Unit 的MAX_CPU数。kms_encrypt:可选,为true时表示在恢复时需要使用在恢复前指定的kms_encrypt_info。method:指定数据恢复的方式,不区分大小写。取值如下:full:全量恢复。不显式指定时,默认为full。
WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password':指定加密租户的秘钥备份信息。仅当源租户配置了透明加密,才需要在恢复时指定秘钥备份相关的信息。backup_key_path:秘钥的备份路径。password:备份秘钥时设置的加密密码。
有关秘钥备份的相关操作,请参见 备份前准备 中的 备份秘钥。
有关物理恢复中各参数的详细说明,参见 ALTER SYSTEM - RESTORE。
恢复示例如下:
AWS S3兼容 S3 协议的对象存储从 S3 备份路径与 S3 日志归档路径恢复租户
mysql到指定时间戳2024-01-15 00:00:00, 指定资源池为restore_pool,以全量恢复方式进行恢复。ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com&access_id=***&access_key=***&s3_region=***, s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com&access_id=***&access_key=***&s3_region=***' UNTIL TIME='2024-01-15 00:00:00' WITH 'pool_list=restore_pool';从 OBS 备份路径与日志归档路径恢复租户
mysql到指定时间戳2023-06-01 00:00:00,指定资源池为restore_pool,以全量恢复方式进行恢复。obclient> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test-bucket/backup/data/?host=obs.***.myhuaweicloud.com&access_id=***&access_key=***,s3://oceanbase-test-bucket/backup/archive/?host=obs.***.myhuaweicloud.com&access_id=***&access_key=***' UNTIL TIME='2023-06-01 00:00:00' WITH 'pool_list=restore_pool';从 GCS 备份路径与日志归档路径恢复租户
mysql到指定时间戳2023-06-01 00:00:00,指定资源池为restore_pool,以全量恢复方式进行恢复。obclient> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test-bucket/backup/data/?host=https://storage.googleapis.com&access_id=***&access_key=***,s3://oceanbase-test-bucket/backup/archive/?host=https://storage.googleapis.com&access_id=***&access_key=***' UNTIL TIME='2023-06-01 00:00:00' WITH 'pool_list=restore_pool';从 COS 备份路径与日志归档路径恢复租户
mysql到指定时间戳2023-06-01 00:00:00,指定资源池为restore_pool,以全量恢复方式进行恢复。obclient> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test/backup/data?host=cos.ap-xxxx.myqcloud.com&access_id=***&access_key=***,s3://oceanbase-test/backup/archive?host=cos.ap-xxxx.myqcloud.com&access_id=***&access_key=***' UNTIL TIME='2023-06-01 00:00:00' WITH 'pool_list=restore_pool';
(可选)在待恢复租户对应的 Meta 租户创建成功后,如果需要加速恢复,可以通过配置项
ha_high_thread_score配置恢复任务的并发线程数。通过
oceanbase.DBA_OB_TENANTS视图查看待恢复租户对应的 Meta 租户是否创建成功。语句如下:
obclient> SELECT * FROM oceanbase.DBA_OB_TENANTS;查询结果中,
TENANT_NAME列中以META$开头的租户即为 Meta 租户,当 Meta 租户的状态为NORMAL时,则表示 Meta 租户创建成功。更多视图
DBA_OB_TENANTS的字段说明信息请参见 DBA_OB_TENANTS。设置配置项
ha_high_thread_score。租户级配置项
ha_high_thread_score用于设置高可用高优先级线程的当前工作线程数。默认值为 0,取值范围为 [0, 100],建议修改为 10。有关配置项ha_high_thread_score的更多介绍,请参见 ha_high_thread_score。语句示例如下:
obclient> ALTER SYSTEM SET ha_high_thread_score =10 TENANT = mysql;