排查 Azure Data Box 中的数据复制问题

本文介绍如何排查为 Azure Data Box 导入订单执行数据复制或数据上传时出现的问题。 本文列出了在将数据复制到 Data Box 或从 Data Box 上传数据时可能出现的错误。

有关排查访问设备上共享的问题的帮助,请参阅排查复制数据期间共享连接失败的问题

注意

本文中的信息仅适用于导入订单。

错误类

Data Box 中的错误概括如下:

错误类别 说明 建议的操作
容器或共享名称* 容器或共享名称未遵循 Azure 命名规则。 下载错误列表。
重命名容器或共享。 了解详细信息
容器或共享大小限制* 容器或共享中的总数据量超过了 Azure 限制。 下载错误列表。
减小容器或共享中的总数据量。 了解详细信息
对象或文件大小限制* 容器或共享中的对象或文件大小超过了 Azure 限制。 下载错误列表。
减小容器或共享中的文件大小。 了解详细信息
数据或文件类型* 数据格式或文件类型不受支持。 下载错误列表。
对于页 Blob 或托管磁盘,请确保数据已经过 512 字节对齐,并已复制到预先创建的文件夹。 了解详细信息
文件夹或文件内部错误* 文件或文件夹出现内部错误。 下载错误列表。
删除文件并重新复制。 对于文件夹,请重命名或者添加或删除文件对其进行修改。 错误会在 30 分钟内消失。 了解详细信息
常规错误* 代码中的内部异常或错误路径导致了关键错误。 重新启动设备,然后重新运行“准备交付”操作。 如果错误未消失,请联系 Microsoft 支持部门。 了解详细信息
非关键 Blob 或文件错误 Blob 或文件名称未遵循 Azure 命名规则,或文件类型不受支持。 无法复制这些 Blob 或文件,或者名称可能已更改。 了解如何修复这些错误

* 此类别的错误属于关键错误,必须予以修复才能继续运行“准备交付”。

容器或共享名称错误

这些错误与容器和共享名称相关。

ERROR_CONTAINER_OR_SHARE_NAME_LENGTH

错误说明:容器或共享名称必须包含 3 到 63 个字符。

建议的解决方法: Data Box 或 Data Box Heavy 共享 (SMB/NFS) 中的、将数据复制到的文件夹会成为存储帐户中的一个 Azure 容器。

  • 在设备本地 Web UI 的“连接和复制”页上,下载并查看错误文件,以找出有问题的文件夹名称。

  • 更改 Data Box 或 Data Box Heavy 共享中的文件夹名称,以确保:

    • 名称包含 3 到 63 个字符。
    • 名称只能包含字母、数字和连字符。
    • 名称不能以连字符开头或结尾。
    • 名称不能包含连续的连字符。
    • 有效名称的示例:my-folder-1my-really-extra-long-folder-111
    • 无效名称的示例:my-folder_1my--myfoldermyfolder--myfolder!

    有关详细信息,请参阅容器名称共享名称的 Azure 命名约定。

ERROR_CONTAINER_OR_SHARE_NAME_ALPHA_NUMERIC_DASH

错误说明:容器或共享名称只能包含字母、数字或连字符。

建议的解决方法: Data Box 或 Data Box Heavy 共享 (SMB/NFS) 中的、将数据复制到的文件夹会成为存储帐户中的一个 Azure 容器。

  • 在设备本地 Web UI 的“连接和复制”页上,下载并查看错误文件,以找出有问题的文件夹名称。

  • 更改 Data Box 或 Data Box Heavy 共享中的文件夹名称,以确保:

    • 名称包含 3 到 63 个字符。
    • 名称只能包含字母、数字和连字符。
    • 名称不能以连字符开头或结尾。
    • 名称不能包含连续的连字符。
    • 有效名称的示例:my-folder-1my-really-extra-long-folder-111
    • 无效名称的示例:my-folder_1my--myfoldermyfolder--myfolder!

    有关详细信息,请参阅容器名称共享名称的 Azure 命名约定。

ERROR_CONTAINER_OR_SHARE_NAME_IMPROPER_DASH

错误说明:容器名称和共享名称不能以连字符开头或结尾,并且不能包含连续的连字符。

建议的解决方法: Data Box 或 Data Box Heavy 共享 (SMB/NFS) 中的、将数据复制到的文件夹会成为存储帐户中的一个 Azure 容器。

  • 在设备本地 Web UI 的“连接和复制”页上,下载并查看错误文件,以找出有问题的文件夹名称。

  • 更改 Data Box 共享中的文件夹名称,以确保:

    • 名称包含 3 到 63 个字符。
    • 名称只能包含字母、数字和连字符。
    • 名称不能以连字符开头或结尾。
    • 名称不能包含连续的连字符。
    • 有效名称的示例:my-folder-1my-really-extra-long-folder-111
    • 无效名称的示例:my-folder_1my--myfoldermyfolder--myfolder!

    有关详细信息,请参阅容器名称共享名称的 Azure 命名约定。

ERROR_FILE_OR_DIRECTORY_NAME_ILLEGAL

错误说明: 目录或容器名称包含非法字符。

建议的解决方法: 复制的目录或容器名称包含不受支持的字符。

  • 在本地 Web UI 的“连接和复制”页上,下载并查看错误文件,以找出有问题的文件夹名称。
  • 为目录或容器重命名,确保它们符合 Azure 命名约定。

有关详细信息,请参阅目录容器的 Azure 命名约定。

容器或共享大小限制错误

这些错误与超过了容器或共享中允许的数据大小的数据相关。

ERROR_CONTAINER_OR_SHARE_CAPACITY_EXCEEDED

错误说明:你的存储帐户上未启用大型文件共享。

建议的解决方法:若要忽略此错误,请执行以下步骤:

  1. 在 Data Box 本地 UI 中,转到“连接和复制”页,然后转到“设置”。

    连接和复制

  2. 启用并应用“忽略大型文件共享错误”。

    连接并复制设置

  3. 在 Azure 门户中对存储帐户“启用大型文件共享”。

注意

如果未在 Azure 门户中为指示的存储帐户启用大型文件共享,则向这些存储帐户上传数据将会失败。

对象或文件大小限制错误

这些错误与超过了 Azure 中允许的最大对象或文件大小的数据相关。

ERROR_BLOB_OR_FILE_SIZE_LIMIT

错误说明:文件大小超过了最大上传文件大小。

建议的解决方法: Blob 或文件大小超过了允许的最大上传限制。

  • 在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。
  • 确保 Blob 和文件大小不超过 Azure 对象大小限制。

数据或文件类型错误

这些错误与在容器或共享中找到不受支持的文件类型或数据类型相关。

ERROR_BLOB_OR_FILE_SIZE_ALIGNMENT

错误说明:Blob 或文件未正确对齐。

建议的解决方法: Data Box 或 Data Box Heavy 上的页 Blob 共享仅支持经过 512 字节对齐的文件(例如 VHD/VHDX)。 复制到页 Blob 共享的任何数据将作为页 Blob 上传到 Azure。

从页 Blob 共享中删除任何非 VHD/VHDX 数据。 可以使用块 Blob 或 Azure 文件的共享还存储一般数据。

有关详细信息,请参阅页 Blob 概述

ERROR_BLOB_OR_FILE_TYPE_UNSUPPORTED

错误说明:托管磁盘共享中存在不受支持的文件类型。 只允许固定的 VHD。

建议的解决方法:

  • 确保仅上传固定的 VHD 来创建托管磁盘。
  • 不支持 VHDX 文件或者动态 VHD 和差异 VHD。

ERROR_DIRECTORY_DISALLOWED_FOR_TYPE

错误说明:托管磁盘的任何现有文件夹中不允许某个目录。 这些文件夹中只允许固定的 VHD。

建议的解决方法: 对于托管磁盘,会在每个共享中创建对应于存储帐户中的容器的以下三个文件夹:高级 SSD、标准 HDD 和标准 SSD。 这些文件夹对应于托管磁盘的性能层。

  • 确保将页 Blob 数据 (VHD) 复制到其中一个现有文件夹。
  • 这些现有的文件夹中不允许某个文件夹或目录。 请删除在这些现有文件夹中创建的所有文件夹。

有关详细信息,请参阅复制到托管磁盘

REPARSE_POINT_ERROR

错误说明:不允许在 Linux 中使用符号链接。

建议的解决方法: 符号链接通常是链接、竖线和文件等其他元素。 请删除链接,或解决链接错误并复制数据。

文件夹或文件内部错误

错误说明: 文件或文件夹为内部错误状态。

建议的解决方法: 如果这是一个文件,请删除该文件,然后再次复制。 如果这是一个文件夹,请修改该文件夹。 重命名文件夹,或者添加或删除文件夹中的文件。 错误会在 30 分钟内自行清除。 如果错误仍然存在,请联系 Azure 支持部门。

常规错误

常规错误是代码中的内部异常或错误路径造成的。

ERROR_GENERAL

错误说明:此常规错误是代码中的内部异常或错误路径造成的。

建议的解决方法:重新启动设备,然后重新运行“准备交付”操作。 如果错误未消失,请联系 Azure 支持部门

非关键 Blob 或文件错误

以下部分总结了与在数据复制期间看到的 blob、文件或容器的名称有关的所有非关键错误。 如果出现这些错误,则会修改名称,使其符合 Azure 命名约定。 数据上传的相应订单状态将为“已完成,但出现警告”

ERROR_BLOB_OR_FILE_NAME_CHARACTER_CONTROL

错误说明:Blob 或文件的名称包含不受支持的控制字符。

建议的解决方法: 复制的 Blob 或文件的名称包含不受支持的字符。

在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。 删除或重命名这些文件,以删除不受支持的字符。

有关详细信息,请参阅 Blob 名称文件名的 Azure 命名约定。

ERROR_BLOB_OR_FILE_NAME_CHARACTER_ILLEGAL

错误说明:Blob 或文件的名称包含非法字符。

建议的解决方法: 复制的 Blob 或文件的名称包含不受支持的字符。

在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。 删除或重命名这些文件,以删除不受支持的字符。

有关详细信息,请参阅 Blob 名称文件名的 Azure 命名约定。

ERROR_BLOB_OR_FILE_NAME_ENDING

错误说明:Blob 或文件的名称以错误的字符结尾。

建议的解决方法: 复制的 Blob 或文件的名称包含不受支持的字符。

在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。 删除或重命名这些文件,以删除不受支持的字符。

有关详细信息,请参阅 Blob 名称文件名的 Azure 命名约定。

ERROR_BLOB_OR_FILE_NAME_SEGMENT_COUNT

错误说明:Blob 或文件的名称包含过多的路径段。

建议的解决方法: 复制的文件或 Blob 超过了最大路径段数。 路径段是指连续分隔符(例如正斜杠 /)之间的字符串。

  • 在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。
  • 确保 Blob 名称文件名符合 Azure 命名约定。

ERROR_BLOB_OR_FILE_NAME_AGGREGATE_LENGTH

错误说明:Blob 或文件名太长。

建议的解决方法: Blob 或文件的名称超过了最大长度。

  • 在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。
  • Blob 名称不得超过 1,024 个字符。
  • 删除或者重命名 Blob 或文件,使其名称不超过 1,024 个字符。

有关详细信息,请参阅 Blob 名称和文件名的 Azure 命名约定。

ERROR_BLOB_OR_FILE_NAME_COMPONENT_LENGTH

错误说明:Blob 或文件名中的某个段太长。

建议的解决方法: Blob 或文件名称中的某个路径段超过了最大字符数。 路径段是指连续分隔符(例如正斜杠 /)之间的字符串。

  • 在本地 Web UI 的“连接和复制”页上,下载并查看错误文件。
  • 确保 Blob 名称文件名符合 Azure 命名约定。

ERROR_CONTAINER_OR_SHARE_NAME_DISALLOWED_FOR_TYPE

错误说明:为托管磁盘共享指定的容器名称不正确。

建议的解决方法: 对于托管磁盘,会在每个共享中创建对应于存储帐户中的容器的以下文件夹:高级 SSD、标准 HDD 和标准 SSD。 这些文件夹对应于托管磁盘的性能层。

  • 确保将页 Blob 数据 (VHD) 复制到其中一个现有文件夹。 只有这些现有容器中的数据才会上传到 Azure。
  • 在与高级 SSD、标准 HDD 和标准 SSD 相同的级别创建的任何其他文件夹不对应于有效的性能层,因此不能使用。
  • 删除在性能层外部创建的文件或文件夹。

有关详细信息,请参阅复制到托管磁盘

非关键容器或共享错误

ERROR_CONTAINER_OR_SHARE_CAPACITY_EXCEEDED

错误说明:Data Box 忽略大型文件共享错误。 请记住在 Azure 门户中对存储帐户“启用大型文件共享”。 如果未在门户中对这些存储帐户启用大型文件共享,则向这些帐户上传数据将会失败。

建议的解决方法:在 Azure 门户中对存储帐户“启用大型文件共享”。 如果未在门户中对这些存储帐户启用大型文件共享,则向这些帐户上传数据将会失败。

后续步骤