로그를 사용하여 Azure Data Box Disk 유효성 검사 문제 해결

이 문서는 Microsoft Azure Data Box Disk에 적용됩니다. 이 문서에서는 로그를 사용하여 이 솔루션을 배포할 때 확인될 수 있는 유효성 검사 문제를 해결하는 방법을 설명합니다.

유효성 검사 도구 로그 파일

유효성 검사 도구를 사용하여 디스크에서 데이터의 유효성을 검사하는 경우 오류를 기록하기 위해 error.xml이 생성됩니다. 이 로그 파일은 드라이브의 Drive:\DataBoxDiskImport\logs 폴더에 배치됩니다. 유효성 검사를 실행할 때 오류 로그에 대한 링크가 제공됩니다.

유효성 검사를 위해 여러 세션을 실행하는 경우 세션당 하나의 오류 로그가 생성됩니다.

  • 다음은 PageBlob 폴더에 로드된 데이터가 512바이트로 정렬되지 않은 경우의 오류 로그 샘플입니다. PageBlob에 업로드된 데이터는 512바이트로 정렬되어야 합니다(예: VHD 또는 VHDX). 이 파일의 오류는 <Errors>에 있고 경고는 <Warnings>에 있습니다.

    <?xml version="1.0" encoding="utf-8"?>
        <ErrorLog Version="2018-10-01">
            <SessionId>session#1</SessionId>
            <ItemType>PageBlob</ItemType>
            <SourceDirectory>D:\Dataset\TestDirectory</SourceDirectory>
            <Errors>
                <Error Code="Not512Aligned">
                    <Description>The file is not 512 bytes aligned.</Description>
                    <List>
                        <File Path="\Practice\myScript.ps1" />
                    </List>
                    <Count>1</Count>
                </Error>
            </Errors>
            <Warnings />
        </ErrorLog>
    
  • 다음은 컨테이너 이름이 유효하지 않은 경우의 오류 로그 샘플입니다. 디스크의 BlockBlob, PageBlob 또는 AzureFile 폴더 아래에 만든 폴더는 Azure Storage 계정의 컨테이너가 됩니다. 컨테이너의 이름은 Azure 명명 규칙을 따라야 합니다.

    <?xml version="1.0" encoding="utf-8"?>
    <ErrorLog Version="2018-10-01">
        <SessionId>bbsession</SessionId>
        <ItemType>BlockBlob</ItemType>
        <SourceDirectory>E:\BlockBlob</SourceDirectory>
        <Errors>
        <Error Code="InvalidShareContainerFormat">
            <List>
            <Container Name="Azu-reFile" />
            <Container Name="bbcont ainer1" />
            </List>
            <Count>2</Count>
        </Error>
        </Errors>
        <Warnings />
    </ErrorLog>
    

유효성 검사 도구 오류

error.xml에 포함된 오류와 해당 권장 작업은 다음 표에 요약되어 있습니다.

오류 코드 설명 권장 조치
None 데이터의 유효성을 검사했습니다. 사용자가 조치할 필요는 없습니다.
InvalidXmlCharsInPath 파일 경로에 잘못된 문자가 있기 때문에 매니페스트 파일을 만들 수 없습니다. 계속하려면 이러한 문자를 제거합니다.
OpenFileForReadFailed 파일을 처리할 수 없습니다. 액세스 문제나 파일 시스템 손상 때문일 수 있습니다. 오류로 인해 파일을 읽을 수 없습니다. 오류 세부 정보는 예외에 나와 있습니다.
Not512Aligned 이 파일은 PageBlob 폴더의 올바른 형식이 아닙니다. 512바이트를 PageBlob 폴더에 맞춘 데이터만 업로드합니다. 파일을 PageBlob 폴더에서 제거하거나 BlockBlob 폴더로 이동합니다. 유효성 검사를 다시 시도합니다.
InvalidBlobPath Azure Blob 명명 규칙에 따라 파일 경로가 클라우드의 올바른 Blob 경로에 매핑되지 않습니다. Azure 명명 지침에 따라 파일 경로의 이름을 바꿉니다.
EnumerationError 유효성 검사를 위해 파일을 열거할 수 없습니다. 이 오류에는 여러 가지 이유가 있을 수 있습니다. 가장 가능성이 높은 이유는 파일에 대한 액세스입니다.
ShareSizeExceeded 이 파일 때문에 Azure 파일 공유 크기가 Azure 제한인 5TB를 초과합니다. Azure 개체 크기 제한을 벗어나지 않도록 공유의 데이터 크기를 줄입니다. 유효성 검사를 다시 시도합니다.
AzureFileSizeExceeded 파일 크기가 Azure 파일 크기 제한을 초과합니다. Azure 개체 크기 제한에 맞도록 공유의 데이터 크기를 줄입니다. 유효성 검사를 다시 시도합니다.
BlockBlobSizeExceeded 파일 크기가 Azure 블록 Blob 크기 제한을 초과합니다. Azure 개체 크기 제한에 맞도록 공유의 데이터 크기를 줄입니다. 유효성 검사를 다시 시도합니다.
ManagedDiskSizeExceeded 파일 크기가 Azure Managed Disk 크기 제한을 초과합니다. Azure 개체 크기 제한에 맞도록 공유의 데이터 크기를 줄입니다. 유효성 검사를 다시 시도합니다.
PageBlobSizeExceeded 파일 크기가 Azure Managed Disk 크기 제한을 초과합니다. Azure 개체 크기 제한에 맞도록 공유의 데이터 크기를 줄입니다. 유효성 검사를 다시 시도합니다.
InvalidShareContainerFormat 디렉터리 이름이 컨테이너 또는 공유의 Azure 명명 규칙을 따르지 않습니다. 디스크의 기존 폴더에 만든 첫 번째 폴더는 스토리지 계정의 컨테이너가 됩니다. 이 공유 또는 컨테이너 이름이 Azure 명명 규칙에 맞지 않습니다. Azure 명명 규칙에 맞도록 파일 이름을 바꿉니다. 유효성 검사를 다시 시도합니다.
InvalidBlobNameFormat Azure Blob 명명 규칙에 따라 파일 경로가 클라우드의 올바른 Blob 경로에 매핑되지 않습니다. Azure 명명 규칙에 맞도록 파일 이름을 바꿉니다. 유효성 검사를 다시 시도합니다.
InvalidFileNameFormat 파일 경로가 Azure 파일 명명 규칙에 따라 클라우드의 올바른 파일 경로에 매핑되지 않습니다. Azure 명명 규칙에 맞도록 파일 이름을 바꿉니다. 유효성 검사를 다시 시도합니다.
InvalidDiskNameFormat 파일 경로가 Azure Managed Disk 명명 규칙에 따라 클라우드의 올바른 디스크 이름에 매핑되지 않습니다. Azure 명명 규칙에 맞도록 파일 이름을 바꿉니다. 유효성 검사를 다시 시도합니다.
NotPartOfFileShare 파일의 업로드 경로가 잘못되었습니다. Azure Files의 폴더로 파일을 업로드합니다. 오류가 발생한 파일을 제거하고 미리 만든 폴더에 파일을 업로드합니다. 유효성 검사를 다시 시도합니다.
NonVhdFileNotSupportedForManagedDisk 비 VHD 파일은 Managed Disk로서 업로드할 수 없습니다. 비 VHD 파일은 지원되지 않으므로 ManagedDisk 폴더에서 제거하거나 PageBlob 폴더로 이동하세요. 유효성 검사를 다시 시도합니다.

다음 단계