你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用 AzCopy 将数据从 Amazon S3 复制到 Azure 存储
AzCopy 是一个命令行实用工具，可用于向/从存储帐户复制 Blob 或文件。 本文介绍如何使用 AzCopy 将对象、目录和桶从 Amazon Web Services (AWS) S3 复制到 Azure Blob 存储。
注意
AzCopy 支持 AWS 定义的标准虚拟托管样式或路径样式 URL。 例如 https://bucket.s3.amazonaws.com 或 https://s3.amazonaws.com/bucket。
选择如何提供授权凭据
若要对 Azure 存储授权，请使用 Microsoft Entra ID 或共享访问签名 (SAS) 令牌。
若要对 AWS S3 授权，请使用 AWS 访问密钥和机密访问密钥。
对 Azure 存储授权
请参阅 AzCopy 入门一文下载 AzCopy，并选择如何提供存储服务的授权凭据。
注意
本文中的示例假设你已使用 AzCopy login 命令验证自己的身份。 然后，AzCopy 使用 Microsoft Entra 帐户授权访问 Blob 存储中的数据。
如果你希望使用 SAS 令牌来授权访问 Blob 数据，可将该令牌追加到每个 AzCopy 命令中的资源 URL。
例如：https://mystorageaccount.blob.core.windows.net/mycontainer?<SAS-token>。
对 AWS S3 授权
收集 AWS 访问密钥和机密访问密钥，然后设置以下环境变量：
| 操作系统 | 命令 |
|---|---|
| Windows | PowerShell：$env:AWS_ACCESS_KEY_ID=<access-key>$env:AWS_SECRET_ACCESS_KEY=<secret-access-key> 在命令提示符处使用 set AWS_ACCESS_KEY_ID=<access-key>set AWS_SECRET_ACCESS_KEY=<secret-access-key> |
| Linux | export AWS_ACCESS_KEY_ID=<access-key>export AWS_SECRET_ACCESS_KEY=<secret-access-key> |
| macOS | export AWS_ACCESS_KEY_ID=<access-key>export AWS_SECRET_ACCESS_KEY=<secret-access-key> |
这些凭据用于生成用于复制对象的预签名 URL。
复制对象、目录和桶
AzCopy 使用从 URL 放置块 API，因此数据将在 AWS S3 与存储服务器之间直接复制。 这些复制操作不会占用计算机的网络带宽。
提示
本部分中的示例将路径参数括在单引号 ('') 中。 在除 Windows 命令 Shell (cmd.exe) 以外的所有命令 shell 中，都请使用单引号。 如果使用 Windows 命令 Shell (cmd.exe)，请用双引号 ("") 而不是单引号 ('') 括住路径参数。
这些示例也适用于具有分层命名空间的帐户。 Data Lake Storage 上的多协议访问使你可以在这些帐户上使用相同的 URL 语法 (blob.core.windows.net)。
复制对象
对具有分层命名空间的帐户使用相同的 URL 语法 (blob.core.windows.net)。
语法
azcopy copy 'https://s3.amazonaws.com/<bucket-name>/<object-name>' 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>'
示例
azcopy copy 'https://s3.amazonaws.com/mybucket/myobject' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myblob'
注意
本文中的示例对 AWS S3 桶使用路径样式的 URL（例如：http://s3.amazonaws.com/<bucket-name>）。
也可以使用虚拟托管样式的 URL（例如：http://bucket.s3.amazonaws.com）。
若要详细了解 Bucket 的虚拟托管，请参阅 Bucket 的虚拟托管。
复制目录
对具有分层命名空间的帐户使用相同的 URL 语法 (blob.core.windows.net)。
语法
azcopy copy 'https://s3.amazonaws.com/<bucket-name>/<directory-name>' 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<directory-name>' --recursive=true
示例
azcopy copy 'https://s3.amazonaws.com/mybucket/mydirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer/mydirectory' --recursive=true
注意
此示例追加 --recursive 标志以复制所有子目录中的文件。
复制目录的内容
可以使用通配符 (*) 复制目录的内容，而无需复制包含内容的目录本身。
语法
azcopy copy 'https://s3.amazonaws.com/<bucket-name>/<directory-name>/*' 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<directory-name>' --recursive=true
示例
azcopy copy 'https://s3.amazonaws.com/mybucket/mydirectory/*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/mydirectory' --recursive=true
复制桶
对具有分层命名空间的帐户使用相同的 URL 语法 (blob.core.windows.net)。
语法
azcopy copy 'https://s3.amazonaws.com/<bucket-name>' 'https://<storage-account-name>.blob.core.windows.net/<container-name>' --recursive=true
示例
azcopy copy 'https://s3.amazonaws.com/mybucket' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive=true
复制所有区域中的所有桶
对具有分层命名空间的帐户使用相同的 URL 语法 (blob.core.windows.net)。
语法
azcopy copy 'https://s3.amazonaws.com/' 'https://<storage-account-name>.blob.core.windows.net' --recursive=true
示例
azcopy copy 'https://s3.amazonaws.com' 'https://mystorageaccount.blob.core.windows.net' --recursive=true
复制特定 S3 区域中的所有桶
对具有分层命名空间的帐户使用相同的 URL 语法 (blob.core.windows.net)。
语法
azcopy copy 'https://s3-<region-name>.amazonaws.com/' 'https://<storage-account-name>.blob.core.windows.net' --recursive=true
示例
azcopy copy 'https://s3-rds.eu-north-1.amazonaws.com' 'https://mystorageaccount.blob.core.windows.net' --recursive=true
处理对象命名规则的差异
相比 Azure Blob 容器，AWS S3 对桶的名称实施一组不同的命名约定。 可在此处了解相关信息。 如果选择将一组桶复制到 Azure 存储帐户，复制操作可能因命名差异而失败。
AzCopy 会处理可能出现的两个最常见问题：包含句点的桶，以及包含连续连字符的桶。 AWS S3 桶名称可以包含句点和连续的连字符，但 Azure 中的容器则不可以。 AzCopy 会将句点替换为连字符，并将连续的连字符替换为表示连续连字符数目的数字（例如：名为 my----bucket 的桶将变成 my-4-bucket）。
此外，在 AzCopy 复制文件时，它会检查并尝试解决命名冲突。 例如，如果存在名为 bucket-name 和 bucket.name 的桶，则 AzCopy 会将名为 bucket.name 的桶解析为 bucket-name，再将后者解析为 bucket-name-2。
处理对象元数据的差异
AWS S3 和 Azure 允许在对象键名称中使用不同的字符集。 可在此处了解 AWS S3 使用的字符。 在 Azure 端，Blob 对象键遵守 C# 标识符的命名规则。
在 AzCopy copy 命令中，可为 s2s-handle-invalid-metadata 可选标志提供一个值，用于指定如何处理其中的元数据包含不兼容键名称的文件。 下表描述了每个标志值。
| 标志值 | 说明 |
|---|---|
| ExcludeIfInvalid | （默认选项）不在传输的对象中包含元数据。 AzCopy 将记录警告。 |
| FailIfInvalid | 不复制对象。 AzCopy 将记录错误，并将该错误包含到传输摘要显示的失败计数中。 |
| RenameIfInvalid | AzCopy 将解析无效的元数据键，并使用已解析的元数据键值对将对象复制到 Azure。 若要确切地了解 AzCopy 采取哪些步骤来重命名对象键，请参阅下面的 AzCopy 如何重命名对象键部分。 如果 AzCopy 无法重命名该键，则不会复制该对象。 |
AzCopy 如何重命名对象键
AzCopy 执行以下步骤：
将无效字符替换为“_”。
将字符串
rename_添加到新的有效键的开头。此键将用于保存原始元数据的值。
将字符串
rename_key_添加到新的有效键的开头。 此键将用于保存原始元数据的无效键。 可以使用此键在 Azure 端尝试恢复元数据，因为元数据键作为值保留在 Blob 存储服务中。
后续步骤
如需了解更多示例，请参阅以下文章：
请参阅以下文章了解如何配置设置、优化性能和排查问题：