---
title: "备份过程中更新备份目的端中 OSS 的密钥信息 | OceanBase 文档中心"
description: 备份过程中更新备份目的端中 OSS 的密钥信息 在日志备份或日志备份的再备份过程中，您可以根据需要更新备份目的端中 OSS 的密钥信息。 前提条件 已成功通过配置项 backup_dest 或 backup_backup_dest 设置了备份目的端。 更新备份目的端中 OSS 的密钥信息前，请确认当前用户拥有该备份目…
---
切换语言

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

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

# 备份过程中更新备份目的端中 OSS 的密钥信息

更新时间：2026-06-28 20:41:26

在日志备份或日志备份的再备份过程中，您可以根据需要更新备份目的端中 OSS 的密钥信息。

## 前提条件

- 已成功通过配置项 `backup_dest` 或 `backup_backup_dest` 设置了备份目的端。
 - 更新备份目的端中 OSS 的密钥信息前，请确认当前用户拥有该备份目的端的操作权限。

## 功能使用约束

- 当前仅支持对通过配置项 `backup_dest` 或 `backup_backup_dest` 设置的备份目的端的 `access_id` 和 `access_key` 进行修改。
 - 如果当前集群中有数据备份任务正在执行，则不允许通过本操作修改配置项 `backup_dest` 中设置的 OSS 的 `access_id` 和 `access_key` 信息。
 - 如果当前集群中有备份的备份（二次备份）任务正在执行，则不允许通过本操作修改配置项 `backup_backup_dest` 中设置的 OSS 的 `access_id` 和 `access_key` 信息。

## 功能使用建议

1. 在更新备份目的端的 `access_id` 和 `access_key` 信息后，建议您不要立即禁用旧的 `access_id` 和 `access_key`，可以将旧的 `access_id` 和 `access_key` 的失效时间设置为更新成功的一个小时后，以免影响备份恢复相关的其他业务，例如，系统正在执行的备份清理任务中可能正在使用旧的 `access_id` 和 `access_key`。
 2. 通过本操作变更了 `access_id` 和 `access_key` 信息，且旧的 `access_id` 和 `access_key` 已禁用的场景下，不建议再使用备份校验功能。

## 更新备份目的端中 OSS 的密钥信息

1. 使用 `root` 用户登录到数据库的 `sys` 租户。
 2. 执行以下命令，更新备份目的端的 `access_id` 和 `access_key` 信息。

   语法如下：

   ```sql
   obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='backup_path' SET ACCESS_INFO='access_id=your_access_id&access_key=your_access_key';

   ```

   其中：

      - `PATH`：用于指定唯一标识的目的端信息，包括备份路径和 Endpoint 信息。

       `PATH` 当前仅支持对象存储类型（OSS）的设置，标准格式类似：`oss://xxx?host=xxx`。如果 `PATH` 中包含了其他参数信息，系统将会报错。

       `PATH` 中不支持有 `&` 符号，如果您需要更新的目的端所在的备份路径中含有 `&` 符号，则无法使用该方法更新目的端中的 `access_id` 和 `access_key` 信息。
      - `ACCESS_INFO`：用于设置待更新的 `access_id` 和 `access_key` 的值。当前仅允许设置 `access_id` 和 `access_key` 的值，且 `access_id` 和 `access_key` 必须成对设置，不允许仅设置 `access_id` 或者仅设置 `access_key`。

   示例如下：

   ```sql
   obclient> ALTER SYSTEM CHANGE external_storage_dest PATH='oss://oceanbase-test-bucket/backup/?host=xxx.aliyun-inc.com' SET ACCESS_INFO='access_id=******&access_key=******';

   ```

 上一篇 下一篇 ![有帮助](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) 咨询热线