你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：使用 Azure 导入/导出服务将数据导入 Azure Blob 存储

项目
05/11/2023

本文提供了有关如何使用 Azure 导入/导出服务安全地将大量数据导入到 Azure Blob 存储的分步说明。若要将数据导入到 Azure Blob，此服务要求你将包含数据的已加密磁盘驱动器寄送到某个 Azure 数据中心。

在本教程中，你将了解如何执行以下操作：

将数据导入 Azure Blob 存储的先决条件
步骤 1：准备驱动器
步骤 2：创建导入作业
步骤 3：配置客户管理的密钥（可选）
步骤 4：寄送驱动器
步骤 5：使用跟踪信息更新作业
步骤 6：验证 Azure 中的数据上传

先决条件

在创建导入作业来将数据传输到 Azure Blob 存储之前，请仔细查看并完成此服务的以下先决条件列表。必须具备以下条件：

拥有可用于导入/导出服务的有效 Azure 订阅。
拥有至少一个包含存储容器的 Azure 存储帐户。请参阅导入/导出服务支持的存储帐户和存储类型的列表。
- 有关创建新存储帐户的信息，请参阅如何创建存储帐户。
- 有关如何创建存储容器的信息，请转到创建存储容器。
拥有足够数量的受支持类型的磁盘。
拥有运行受支持 OS 版本的 Windows 系统。
在 Windows 系统上启用 BitLocker。请参阅如何启用 BitLocker。
下载 Windows 系统上适用于 blob 的 Azure 导入/导出版本 1 工具的当前版本：
1. 下载 WAImportExport 版本 1。当前版本为 1.5.0.300。
2. 解压缩到默认文件夹 WaImportExportV1。例如 C:\WaImportExportV1。

具有有效承运人帐户和订单跟踪号：
- 必须使用订单的“寄送”选项卡上“承运人名称”列表中的承运人。如果没有承运人帐户，请联系承运人创建一个。
- 承运商帐户必须是有余额的有效帐户，且有退货功能。 Microsoft 使用选定的运营商退回所有存储介质。
- 为承运商帐户中的导入/导出作业生成跟踪号。每个作业都应有一个单独的跟踪号。不支持多个作业共享相同跟踪号。

步骤 1：准备驱动器

此步骤生成一个日志文件。日志文件存储着驱动器序列号、加密密钥和存储帐户详细信息等基本信息。

请执行以下步骤来准备驱动器。

通过 SATA 连接器将磁盘驱动器连接到 Windows 系统。
在每个驱动器上创建一个 NTFS 卷。为卷分配驱动器号。请勿使用装载点。
在 NTFS 卷上启用 BitLocker 加密。如果使用某个 Windows Server 系统，请使用如何在 Windows Server 2012 R2 上启用 BitLocker 中的说明。
将数据复制到加密的卷。可使用拖放或 Robocopy 或任何类似的复制工具。在运行该工具的同一文件夹中会创建一个日志 (.jrn) 文件。

如果驱动器已锁定并且需要解锁，不同用例的解锁步骤可能不同。
- 如果已将数据添加到预加密驱动器（没有使用 WAImportExport 工具进行加密），请使用弹出窗口中的 BitLocker 密钥（你指定的数字密码）来解锁驱动器。
- 如果已将数据添加到由 WAImportExport 工具加密的驱动器，请使用以下命令解锁该驱动器：
  
  WAImportExport Unlock /bk:<BitLocker key (base 64 string) copied from journal (*.jrn*) file>
使用管理员权限打开 PowerShell 或命令行窗口。若要将目录切换到解压缩的文件夹，请运行以下命令：

cd C:\WaImportExportV1
若要获取驱动器的 BitLocker 密钥，请运行以下命令：

manage-bde -protectors -get <DriveLetter>:

若要准备磁盘，请运行以下命令。磁盘准备过程可能需要几小时到几天，具体取决于数据大小。

./WAImportExport.exe PrepImport /j:<journal file name> /id:session<session number> /t:<Drive letter> /bk:<BitLocker key> /srcdir:<Drive letter>:\ /dstdir:<Container name>/ /blobtype:<BlockBlob or PageBlob> /skipwrite

在运行该工具的同一文件夹中会创建一个日志文件。还会创建两个其他文件 - 一个 .xml 文件（您在其中运行工具的文件夹）和一个 drive-manifest.xml 文件（数据所在的文件夹）。

下表介绍了所使用的参数：

选项	说明
/j:	带有 .jrn 扩展名的日志文件的名称。会为每个驱动器生成一个日志文件。建议使用磁盘序列号作为日志文件名。
/id:	会话 ID。请为该命令的每个实例使用唯一的会话编号。
/t:	要寄送的磁盘的驱动器号。例如，驱动器 `D`。
/bk:	驱动器的 BitLocker 密钥。其数字密码来自 `manage-bde -protectors -get D:` 的输出
/srcdir:	要寄送的磁盘的驱动器号后跟 `:\`。例如，`D:\`。
/dstdir:	Azure 存储中的目标容器的名称。
/blobtype:	此选项指定要将数据导入到的 Blob 的类型。对于块 Blob，Blob 类型为 `BlockBlob`；对于页 Blob，类型为 `PageBlob`。
/skipwrite:	此选项指定不需要复制任何新数据，但要准备磁盘上的现有数据。
/enablecontentmd5:	启用此选项时，将确保计算 MD5 并将其设置为每个 blob 上的 `Content-md5` 属性。仅当希望在将数据上传到 Azure 后使用 `Content-md5` 字段时，才使用此选项。此选项不影响数据完整性检查（默认情况下会进行）。此设置确实会增加将数据上传到云所需的时间。

注意

如果导入的 blob 与目标容器中某个现有 blob 同名，则导入的 blob 将覆盖该现有 blob。在较早的工具版本（1.5.0.300 之前）中，默认情况下会重命名导入的 blob，使用 \Disposition 参数可以指定是否重命名、覆盖或忽略导入中的 blob。
如果你没有在客户端启用长路径，并且你的数据副本中的任何路径和文件名超过 256 个字符，WAImportExport 工具将报告失败。为避免此类故障，请在 Windows 客户端上启用长路径。

为需要寄送的每个磁盘重复前面的步骤。

每次运行该命令行时，都会使用所提供的名称创建一个日志文件。

与日志文件一起，还会在工具所在的同一文件夹中创建一个 <Journal file name>_DriveInfo_<Drive serial ID>.xml 文件。如果日志文件过大，在创建作业时会使用该 .xml 文件来代替日志文件。

重要

完成磁盘准备后，请勿修改日志文件或磁盘驱动器上的数据，也不要重新格式化任何磁盘。
门户允许的日志文件的最大大小为 2 MB。如果日志文件超出该限制，就会返回错误。

步骤 2：创建导入作业

执行以下步骤，通过门户对 Azure 导入/导出作业中的导入作业进行排序。

使用 Microsoft Azure 凭据在以下 URL 登录：https://portal.azure.com。
选择“+ 创建资源”并搜索 Azure Data Box。选择“Azure Data Box”。
选择“创建” 。
若要开始导入订单，请选择以下选项：
1. 选择“导入到 Azure”传输类型。
2. 选择要用于导入/导出作业的订阅。
3. 选一个择资源组。
4. 选择作业的“源国家/地区”。
5. 选择作业的“目标 Azure 区域”。
6. 然后，选择“应用”。
针对“导入/导出作业”选择“选择”按钮。
在“基本信息”中：
- 输入作业的描述性名称。可使用此名称来跟踪作业进度。
  - 名称必须包含 3 到 24 个字符。
  - 该名称必须仅包含字母、数字和连字符。
  - 名称必须以字母或数字开头和结尾。
选择“下一步: 作业详细信息 >”以继续。
在“作业详细信息”中：
1. 在继续操作之前，请确保使用最新的 WAImportExport 工具。该工具用于读取你上传的日志文件。你可以使用下载链接来更新该工具。
2. 如果需要，可更改作业的目标 Azure 区域。
3. 选择要用于作业的一个或多个存储帐户。如果需要，你可以创建一个新的存储帐户。
4. 在“驱动器信息”下，使用“复制”按钮来上传你在前面的第 1 步：准备驱动器中创建的每个日志文件。上传日志文件时，会显示驱动器 ID。
  - 如果使用了 waimportexport.exe version1，请为你准备的每个驱动器上传一个文件。
  - 如果日志文件大于 2 MB，可以使用随日志文件一起创建的 <Journal file name>_DriveInfo_<Drive serial ID>.xml。
在“退货”中：
1. 从“承运商”下拉列表中选择承运商。所选区域 Microsoft 数据中心的位置决定了哪些承运商可用。
2. 输入承运商帐号。需要有效的承运商帐户的帐号。
3. 在“退货地址”区域中，选择“+ 添加地址”按钮，并添加要寄送到的地址。
  
  在“添加地址”边栏选项卡上，可以添加地址或使用现有地址。填写地址字段后，选择“添加寄送地址”。
4. 在“通知”区域中，输入你要通知工作进度的人员的电子邮件地址。
  
  提示
  
  不要为单个用户指定电子邮件地址，而是提供组电子邮件，以确保即使管理员离开，你也会收到通知。
选择“查看 + 创建”以继续。
在“查看 + 创建”中：
1. 查看“条款”和“隐私”信息，然后选中“我确认所提供的所有信息均正确并同意上述条款和条件”旁边的复选框。然后验证便已完成。
2. 查看作业信息。记下作业名称和 Azure 数据中心送货地址，以便将将磁盘寄回。稍后将在发货标签中使用此信息。
3. 选择“创建” 。
在创建作业后，你将看到以下消息。

你可以选择“转到资源”以打开作业的“概述”。

使用以下步骤在 Azure CLI 中创建导入作业。

为 Azure CLI 准备环境

在 Azure Cloud Shell 中使用 Bash 环境。有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
- 运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

创建作业

使用 az extension add 命令添加 az import-export 扩展：
```
az extension add --name import-export
```
可以使用现有资源组，也可以创建新组。若要创建资源组，请运行 az group create 命令：
```
az group create --name myierg --location "West US"
```
可以使用现有存储帐户，也可以创建一个存储帐户。若要创建存储帐户，请运行 az storage account create 命令：
```
az storage account create --resource-group myierg --name myssdocsstorage --https-only
```
若要获取可将磁盘寄送到的位置的列表，请使用 az import-export location list 命令：
```
az import-export location list
```
使用 az import-export location show 命令获取你所在区域的位置：
```
az import-export location show --location "West US"
```

运行以下 az import-export create 命令来创建导入作业：

az import-export create \
    --resource-group myierg \
    --name MyIEjob1 \
    --location "West US" \
    --backup-drive-manifest true \
    --diagnostics-path waimportexport \
    --drive-list bit-locker-key=439675-460165-128202-905124-487224-524332-851649-442187 \
        drive-header-hash= drive-id=AZ31BGB1 manifest-file=\\DriveManifest.xml \
        manifest-hash=69512026C1E8D4401816A2E5B8D7420D \
    --type Import \
    --log-level Verbose \
    --shipping-information recipient-name="Microsoft Azure Import/Export Service" \
        street-address1="3020 Coronado" city="Santa Clara" state-or-province=CA postal-code=98054 \
        country-or-region=USA phone=4083527600 \
    --return-address recipient-name="Gus Poland" street-address1="1020 Enterprise way" \
        city=Sunnyvale country-or-region=USA state-or-province=CA postal-code=94089 \
        email=gus@contoso.com phone=4085555555" \
    --return-shipping carrier-name=FedEx carrier-account-number=123456789 \
    --storage-account myssdocsstorage

提示

请提供组电子邮件，而非为单个用户指定电子邮件地址。这可确保即使管理员离开也会收到通知。

使用 az import-export list 命令查看 myierg 资源组的所有作业：
```
az import-export list --resource-group myierg
```

若要更新作业或取消作业，请运行 az import-export update 命令：

az import-export update --resource-group myierg --name MyIEjob1 --cancel-requested true

使用以下步骤在 Azure PowerShell 中创建导入作业。

先决条件

如果选择在本地使用 Azure PowerShell：
- 安装最新版本的 Az PowerShell 模块。
- 使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。
如果选择使用 Azure Cloud Shell：
- 有关详细信息，请参阅 Azure Cloud Shell 概述。

重要

尽管 Az.ImportExport PowerShell 模块为预览版，但你需要使用 Install-Module cmdlet 单独安装它。此 PowerShell 模块正式发布后，它会包含在将来的 Az PowerShell 模块发行版中，并在 Azure Cloud Shell 中默认提供。

Install-Module -Name Az.ImportExport

创建作业

可以使用现有资源组，也可以创建新组。若要创建资源组，请运行 New-AzResourceGroup cmdlet：
```
New-AzResourceGroup -Name myierg -Location westus
```

可以使用现有存储帐户，也可以创建一个存储帐户。若要创建存储帐户，请运行 New-AzStorageAccount cmdlet：

New-AzStorageAccount -ResourceGroupName myierg -AccountName myssdocsstorage -SkuName Standard_RAGRS -Location westus -EnableHttpsTrafficOnly $true

若要获取可将磁盘寄送到的位置的列表，请使用 Get-AzImportExportLocation cmdlet：
```
Get-AzImportExportLocation
```
使用带有 Name 参数的 Get-AzImportExportLocation cmdlet 获取区域的位置：
```
Get-AzImportExportLocation -Name westus
```

运行以下 New-AzImportExport 示例来创建导入作业：

$driveList = @(@{
  DriveId = '9CA995BA'
  BitLockerKey = '439675-460165-128202-905124-487224-524332-851649-442187'
  ManifestFile = '\\DriveManifest.xml'
  ManifestHash = '69512026C1E8D4401816A2E5B8D7420D'
  DriveHeaderHash = 'AZ31BGB1'
})

$Params = @{
   ResourceGroupName = 'myierg'
   Name = 'MyIEjob1'
   Location = 'westus'
   BackupDriveManifest = $true
   DiagnosticsPath = 'waimportexport'
   DriveList = $driveList
   JobType = 'Import'
   LogLevel = 'Verbose'
   ShippingInformationRecipientName = 'Microsoft Azure Import/Export Service'
   ShippingInformationStreetAddress1 = '3020 Coronado'
   ShippingInformationCity = 'Santa Clara'
   ShippingInformationStateOrProvince = 'CA'
   ShippingInformationPostalCode = '98054'
   ShippingInformationCountryOrRegion = 'USA'
   ShippingInformationPhone = '4083527600'
   ReturnAddressRecipientName = 'Gus Poland'
   ReturnAddressStreetAddress1 = '1020 Enterprise way'
   ReturnAddressCity = 'Sunnyvale'
   ReturnAddressStateOrProvince = 'CA'
   ReturnAddressPostalCode = '94089'
   ReturnAddressCountryOrRegion = 'USA'
   ReturnAddressPhone = '4085555555'
   ReturnAddressEmail = 'gus@contoso.com'
   ReturnShippingCarrierName = 'FedEx'
   ReturnShippingCarrierAccountNumber = '123456789'
   StorageAccountId = '/subscriptions/<SubscriptionId>/resourceGroups/myierg/providers/Microsoft.Storage/storageAccounts/myssdocsstorage'
}
New-AzImportExport @Params

提示

请提供组电子邮件，而非为单个用户指定电子邮件地址。这可确保即使管理员离开也会收到通知。

使用 Get-AzImportExport cmdlet 查看 myierg 资源组的所有作业：
```
Get-AzImportExport -ResourceGroupName myierg
```

若要更新作业或取消作业，请运行 Update-AzImportExport cmdlet：

Update-AzImportExport -Name MyIEjob1 -ResourceGroupName myierg -CancelRequested

步骤 3（可选）：配置客户管理的密钥

如果要使用 Microsoft 托管密钥保护驱动器的 BitLocker 密钥，请跳过此步骤并转到下一步。若要配置自己的密钥以保护 BitLocker 密钥，请按照在 Azure 门户中使用用于 Azure 导入/导出的 Azure 密钥保管库配置客户管理的密钥中的说明进行操作。

步骤 4：寄送驱动器

可以使用 FedEx、UPS 或 DHL 将包裹寄送到 Azure 数据中心。如果想使用 FedEx/DHL 以外的承运商，请通过 adbops@microsoft.com 与 Azure Data Box 运营团队联系

请提供有效的 FedEx、UPS 或 DHL 运营商帐号，供 Microsoft 用于退回驱动器。
- 必须有 FedEx、UPS 或 DHL 帐号，才能从美国和欧洲寄回驱动器。
  - 将驱动器从亚洲和澳大利亚寄回时，推荐使用 DHL 账号。
  - 如果还没有帐号，请创建一个 FedEx 或 DHL 运营商帐户。
寄送包裹时，必须遵循 Microsoft Azure 服务条款。
正确地打包磁盘以避免潜在的损坏和处理延迟。请遵循以下建议的最佳做法：
- 请用保护性气泡膜将磁盘驱动器牢固地包裹起来。气泡膜起到减震器的作用，保护驱动器在运输过程中免受冲击。运输前，请确保整个驱动器被彻底覆盖并加衬垫。
- 请将包裹好的驱动器放入泡沫托运盒中。泡沫托运盒可提供额外的保护，并在运输过程中将驱动器牢固地固定到位。

步骤 5：使用跟踪信息更新作业

将磁盘发货后，返回 Azure 门户中的作业并填写跟踪信息。

提供跟踪详细信息后，作业状态将更改为“传送中”，并且无法取消作业。只能在作业状态为“正在创建”时取消作业。

重要

如果在创建作业后的 2 周内未更新跟踪号，该作业会过期。

若要完成在门户中创建的作业的跟踪信息，请执行以下步骤：

在 Azure 门户中打开作业。
在“概述”窗格中，向下滚动到跟踪信息并填写条目：
1. 提供承运商信息和跟踪号。
2. 请确保“收件地址”正确。
3. 选中“驱动器已发货到上述地址”旁边的复选框。
4. 在完成后，选择“更新”。

可以在“概述”窗格上跟踪作业进度。有关每个作业状态的说明，请转到查看作业状态。

显示预览门户中 Azure 导入/导出作业“概述”窗格上的状态跟踪的屏幕截图。

步骤 6：验证 Azure 中的数据上传

请跟踪作业至完成，然后验证上传是否成功以及是否所有数据都存在。

查看已完成作业的数据复制详细信息以查找作业中包含的每个驱动器的日志：

使用详细日志来验证每个成功传输的文件。
使用复制日志来查找每个失败数据副本的源。

有关详细信息，请参阅查看导入和导出的复制日志。

验证数据传输后，可以删除本地数据。仅在已确认上传成功后才删除本地数据。

注意

如果任何路径和文件名超过 256 个字符，并且客户端未启用长路径，则数据上传将失败。为避免此类故障，请在 Windows 客户端上启用长路径。

通过

教程：使用 Azure 导入/导出服务将数据导入 Azure Blob 存储

先决条件

步骤 1：准备驱动器

步骤 2：创建导入作业

为 Azure CLI 准备环境

创建作业

先决条件

创建作业

步骤 3（可选）：配置客户管理的密钥

步骤 4：寄送驱动器

步骤 5：使用跟踪信息更新作业

步骤 6：验证 Azure 中的数据上传

后续步骤

反馈

其他资源