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

在日志备份或日志备份的再备份过程中，您可以根据需要更新备份目的端中 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 信息。

   语法如下：

   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。

   示例如下：

   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=******';