16.15 云存储选项

这些选项用于将云存储用于单个文件操作。有关将云存储与 MySQL Enterprise Backup 一起使用的更多信息和说明， 请参阅第 4.3.1.3 节“备份到云存储”和 第 5.1.5 节“将备份从云存储恢复到 MySQL 服务器” 。

  • --cloud-service=SERVICE

    用于数据备份或恢复的云服务。目前， mysqlbackup支持两种类型的云存储服务 ，由以下选项值表示：

    • openstack：OpenStack Swift 或兼容的对象存储服务（例如，Oracle Cloud Infrastructure Object Storage 和 Oracle Cloud Infrastructure Object Storage Classic）。

    • s3：亚马逊简单存储服务 (S3)。

  • --cloud-trace

    打印云操作的跟踪信息。它独立于，它指定mysqlbackup--trace的非云操作的跟踪级别 。该选项的任何非零值都会启用跟踪功能。

    默认值为“ 0 ”。

  • --cloud-proxy=proxy-url:port

    用于覆盖环境默认代理设置以访问云存储服务的代理地址和端口号。

    笔记

    list-image仅当云代理支持 HTTP 范围标头时，才能在云备份上执行 该操作。

  • --cloud-ca-info=PATH

    用于 SSL 连接的主机身份验证的 CA 捆绑文件的绝对路径。指定该选项后，使用 CA 捆绑文件优先于使用单个.pem文件进行主机身份验证。

  • --cloud-ca-path=PATH

    CA证书目录，除系统默认文件夹外。

  • --cloud-buffer-size=MB

    （对于版本 4.1.1 及更高版本）云操作缓冲区的大小（以兆字节为单位）。在启动云传输之前， mysqlbackup 将 数据累积到此选项指定的大小。该值必须介于 16 到 4096 之间。

    默认值：64

  • 仅用于 OpenStack Swift 或兼容的对象存储服务的选项（当参数 for --cloud-service不是任何东西 时使用它们openstack将导致 mysqlbackup抛出错误）：

    • --cloud-container=SWIFT_CONTAINER

      备份映像的 Swift 容器。对于 Oracle Cloud Infrastructure (OCI) 对象存储，这是对象存储桶。

    • --cloud-object=SWIFT_OBJECT

      备份图像的 Swift 对象。请注意，同一容器（或桶，对于 OCI 对象存储）中的对象名称必须是唯一的。

    • --cloud-user-id=SWIFT_USER_ID

      访问 Swift 的用户 ID。用户凭据在使用该选项时由 Swift TempAuth 身份系统进行身份验证，在 --cloud-tempauth-url 使用该选项时由 OpenStack Keystone 身份服务进行 身份验证，在使用--cloud-identity-url 该选项时由 HTTP 基本身份验证进行身份验证--cloud-basicauth-url 。

    • --cloud-password=SWIFT_PASSWORD

      --cloud-user-id选项 指定的用户访问 Swift 的密码。用户凭据在使用该选项时由 Swift TempAuth 身份系统进行身份验证，在 --cloud-tempauth-url 使用该选项时由 OpenStack Keystone 身份服务进行 身份验证，在使用--cloud-identity-url 该选项时由 HTTP 基本身份验证进行身份验证--cloud-basicauth-url 。

    • --cloud-tempauth-url=SWIFT_TEMPAUTH-URL

      用于验证用户凭据的 TempAuth URL。

    • --cloud-basicauth-url=SWIFT_BASICAUTH-URL

      （对于 4.1.1 版及更高版本）HTTP 基本身份验证的 URL。

    • --cloud-storage-url=SWIFT_STORAGE-URL

      （对于版本 4.1.2 及更高版本）使用 OAuth 进行客户端身份验证时 Oracle Cloud Infrastructure 对象存储的 URL。

    • --cloud-oauth-token=SWIFT_OAUTH-TOKEN

      （对于版本 4.1.2 及更高版本）用于 Oracle Cloud Infrastructure 对象存储访问的 OAuth 令牌。选项值必须采用以下格式之一：

      • --cloud-oauth-token= oauth_token， oauth_token OAuth 令牌本身 在哪里

      • --cloud-oauth-token= ，其中 指向仅包含 OAuth 令牌的文件。 file:oauth_filepathoauth_filepath

    • --cloud-identity-url=SWIFT_KEYSTONE-URL

      Keystone 身份服务的 URL，当它用于验证用户凭据时。

    • --cloud-tenant=SWIFT_KEYSTONE-TENANT

      --cloud-user-id当 Keystone 身份服务用于验证用户凭据时， 由 指定的用户的 Keystone 租户 。

    • --cloud-region=SWIFT_KEYSTONE-REGION

      --cloud-user-id当 Keystone 身份服务用于验证用户凭据时， 由 指定的用户的 Keystone 区域 。

    • --cloud-chunked-transfer=VALUE

      （对于版本 4.1.1 及更高版本）将分块传输与 Swift 服务一起使用。

      如果该选项设置为true，备份将作为动态大对象 (DLO) 传输和存储，多个文件段被视为单个文件。每个大于 5GB 的备份被分成多个部分，名称以 . 有关详细信息，请参阅 OpenStack 文档。 <object_name>_part_<number>

      如果该选项设置为 false， mysqlbackup以缓冲区大小分段上传备份，一个备份可以拥有的最大分段数由 Swift 服务确定。

      默认值：真

      警告

      如果您的云存储不支持分块传输，请将选项设置为 false；否则， mysqlbackup操作可能会失败。

    访问 Swift 服务时，应使用 、 、 或 中的一个且只能使用一个，--cloud-tempauth-url否则 --cloud-identity-urlmysqlbackup --cloud-basicauth-url将 抛出错误 。 --cloud-storage-url

  • 仅用于 Amazon S3 的选项（当参数 for--cloud-service不是任何东西时使用它们s3将导致 mysqlbackup 抛出错误）：

    • --cloud-bucket=S3_BUCKET

      Amazon S3 上用于备份图像的存储桶。

      为了使用存储桶执行云备份和恢复，该 --cloud-access-key-id 选项标识的用户必须至少对存储桶具有以下权限：

      • s3:ListBucket：用于列出有关存储桶中项目的信息。

      • s3:ListBucketMultipartUploads：用于列出正在进行的分段上传到存储桶。

      • s3:GetObject：用于从桶中检索对象。

      • s3:PutObject：用于将对象添加到桶中。

    • --cloud-object-key=S3_OBJECT_KEY

      备份图像的 Amazon S3 对象键。

    • --cloud-access-key-id=S3_KEY-ID

      用于登录 Amazon S3 的 AWS 访问密钥 ID。

    • --cloud-secret-access-key=S3_ACCESS-KEY

      使用 指定的 AWS 访问密钥 ID 的 AWS 秘密访问密钥 --cloud-access-key-id。

    • --cloud-aws-region=S3_REGION

      mysqlbackup为 S3 访问的 Amazon Web 服务区域 。