---
title: "BACKUP KEY - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: BACKUP KEY 描述 在数据备份前，如果原租户配置了透明加密，需要使用 ALTER SYSTEM BACKUP KEY 语句为源租户备份秘钥。 使用限制及注意事项 备份秘钥后，在恢复数据前，如果源租户又触发过秘钥轮转，则需要重新备份源租户的秘钥。 权限要求 需要由 sys 租户的 root 用户（ root@s…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0

# BACKUP KEY

更新时间：2026-06-12 15:46:06

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/500.backup-key.md)  

## 描述

在数据备份前，如果原租户配置了透明加密，需要使用 `ALTER SYSTEM BACKUP KEY` 语句为源租户备份秘钥。

## 使用限制及注意事项

备份秘钥后，在恢复数据前，如果源租户又触发过秘钥轮转，则需要重新备份源租户的秘钥。

## 权限要求

需要由 `sys` 租户的 `root` 用户（`root@sys`） 或各租户的管理员用户执行。其中：

- MySQL 模式的默认管理员用户为 `root` 用户。
 - Oracle 模式的默认管理员用户为 `SYS` 用户。

## 语法

```sql
ALTER SYSTEM BACKUP KEY [TENANT [=] {tenant_name[, tenant_name]...}] TO 'backup_key_path' [ENCRYPTED BY 'password'];

```

## 参数说明

| 参数 | 描述 |
| --- | --- |
| tenant_name | 系统租户指定待备份秘钥的租户名。支持同时指定多个租户名，不同租户名之间使用英文逗号（,）分隔。如果系统租户不指定租户，则表示备份集群中所有用户租户的秘钥。   #### 注意    仅系统租户在执行此命令时可以通过 `TENANT = tenant_name` 子句指定待操作的租户，用户租户只能对本租户执行此命令，故不能指定 `TENANT = tenant_name` 子句。 |
| backup_key_path | 指定秘钥待备份的路径。该路径由用户自定义，不能与数据备份或日志归档的路径相同。 |
| password | 指定秘钥备份路径的加密密码。如果不指定，则默认不对备份路径加密。 |

## 示例

- 系统租户将
 - 系统租户将租户 `mysql_tenant` 的秘钥备份到 `file:///data_backup_dest/key` 路径，并设置加密密码。

  ```sql
  obclient [oceanbase]> ALTER SYSTEM BACKUP KEY TENANT = mysql_tenant TO 'file:///data_backup_dest/key' ENCRYPTED BY '******';

  ```
 - 租户 `mysql_tenant` 将本租户的秘钥备份到 `file:///data_backup_dest/key` 路径。

  ```sql
  obclient [oceanbase]> ALTER SYSTEM BACKUP KEY TO 'file:///data_backup_dest/key';

  ```

## 相关文档

- [数据透明加密概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682902)
 - [备份前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682381)
 - [RESTORE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686223)
 - [RECOVER TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686246)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线