首批通过分布式安全可靠测评，为关键业务系统打造
ALTER/CHANGE/MODIFY EXTERNAL_STORAGE_DEST
更新时间：2026-04-15 17:06:33
编辑
分享
描述
该语句用于变更本租户备份或归档路径的 I/O 限流参数（max_iops 和 max_bandwidth）以及 access_id 和 access_key 等密钥信息。
使用限制及注意事项
对于 V4.3.5 版本，从 V4.3.5 BP2 版本开始支持修改
access_id和access_key等信息。仅用户租户可以执行该语句，系统租户（sys 租户）不能执行该语句。
仅对象存储路径支持变更 I/O 限流参数（
max_iops和max_bandwidth） 以及access_id和access_key信息。如果备份介质为 NFS 的路径设置 I/O 限流参数（max_iops和max_bandwidth）或者access_id、access_key信息，系统会返回不支持的错误，错误码为1235。为对象存储路径设置
ACCESS_INFO属性（access_id和access_key信息）时，如果参数的格式不正确（例如，有多余的=、缺少access_id或access_key），系统会报错OB_OBJECT_STORAGE_PERMISSION_DENIED（错误码为-9116）。备份路径或归档路径使用 Assume Role 方式访问对象路径时：
如果设置
ACCESS_INFO = 'access_id=new_access_id&access_key=new_access_key'，系统会报错。如果仅设置
ATTRIBUTE中的 I/O 限流参数（不设置ACCESS_INFO属性），系统可能提示不支持或者设置后不生效。
允许为同一路径多次设置相同的
ATTRIBUTE+ACCESS_INFO属性。
权限要求
执行该语句的用户需要拥有 ALTER SYSTEM 权限。有关 OceanBase 数据库权限的详细介绍，参见 MySQL 模式下的权限分类。
语法
ALTER SYSTEM {ALTER|CHANGE|MODIFY} EXTERNAL_STORAGE_DEST
PATH [=] 'path'
SET [ATTRIBUTE = '[max_iops=iops_num][&max_bandwidth=bandwidth_num]']
[ACCESS_INFO = 'access_id=new_access_id&access_key=new_access_key'];
参数说明
| 参数 | 描述 |
|---|---|
| path | 指定待变更密钥信息的备份路径或归档路径。要求路径必须为当前租户已经设置的备份路径或归档路径，且必须为对象存储路径，同时路径中需要包含 host 信息。以 OSS 为例，该路径的格式如下：oss://oceanbase-test-bucket/backup/databackup?host=***。 |
| max_iops | 指定当前备份路径或归档路径允许使用的最大 IOPS。取值为正整数，表示每秒约多少次 I/O 请求。未显式设置时，表示该路径不限制 IOPS，由底层对象存储及网络能力决定。 示例： |
| max_bandwidth | 指定当前备份路径或归档路径允许使用的最大带宽。取值为含单位的正整数。支持的单位为 kb、mb、gb，分别表示 KB/s、MB/s、GB/s。未显式设置时，表示该路径不限制带宽。 示例： |
| access_id=new_access_id&access_key=new_access_key | 指定变更后的新的 access_id 和 access_key 信息。access_id 与 access_key 需要同时填写。 |
示例
变更归档路径的 access_id 和 access_key 信息
OSS
obclient> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ACCESS_INFO = 'access_id=******&access_key=******';S3
obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com' SET ACCESS_INFO = 'access_id=******&access_key=******';兼容 S3 协议的对象存储（OBS/GCS/COS）
obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=obs.****.myhuaweicloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=https://storage.googleapis.com' SET ACCESS_INFO = 'access_id=******&access_key=******';obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=cos.ap-xxxx.myqcloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
变更备份路径的 access_id 和 access_key 信息
OSS
obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ACCESS_INFO = 'access_id=******&access_key=******';S3
obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com' SET ACCESS_INFO = 'access_id=******&access_key=******';兼容 S3 协议的对象存储（OBS/GCS/COS）
obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=obs.****.myhuaweicloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=https://storage.googleapis.com' SET ACCESS_INFO = 'access_id=******&access_key=******';obclient> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test/backup/data?host=cos.ap-xxxx.myqcloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
设置归档路径的 I/O 限流参数（max_iops 和 max_bandwidth）
可以同时设置 max_iops 和 max_bandwidth 参数，也可以单独设置 max_iops 或 max_bandwidth 参数。仅对象存储路径支持设置，NFS 路径不支持设置 I/O 限流参数。
OSS
同时设置
max_iops和max_bandwidth参数，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';单独设置
max_iops，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000';单独设置
max_bandwidth，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_bandwidth=1000mb';S3
同时设置
max_iops和max_bandwidth参数，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';兼容 S3 协议的对象存储（OBS/GCS/COS）
同时设置
max_iops和max_bandwidth参数，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=obs.****.myhuaweicloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=https://storage.googleapis.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';obclient(root@mysql001)[(none)]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=cos.ap-xxxx.myqcloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
设置备份路径的 I/O 限流参数（max_iops 和 max_bandwidth）
说明
I/O 限流参数设置建议：
- 对于高并发、带宽敏感的多租户环境，可以为不同的备份路径设置不同的
max_iops或max_bandwidth参数值，用于隔离备份对线上业务带宽和 IOPS 的影响。 - 建议结合实际网络带宽和对象存储的限速策略，先从较低值开始，逐步调整。例如，先从设置为
max_iops=500&max_bandwidth=100mb开始观察，再根据备份耗时与业务峰值进行微调。
可以同时设置 max_iops 和 max_bandwidth 参数，也可以单独设置 max_iops 或 max_bandwidth 参数。仅对象存储路径支持设置，NFS 路径不支持设置 I/O 限流参数。
OSS
同时设置
max_iops和max_bandwidth参数，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';单独设置
max_iops，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000';单独设置
max_bandwidth，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_bandwidth=1000mb';S3
同时设置
max_iops和max_bandwidth参数，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';兼容 S3 协议的对象存储（OBS/GCS/COS）
同时设置
max_iops和max_bandwidth参数，示例如下。obclient(root@mysql001)[(none)]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=obs.****.myhuaweicloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';obclient(root@mysql001)[(none)]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=https://storage.googleapis.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';obclient(root@mysql001)[(none)]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test/backup/data?host=cos.ap-xxxx.myqcloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
