---
title: "S3 协议说明 - 云平台 OCP V4.3.5 | OceanBase 文档中心"
description: S3 协议说明 OCP 支持兼容 AWS S3 协议的存储介质，包含原生 AWS S3、华为云 OBS、天翼云 OBS 以及 Google GCS 等。 AWS S3 与 OSS/COS 一样，AWS S3 也支持通过 delete_mode 参数来配置备份文件的清理模式，配置方法与 OSS/COS 一样。 使用 S…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.3.5

# S3 协议说明

更新时间：2026-04-14 15:11:03

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.5/zh-CN/2100.appendix/900.s3-overview.md)  

OCP 支持兼容 AWS S3 协议的存储介质，包含原生 AWS S3、华为云 OBS、天翼云 OBS 以及 Google GCS 等。

## AWS S3

与 OSS/COS 一样，AWS S3 也支持通过 delete_mode 参数来配置备份文件的清理模式，配置方法与 OSS/COS 一样。

使用 S3 作为备份介质的配置示例如下：

- 使用 S3 作为备份介质时，系统租户为指定租户 `mysql_tenant` 设置备份目的端并配置为 delete 清理模式。

  ```sql
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST='s3://oceanbase-test-bucket/backup/data?
  host=s3.<region>.amazonaws.com
  &access_id=****
  &access_key=****
  &s3_region=****
  &delete_mode=delete' TENANT = mysql_tenant;

  ```
 - 使用 S3 作为备份介质时，用户租户为本租户设置备份目的端并配置为 delete 清理模式。

  ```sql
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST='s3://oceanbase-test-bucket/backup/data?
  host=s3.<region>.amazonaws.com
  &access_id=****
  &access_key=****
  &s3_region=****
  &delete_mode=delete';

  ```

示例中，`s3://` 表示使用 S3 作为备份目的端介质类型，存储桶名为 `oceanbase-test-bucket`，在存储桶中的路径是 `/backup/data`，同时使用 `?` 来分隔路径的其他参数。`host` 用于设置 Amazon S3 服务的域名，`access_id` 和 `access_key` 用于设置 AWS 服务的访问秘钥，`s3_region` 在使用 S3 作为备份介质时为必选参数，表示 S3 的存储桶所在的地域，清理模式设置为 `delete`。

## 兼容 S3 协议的对象存储

由于大多数对象存储兼容了 S3 协议，对于兼容 S3 协议并满足 OceanBase 数据库要求（对象存储需要兼容实现了 OceanBase 系统调用的几个 S3 API 的行为）的对象存储均可以作为 OceanBase 数据库的备份介质，并通过访问 S3 的方式来访问兼容的对象存储，如 OBS 和 GCS 等都是通过 S3 协议访问。

**使用 OBS 作为备份介质的配置示例如下:**

- 使用 OBS 作为备份介质时，系统租户为指定租户 `mysql_tenant` 设置备份目的端。

  ```sql
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST='s3://oceanbase-test-bucket/backup/data?
  host=obs.****.myhuaweicloud.com
  &access_id=****
  &access_key=****' TENANT = mysql_tenant;

  ```
 - 使用 OBS 作为备份介质时，用户租户为本租户设置备份目的端。

  ```sql
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST='s3://oceanbase-test-bucket/backup/data?
  host=obs.****.myhuaweicloud.com
  &access_id=****
  &access_key=****';

  ```

上述示例中，`s3://` 表示使用兼容 S3 协议的对象存储作为备份目的端介质类型，存储桶名为 `oceanbase-test-bucket`，在存储桶中的路径是 `/backup/data`，同时使用 `?` 来分隔路径的其他参数。`host` 用于设置 OBS 服务的域名，`access_id` 和 `access_key` 用于设置 OBS 服务的访问秘钥。

**使用 GCS 作为备份介质的配置示例如下：**

- 使用 GCS 作为备份介质时，系统租户为指定租户 `mysql_tenant` 设置备份目的端。

  ```sql
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST='s3://oceanbase-test-bucket/backup/data?
  host=https://storage.googleapis.com
  &access_id=****
  &access_key=****' TENANT = mysql_tenant;

  ```
 - 使用 GCS 作为备份介质时，用户租户为本租户设置备份目的端。

  ```sql
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST='s3://oceanbase-test-bucket/backup/data?
  host=https://storage.googleapis.com
  &access_id=****
  &access_key=****';

  ```

上述示例中，`s3://` 表示使用兼容 S3 协议的对象存储作为备份目的端介质类型，存储桶名为 `oceanbase-test-bucket`，在存储桶中的路径是 `/backup/data`，同时使用 `?` 来分隔路径的其他参数。`host` 用于设置 GCS 服务的域名，`access_id` 和 `access_key` 用于设置 GCS 服务的访问秘钥。

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