20.15 云存储选项

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

  • 用于所有云服务的选项:

    • --cloud-service=SERVICE

      用于数据备份或恢复的云服务。mysqlbackup支持各种类型的云存储服务 ,由以下选项值表示:

      • OCI: 甲骨文云基础设施对象存储

      • openstack: OpenStack Swift 或兼容的对象存储服务

      • s3: Amazon Simple Storage Service (S3) 或兼容的存储服务

      • GCP:GCP 对象存储

    • --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

      云操作的缓冲区大小(以兆字节为单位)。 在启动云传输之前, mysqlbackup 将数据累积到此选项指定的大小。该值必须介于 16 到 4096 之间。

      默认值:64

  • 用于 Oracle 云基础设施 (OCI) 对象存储的选项:

    • --cloud-object=OCI_OBJECT

      备份映像的存储对象。请注意,同一存储桶中的对象名称必须是唯一的。

    • --cloud-par-url=OCI_PAR-URL

      OCI 对象存储的 预验证请求 (PAR) URL。对于 OCI 对象存储的备份,它是存储桶的 PAR URL;对于存储在 OCI 上的对象的恢复和其他操作,它是对象的 PAR URL。

  • 用于 OpenStack Swift 对象存储的选项:

    • --cloud-object=SWIFT_OBJECT

      备份映像的存储对象。请注意,同一容器内的对象名称必须是唯一的。

    • --cloud-container=SWIFT_CONTAINER

      备份映像的 Swift 容器。

    • --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

      HTTP 基本身份验证的 URL。

    • --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={true|false}

      使用分块传输。当 时 --cloud-service=openstack,备份始终作为 动态大对象 (DLO)传输和存储,其中多个文件段被视为单个文件。一个备份可以拥有的最大段数由对象存储服务决定,段的最大大小由该选项控制。

      如果该选项设置为 true, mysqlbackup使用分块传输编码来传输数据。大于值 --cloud-chunk-size (或者,对于 8.0.22 版和更早版本大于 5GB)的备份被分成多个段。

      如果该选项设置为 false, mysqlbackup 将以缓冲区大小分段上传备份。

      默认值:false,当 --cloud-service=openstack

      警告

      仅当您的云存储支持分块传输时才将选项设置为 true;否则, mysqlbackup操作可能会失败。

    • --cloud-chunk-size=SWIFT_CHUNK-SIZE

      对于 MySQL Enterprise Backup 8.0.23 及更高版本:如果启用分块传输,则分块的大小(以兆字节为单位)。如果禁用分块传输,则忽略此选项。

      最小值:64

      最大值:32位机器上3072,64位机器上5120

      默认值:2048

    笔记

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

  • 用于 Amazon S3 和 S3 兼容服务的选项:

    • --cloud-host=S3_HOSTNAME

      (对于 MySQL Enterprise Backup 8.0.22 及更高版本)S3 兼容存储服务的主机名。

      默认: s3.amazonaws.com

    • --cloud-bucket=S3_BUCKET

      用于备份映像的 S3 兼容存储服务上的存储桶。

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

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

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

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

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

    • --cloud-object-key=S3_OBJECT-KEY

      备份映像的 S3 对象键。

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

      用于登录 S3 兼容存储服务的访问密钥 ID。

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

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

    • --cloud-aws-region=S3_REGION

      mysqlbackup访问 的 Web 服务的 区域。

  • 用于 GCP 对象存储的选项(适用于 MySQL Enterprise Backup 8.0.23 及更高版本):

    • --cloud-host=HOSTNAME

      存储服务的主机名。

      默认值: storage.googleapis.com, 当--cloud-service=GCP

    • --cloud-bucket=BUCKET

      备份图片的存储桶。

    • --cloud-object=OBJECT

      备份映像的存储对象。请注意,同一存储桶中的对象名称必须是唯一的。

    • --cloud-access-key=ACCESS-KEY

      云帐户的访问密钥。该选项对于备份操作是必需的。如果没有为恢复操作提供它,mysqlbackup 假定备份映像是一个公共对象,并且可以在没有密钥的情况下访问或下载;如果对象不是公共的,则恢复操作失败。

    • --cloud-secret-key=SECRET-KEY

      用 指定的云帐户的密钥 --cloud-access-key。该选项对于备份操作是必需的。

    • --cloud-chunked-transfer={true|false}

      使用分块传输。

      如果该选项设置为 true, mysqlbackup使用分块传输编码来传输数据。大于该值的备份--cloud-chunk-size 被分割成多个段。

      如果该选项设置为 false, mysqlbackup 将以缓冲区大小分段上传备份。

      默认值:true,当 --cloud-service=GCP

    • --cloud-chunk-size=CHUNK-SIZE

      如果启用分块传输,则分块的大小(以兆字节为单位)。如果禁用分块传输,则忽略此选项。

      最小值:64

      最大值:32位机器上3072,64位机器上5120

      默认值:2048