首批通过分布式安全可靠测评，为关键业务系统打造
BACKUP KEY
更新时间：2026-04-16 00:11:36
编辑
分享
描述
在数据备份前，如果原租户配置了透明加密，需要使用 ALTER SYSTEM BACKUP KEY 语句为源租户备份秘钥。
使用限制及注意事项
备份秘钥后，在恢复数据前，如果源租户又触发过秘钥轮转，则需要重新备份源租户的秘钥。
权限要求
需要由 sys 租户的 root 用户（root@sys） 或各租户的管理员用户执行。其中：
- MySQL 模式的默认管理员用户为
root用户。 - Oracle 模式的默认管理员用户为
SYS用户。
语法
ALTER SYSTEM BACKUP KEY [TENANT [=] {tenant_name[, tenant_name]...}] TO 'backup_key_path' [ENCRYPTED BY 'password'];
参数说明
| 参数 | 描述 |
|---|---|
| tenant_name | 系统租户指定待备份秘钥的租户名。支持同时指定多个租户名，不同租户名之间使用英文逗号（,）分隔。如果系统租户不指定租户，则表示备份集群中所有用户租户的秘钥。
注意仅系统租户在执行此命令时可以通过 |
| backup_key_path | 指定秘钥待备份的路径。该路径由用户自定义，不能与数据备份或日志归档的路径相同。 |
| password | 指定秘钥备份路径的加密密码。如果不指定，则默认不对备份路径加密。 |
示例
系统租户将
系统租户将租户
mysql_tenant的秘钥备份到file:///data_backup_dest/key路径，并设置加密密码。obclient [oceanbase]> ALTER SYSTEM BACKUP KEY TENANT = mysql_tenant TO 'file:///data_backup_dest/key' ENCRYPTED BY '******';租户
mysql_tenant将本租户的秘钥备份到file:///data_backup_dest/key路径。obclient [oceanbase]> ALTER SYSTEM BACKUP KEY TO 'file:///data_backup_dest/key';
