Windows에서 AzCopy v8.1을 사용하여 데이터 전송

  • 아티클

AzCopy는 최적의 성능을 위해 설계된 간단한 명령을 사용하여 Microsoft Azure Blob, File 및 Table Storage 간에 데이터를 복사하도록 설계된 명령줄 유틸리티입니다. 파일 시스템과 스토리지 계정 간 또는 스토리지 계정 간에 데이터를 복사할 수 있습니다.

Important

이 문서에서는 이전 버전의 AzCopy에 대해 설명합니다. 최신 버전의 AzCopy를 설치하려면 AzCopy v10을 참조 하세요.

이전 버전의 AzCopy(AzCopy v8.1)를 설치하도록 선택한 경우 다운로드할 수 있는 여러 버전이 있습니다. Windows의 AzCopy는 Windows 스타일 명령줄 옵션을 제공합니다. Linux 의 AzCopy는 POSIX 스타일 명령줄 옵션을 제공하는 Linux 플랫폼을 대상으로 합니다. 이 문서에서는 Windows의 AzCopy에 대해 설명합니다.

Windows에서 AzCopy(v8.1) 다운로드 및 설치

Windows에서 AzCopy(v8.1)를 다운로드합니다.

Windows 8.1의 AzCopy 릴리스 정보

  • Table service는 최신 버전에서 더 이상 지원되지 않습니다. 테이블 내보내기 기능을 사용하는 경우 AzCopy 7.3 버전을 다운로드합니다.
  • .NET Core 2.1을 사용하여 빌드한 모든 .NET Core 종속성은 이제 설치에서 패키징됩니다.
  • OAuth 인증 지원이 추가되었습니다. Azure Active Directory를 사용하여 로그온하는 데 사용합니다 azcopy login .

테이블 지원을 사용하는 Azcopy(v7.3)

테이블 지원을 사용하여 AzCopy 7.3을 다운로드합니다.

설치 후 단계

설치 관리자를 사용하여 Windows에 AzCopy를 설치한 후 명령 창을 열고 실행 파일이 있는 AzCopy.exe 컴퓨터의 AzCopy 설치 디렉터리로 이동합니다. 원하는 경우 AzCopy 설치 위치를 시스템 경로에 추가할 수 있습니다. 기본적으로 AzCopy는 설치됩니다 %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy %ProgramFiles%\Microsoft SDKs\Azure\AzCopy.

첫 번째 AzCopy 명령 작성

AzCopy 명령의 기본 구문은 다음과 같습니다.

AzCopy /Source:<source> /Dest:<destination> [Options]

다음 예제에서는 Microsoft Azure Blob, 파일 및 테이블 간에 데이터를 복사하는 다양한 시나리오를 보여 줍니다. 각 샘플에서 사용되는 매개 변수 에 대한 자세한 설명은 AzCopy 매개 변수 섹션을 참조하세요.

Blob Storage에서 Blob 다운로드

AzCopy를 사용하여 Blob을 다운로드하는 여러 가지 방법을 살펴보겠습니다.

단일 Blob 다운로드

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

폴더 C:\myfolder 가 없으면 AzCopy에서 폴더를 만들고 새 폴더에 다운로드 abc.txt 합니다.

보조 지역에서 단일 Blob 다운로드

AzCopy /Source:https://myaccount-secondary.blob.core.windows.net/mynewcontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

보조 지역에 액세스하려면 읽기 액세스 지역 중복 스토리지를 사용하도록 설정해야 합니다.

컨테이너의 모든 Blob 다운로드

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /S

다음 Blob이 지정된 컨테이너에 있는 경우를 생각해 보겠습니다.

abc.txt
abc1.txt
abc2.txt
vd1\a.txt
vd1\abcd.txt

다운로드 작업 후 디렉터리에 C:\myfolder 는 다음 파일이 포함됩니다.

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\vd1\a.txt
C:\myfolder\vd1\abcd.txt

옵션을 /S지정하지 않으면 Blob이 다운로드되지 않습니다.

특정 접두사를 사용하여 Blob 다운로드

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:a /S

다음 Blob이 지정된 컨테이너에 있다고 가정합니다. 접두사 a로 시작하는 모든 Blob이 다운로드됩니다.

abc.txt
abc1.txt
abc2.txt
xyz.txt
vd1\a.txt
vd1\abcd.txt

다운로드 작업 후 폴더 C:\myfolder 에는 다음 파일이 포함됩니다.

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

접두사는 Blob 이름의 처음 부분을 구성하는 가상 디렉터리에 적용됩니다. 위에 표시된 예제에서 가상 디렉터리가 지정된 접두사와 일치하지 않으므로 다운로드되지 않습니다. 또한 옵션을 /S 지정하지 않으면 AzCopy는 Blob을 다운로드하지 않습니다.

내보낸 파일의 마지막 수정 시간을 원본 Blob과 동일하게 설정합니다.

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT

마지막으로 수정한 시간에 따라 다운로드 작업에서 Blob을 제외할 수도 있습니다. 예를 들어 마지막으로 수정된 시간이 대상 파일과 동일하거나 더 최신인 Blob을 제외하려는 경우 /XN 옵션을 추가합니다.

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XN

마지막으로 수정한 시간이 대상 파일과 동일하거나 오래된 Blob을 제외하려면 다음 옵션을 추가 /XO 합니다.

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XO

Blob Storage에 Blob 업로드

AzCopy를 사용하여 Blob을 업로드하는 여러 방법을 살펴보겠습니다.

단일 Blob 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:"abc.txt"

지정된 대상 컨테이너가 존재하지 않을 경우 AzCopy는 컨테이너를 만든 후 여기에 파일을 업로드합니다.

가상 디렉터리에 단일 Blob 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer/vd /DestKey:key /Pattern:abc.txt

지정된 가상 디렉터리가 없는 경우 AzCopy는 가상 디렉터리를 이름에 포함하도록 파일을 업로드합니다(예:vd/abc.txt 위 예제).

폴더의 모든 Blob 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /S

/S 옵션을 지정하면 지정된 디렉터리의 내용이 Blob Storage에 재귀적으로 업로드됩니다. 즉, 모든 하위 폴더 및 해당 파일도 업로드됩니다. 예를 들어 다음 파일이 폴더 C:\myfolder에 있다고 가정합니다.

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

업로드 작업 후 컨테이너에는 다음 파일이 포함됩니다.

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

옵션을 /S지정하지 않으면 AzCopy가 재귀적으로 업로드되지 않습니다. 업로드 작업 후 컨테이너에는 다음 파일이 포함됩니다.

abc.txt
abc1.txt
abc2.txt

특정 패턴과 일치하는 Blob 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:a* /S

다음 파일이 C:\myfolder폴더에 있는 경우를 생각해 보겠습니다.

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\xyz.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

업로드 작업 후 컨테이너에는 다음 파일이 포함됩니다.

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

/S 옵션을 지정하지 않으면, AzCopy만 가상 디렉터리에 존재하지 않는 Blob만 업로드합니다.

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

대상 Blob의 MIME 콘텐츠 형식을 지정합니다.

기본적으로 AzCopy는 대상 Blob의 콘텐츠 형식을 .로 application/octet-stream설정합니다. 버전 3.1.0부터 옵션을 /SetContentType:[content-type]통해 콘텐츠 형식을 명시적으로 지정할 수 있습니다. 이 구문은 업로드 작업에서 모든 Blob의 콘텐츠 형식을 설정합니다.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType:video/mp4

값 없이 /SetContentType을 지정하면 AzCopy에서 각 Blob 또는 파일의 콘텐츠 형식을 파일 확장명에 따라 설정합니다.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType

Blob Storage에서 Blob 복사

AzCopy를 사용하여 한 위치에서 다른 위치로 Blob을 복사하는 여러 가지 방법을 살펴보겠습니다.

동일한 스토리지 계정 내에서 한 컨테이너에서 다른 컨테이너로 단일 Blob 복사

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceKey:key /DestKey:key /Pattern:abc.txt

Storage 계정 내에서 Blob을 복사하면 서버 쪽 복사 작업이 수행됩니다.

스토리지 계정 간에 단일 Blob 복사

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

Storage 계정 간 Blob을 복사할 때는 서버 쪽 복사 작업이 수행됩니다.

보조 지역에서 주 지역으로 단일 Blob 복사

AzCopy /Source:https://myaccount1-secondary.blob.core.windows.net/mynewcontainer1 /Dest:https://myaccount2.blob.core.windows.net/mynewcontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

보조 스토리지에 액세스하려면 읽기 액세스 지역 중복 스토리지가 활성화되어 있어야 합니다.

단일 Blob 및 해당 스냅샷을 한 스토리지 계정에서 다른 스토리지 계정으로 복사

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt /Snapshot

복사 작업 후에 대상 컨테이너에는 Blob 및 해당 스냅샷이 포함됩니다. 위 예제의 Blob에 두 개의 스냅샷이 있다고 가정하면 컨테이너에는 다음 Blob 및 스냅샷이 포함됩니다.

abc.txt
abc (2013-02-25 080757).txt
abc (2014-02-21 150331).txt

컨테이너의 모든 Blob을 다른 스토리지 계정에 복사

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 
/Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /S

/S 옵션을 지정하면 지정된 컨테이너의 콘텐츠를 재귀적으로 업로드합니다. 자세한 내용 및 예제는 폴더의 모든 Blob 업로드를 참조하세요.

스토리지 계정 간에 비동기적으로 Blob 복사

기본적으로 AzCopy는 두 스토리지 엔드포인트 간에 데이터를 비동기적으로 복사합니다. 따라서 복사 작업은 Blob이 복사되는 속도와 관련하여 SLA가 없는 예비 대역폭 용량을 사용하여 백그라운드에서 실행되며, AzCopy는 복사가 완료되거나 실패할 때까지 주기적으로 복사 상태를 확인합니다.

이 /SyncCopy 옵션을 사용하면 복사 작업이 일관된 속도를 얻을 수 있습니다. AzCopy는 지정된 원본에서 로컬 메모리로 복사할 Blob을 다운로드한 다음 Blob Storage 대상으로 업로드하여 동기 복사를 수행합니다.

AzCopy /Source:https://myaccount1.blob.core.windows.net/myContainer/ /Dest:https://myaccount2.blob.core.windows.net/myContainer/ /SourceKey:key1 /DestKey:key2 /Pattern:ab /SyncCopy

/SyncCopy 비동기 복사에 비해 추가 송신 비용이 발생할 수 있습니다. 송신 비용을 방지하기 위해 원본 스토리지 계정과 동일한 지역에 있는 Azure VM에서 이 옵션을 사용하는 것이 좋습니다.

File Storage에서 파일 다운로드

AzCopy를 사용하여 파일을 다운로드하는 여러 방법을 살펴보겠습니다.

단일 파일 다운로드

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/myfolder1/ /Dest:C:\myfolder /SourceKey:key /Pattern:abc.txt

지정된 원본이 Azure 파일 공유인 경우 단일 파일을 다운로드하려면 정확한 파일 이름(예: abc.txt)을 지정하거나 공유의 모든 파일을 재귀적으로 다운로드하는 옵션을 /S 지정해야 합니다. 파일 패턴과 /S 옵션을 함께 지정하려고 하면 오류가 발생합니다.

디렉터리에서 모든 파일 다운로드

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/ /Dest:C:\myfolder /SourceKey:key /S

빈 폴더는 다운로드되지 않습니다.

Azure 파일 공유에 파일 업로드

AzCopy를 사용하여 파일을 업로드하는 여러 방법을 살펴보겠습니다.

단일 파일 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:abc.txt

폴더의 모든 파일 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /S

빈 폴더는 업로드되지 않습니다.

특정 패턴과 일치하는 파일 업로드

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:ab* /S

File Storage에서 파일 복사

AzCopy를 사용하여 Azure 파일 공유의 파일을 복사하는 여러 가지 방법을 살펴보겠습니다.

파일 공유 간에 복사

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S

파일 공유에 파일을 복사할 때는 서버 쪽 복사 작업이 수행됩니다.

Azure 파일 공유에서 Blob Storage로 복사

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare/ /Dest:https://myaccount2.blob.core.windows.net/mycontainer/ /SourceKey:key1 /DestKey:key2 /S

파일 공유에서 Blob으로 파일을 복사할 때는 서버 쪽 복사 작업이 수행됩니다.

Blob Storage에서 Azure 파일 공유로 Blob 복사

AzCopy /Source:https://myaccount1.blob.core.windows.net/mycontainer/ /Dest:https://myaccount2.file.core.windows.net/myfileshare/ /SourceKey:key1 /DestKey:key2 /S

Blob에서 파일 공유 로 파일을 복사하면 서버 쪽 복사 작업이 수행됩니다.

동기적으로 파일 복사

/SyncCopy 옵션을 지정하여 File Storage 간에, File Storage에서 Blob Storage로, Blob Storage에서 File Storage로 동기적으로 데이터를 복사할 수 있습니다. AzCopy는 로컬 메모리에 원본 데이터를 다운로드한 후 대상에 다시 업로드하여 이 작업을 수행합니다. 표준 송신 비용이 적용됩니다.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S /SyncCopy

File Storage에서 Blob Storage로 복사할 때 기본 Blob 유형은 블록 Blob입니다. 사용자는 대상 Blob 형식을 변경하는 옵션을 /BlobType:page 지정할 수 있습니다.

/SyncCopy 비동기 복사에 비해 추가 송신 비용이 발생할 수 있습니다. 송신 비용을 방지하기 위해 원본 스토리지 계정과 동일한 지역에 있는 Azure VM에서 이 옵션을 사용하는 것이 좋습니다.

Table Storage에서 데이터 내보내기

AzCopy를 사용하여 Azure Table Storage에서 데이터를 내보내는 방법에 대해 살펴보겠습니다.

테이블 내보내기

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key

AzCopy는 매니페스트 파일을 지정된 대상 폴더에 씁니다. 매니페스트 파일은 필요한 데이터 파일을 찾고 데이터 유효성 검사를 수행하는 가져오기 프로세스에서 사용됩니다. 매니페스트 파일은 기본적으로 다음 명명 규칙을 사용합니다.

<account name>_<table name>_<timestamp>.manifest

사용자는 매니페스트 파일 이름을 설정하는 옵션을 /Manifest:<manifest file name> 지정할 수도 있습니다.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /Manifest:abc.manifest

Table Storage에서 여러 파일로 내보내기 분할

AzCopy /Source:https://myaccount.table.core.windows.net/mytable/ /Dest:C:\myfolder /SourceKey:key /S /SplitSize:100

AzCopy는 분할 데이터 파일 이름의 볼륨 인덱 스로 여러 파일을 구분합니다. 볼륨 인덱스는 파티션 키 범위 인덱스와 분할 파일 인덱스의 두 부분으로 구성됩니다. 두 인덱스는 모두 0부터 시작됩니다.

사용자가 옵션을 /PKRS지정하지 않으면 파티션 키 범위 인덱스는 0입니다.

예를 들어 AzCopy가 사용자가 옵션을 /SplitSize지정한 후 두 개의 데이터 파일을 생성한다고 가정합니다. 이 경우 결과 데이터 파일 이름은 다음과 같습니다.

myaccount_mytable_20140903T051850.8128447Z_0_0_C3040FE8.json
myaccount_mytable_20140903T051850.8128447Z_0_1_0AB9AC20.json

옵션 /SplitSize 에 사용할 수 있는 최소값은 32MB입니다. 지정된 대상이 Blob Storage인 경우 AzCopy는 사용자가 옵션을 /SplitSize 지정했는지 여부에 관계없이 크기가 Blob 크기 제한(200GB)에 도달하면 데이터 파일을 분할합니다.

테이블을 JSON 또는 CSV 데이터 파일 형식으로 내보내기

기본적으로 AzCopy는 테이블을 JSON 데이터 파일로 내보냅니다. 테이블을 JSON 또는 CSV로 내보내는 옵션을 /PayloadFormat:JSON|CSV 지정할 수 있습니다.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PayloadFormat:CSV

CSV 페이로드 형식을 지정할 때 AzCopy는 각 데이터 파일에 대한 파일 확장 .schema.csv 명의 스키마 파일도 생성합니다.

동시에 테이블 엔터티 내보내기

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PKRS:"aa#bb"

AzCopy는 사용자가 옵션을 /PKRS지정할 때 엔터티를 내보내는 동시 작업을 시작합니다. 각 작업은 하나의 파티션 키 범위를 내보냅니다.

/NC옵션도 동시 작업 수를 제어합니다. AzCopy는 지정되지 않은 경우에도 /NC 테이블 엔터티를 복사할 때의 기본값 /NC 으로 코어 프로세서 수를 사용합니다. 사용자가 옵션을 /PKRS지정하면 AzCopy는 파티션 키 범위와 암시적 또는 명시적으로 지정된 동시 작업의 두 값 중 더 작은 값을 사용하여 시작할 동시 작업 수를 결정합니다. 자세한 내용은 명령줄을 입력 AzCopy /?:NC 합니다.

Blob Storage로 테이블 내보내기

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:https://myaccount.blob.core.windows.net/mycontainer/ /SourceKey:key1 /Destkey:key2

AzCopy는 다음 명명 규칙을 사용하여 Blob 컨테이너에 JSON 데이터 파일을 생성합니다.

<account name>_<table name>_<timestamp>_<volume index>_<CRC>.json

생성된 JSON 데이터 파일은 최소 메타데이터의 페이로드 형식을 따릅니다. 이 페이로드 형식에 대한 자세한 내용은 Table Service 작업에 대한 페이로드 형식을 참조 하세요.

테이블을 Blob으로 내보낼 때 AzCopy는 테이블 엔터티를 로컬 임시 데이터 파일로 다운로드한 다음 해당 엔터티를 Blob에 업로드합니다. 이러한 임시 데이터 파일은 기본 경로인 “%LocalAppData%\Microsoft\Azure\AzCopy”로 저널 파일 폴더에 저장됩니다. 또한 /Z:[journal-file-folder] 옵션을 지정하여 저널 파일 폴더 위치와 임시 데이터 파일 위치를 변경할 수 있습니다. 임시 데이터 파일의 크기는 테이블 엔터티의 크기와 /SplitSize 옵션으로 지정한 크기에 따라 결정됩니다. 그러나 로컬 디스크의 임시 데이터 파일은 Blob에 업로드된 후 즉시 삭제되지만 삭제되기 전에 이러한 임시 데이터 파일을 저장할 수 있는 충분한 로컬 디스크 공간이 있는지 확인하세요.

Table Storage로 데이터 가져오기

AzCopy를 사용하여 Azure Table Storage로 데이터를 가져오는 방법에 대해 살펴보겠습니다.

테이블 가져오기

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.core.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace

이 옵션은 /EntityOperation 테이블에 엔터티를 삽입하는 방법을 나타냅니다. 가능한 값은 다음과 같습니다.

  • InsertOrSkip: 기존 엔터티를 건너뛰거나 테이블에 엔터티가 없으면 새 엔터티를 삽입합니다.
  • InsertOrMerge: 기존 엔터티를 병합하거나 테이블에 없는 경우 새 엔터티를 삽입합니다.
  • InsertOrReplace: 기존 엔터티를 바꾸거나 테이블에 엔터티가 없으면 새 엔터티를 삽입합니다.

가져오기 시나리오에서는 /PKRS 옵션을 지정할 수 없습니다. 동시 작업을 시작하는 옵션을 /PKRS 지정해야 하는 내보내기 시나리오와 달리 AzCopy는 테이블을 가져올 때 기본적으로 동시 작업을 시작합니다. 시작된 동시 작업의 기본 수는 코어 프로세서 수와 같습니다. 그러나 다른 /NC수의 동시 옵션을 지정할 수 있습니다. 자세한 내용은 명령줄을 입력 AzCopy /?:NC 합니다.

AzCopy는 CSV가 아닌 JSON에 대한 가져오기만 지원합니다. AzCopy는 사용자가 만든 JSON 및 매니페스트 파일에서 테이블 가져오기를 지원하지 않습니다. 이러한 두 파일은 모두 AzCopy 테이블 내보내기에서 제공해야 합니다. 오류를 방지하려면 내보낸 JSON 또는 매니페스트 파일을 수정하지 마세요.

Blob Storage에서 테이블로 엔터티 가져오기

Blob 컨테이너에 Azure Table 및 해당 매니페스트 파일을 나타내는 JSON 파일이 포함되어 있다고 가정합니다.

myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json

해당 Blob 컨테이너에 매니페스트 파일을 사용하여 엔터티를 테이블로 가져오려면 다음 명령을 실행할 수 있습니다.

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:https://myaccount.table.core.windows.net/mytable /SourceKey:key1 /DestKey:key2 /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:"InsertOrReplace"

기타 AzCopy 기능

다른 AzCopy 기능에 대해 살펴보겠습니다.

대상에 없는 데이터만 복사

/XO 및 /XN 매개 변수를 통해 이전 또는 최신 소스 리소스를 각각 복사 작업에서 제외할 수 있습니다. 대상에 없는 원본 리소스만 복사하려는 경우 AzCopy 명령에서 두 매개 변수를 모두 지정할 수 있습니다.

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /XO /XN

/Source:C:\myfolder /Dest:http://myaccount.file.core.windows.net/myfileshare /DestKey:<destkey> /S /XO /XN

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:http://myaccount.blob.core.windows.net/mycontainer1 /SourceKey:<sourcekey> /DestKey:<destkey> /S /XO /XN

원본 또는 대상이 테이블인 경우에는 지원되지 않습니다.

지시 파일을 사용하여 명령줄 매개 변수 지정

AzCopy /@:"C:\responsefiles\copyoperation.txt"

응답 파일에 AzCopy 명령줄 매개 변수를 포함할 수 있습니다. AzCopy는 파일의 매개 변수가 마치 명령줄에 지정된 것처럼 처리하고 파일 내용을 직접적으로 대체합니다.

다음 줄을 포함하는 응답 파일을 가정 copyoperation.txt합니다. 각 AzCopy 매개 변수는 한 줄에 지정할 수 있습니다.

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

또는 별도의 줄에서 다음을 수행합니다.

/Source:http://myaccount.blob.core.windows.net/mycontainer
/Dest:C:\myfolder
/SourceKey:<sourcekey>
/S
/Y

매개 변수에 대해 다음과 같이 매개 변수를 두 줄로 분할하면 AzCopy가 /sourcekey 실패합니다.

http://myaccount.blob.core.windows.net/mycontainer
 C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y

여러 지시 파일을 사용하여 명령줄 매개 변수 지정

원본 컨테이너를 지정하는 응답 source.txt 파일을 가정합니다.

/Source:http://myaccount.blob.core.windows.net/mycontainer

파일 시스템에서 대상 폴더를 지정하는 응답 dest.txt 파일:

/Dest:C:\myfolder

AzCopy에 대한 옵션을 지정하는 응답 options.txt 파일은 다음과 같습니다.

/S /Y

디렉터리에 C:\responsefiles있는 이러한 응답 파일을 사용하여 AzCopy를 호출하려면 다음 명령을 사용합니다.

AzCopy /@:"C:\responsefiles\source.txt" /@:"C:\responsefiles\dest.txt" /SourceKey:<sourcekey> /@:"C:\responsefiles\options.txt"

AzCopy는 명령줄에 개별 매개 변수를 모두 포함할 때처럼 이 명령을 처리합니다.

AzCopy /Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

SAS(공유 액세스 서명) 지정

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceSAS:SAS1 /DestSAS:SAS2 /Pattern:abc.txt

또한 컨테이너 URI에서 SAS를 지정할 수도 있습니다.

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1/?SourceSASToken /Dest:C:\myfolder /S

저널 파일 폴더

AzCopy에 명령을 실행할 때마다 저널 파일이 기본 폴더에 있는지 또는 이 옵션을 통해 지정한 폴더에 있는지 확인합니다. 저널 파일이 어느 위치에도 없으면 AzCopy는 작업을 새 작업으로 처리하고 새 저널 파일을 생성합니다.

저널 파일이 존재하면 AzCopy는 입력한 명령줄이 저널 파일의 명령줄과 일치하는지 확인합니다. 두 명령줄이 일치하면 AzCopy는 불완전한 작업을 다시 시작합니다. 일치하지 않으면 저런 파일을 덮어써서 새 작업을 시작할지 또는 현재 작업을 취소할지 묻는 메시지가 표시됩니다.

저널 파일의 기본 위치를 사용하려면 다음을 수행합니다.

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z

위에서 설명한 대로 옵션을 /Z생략하거나 폴더 경로 없이 옵션을 /Z 지정하면 AzCopy는 기본 위치인 %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy저널 파일을 만듭니다. 저널 파일이 이미 있는 경우 AzCopy는 저널 파일을 기반으로 작업을 다시 시작합니다.

저널 파일의 사용자 지정 위치를 지정하려면 다음을 수행합니다.

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z:C:\journalfolder\

이 예제에서는 저널 파일이 아직 없는 경우 만듭니다. 저널 파일이 있으면 AzCopy는 저널 파일을 기반으로 작업을 다시 시작합니다.

AzCopy 작업을 다시 시작하려면 다음을 수행합니다.

AzCopy /Z:C:\journalfolder\

이 예제에서는 완료하지 못한 마지막 작업을 다시 시작합니다.

로그 파일 생성

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V

자세한 정보 표시 로그에 대한 파일 경로를 제공하지 않고 옵션을 /V 지정하는 경우 AzCopy는 기본 위치인 %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy로그 파일을 만듭니다.

그렇지 않으면 사용자 지정 위치에 로그 파일을 만들 수 있습니다.

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V:C:\myfolder\azcopy1.log

다음과 /V같은 /V:test/azcopy1.log상대 경로를 지정하면 자세한 정보 표시 로그가 하위 test폴더 내의 현재 작업 디렉터리에 만들어집니다.

시작할 동시 작업 수 지정

옵션은 /NC 동시 복사 작업의 수를 지정합니다. 기본적으로 AzCopy는 데이터 전송 처리량을 늘리기 위해 특정 수의 동시 작업을 시작합니다. 테이블 작업의 경우 동시 작업 수는 가지고 있는 프로세서의 수와 같습니다. Blob 및 파일 작업의 경우 동시 작업 수는 사용하는 프로세서 수의 8배와 같습니다. 낮은 대역폭 네트워크에서 AzCopy를 실행하는 경우 리소스 경쟁으로 인한 오류를 방지하기 위해 /NC에 대해 더 낮은 수를 지정할 수 있습니다.

Azure Storage 에뮬레이터에 대해 AzCopy 실행

Blob용 Azure Storage 에뮬레이터에 대해 AzCopy를 실행할 수 있습니다.

AzCopy /Source:https://127.0.0.1:10000/myaccount/mycontainer/ /Dest:C:\myfolder /SourceKey:key /SourceType:Blob /S

테이블에 대해 실행할 수도 있습니다.

AzCopy /Source:https://127.0.0.1:10002/myaccount/mytable/ /Dest:C:\myfolder /SourceKey:key /SourceType:Table

Blob의 콘텐츠 형식 자동 확인

AzCopy는 파일 확장자 매핑에 콘텐츠 형식을 저장하는 JSON 파일을 기반으로 Blob의 콘텐츠 형식을 결정합니다. 이 JSON 파일의 이름은 AzCopyConfig.json AzCopy 디렉터리에 있습니다. 목록에 없는 파일 형식이 있는 경우 JSON 파일에 매핑을 추가할 수 있습니다.

{
  "MIMETypeMapping": {
    ".myext": "text/mycustomtype",
    .
    .
  }
}

AzCopy 매개 변수

AzCopy의 매개 변수는 아래에 설명되어 있습니다. AzCopy를 사용하는 데 도움이 되도록 명령줄에서 다음 명령 중 하나를 입력할 수도 있습니다.

  • AzCopy에 대한 자세한 명령줄 도움말: AzCopy /?
  • AzCopy 매개 변수에 대한 자세한 도움말: AzCopy /?:SourceKey
  • 명령줄 예제의 경우: AzCopy /?:Sample

/Source:"source"

복사할 원본 데이터를 지정합니다. 원본은 파일 시스템 디렉터리, Blob 컨테이너, Blob 가상 디렉터리, 스토리지 파일 공유, 스토리지 파일 디렉터리 또는 Azure 테이블일 수 있습니다.

적용 대상: Blob, 파일, 테이블

/Dest:"destination"

복사할 대상을 지정합니다. 대상은 파일 시스템 디렉터리, Blob 컨테이너, Blob 가상 디렉터리, 스토리지 파일 공유, 스토리지 파일 디렉터리 또는 Azure 테이블일 수 있습니다.

적용 대상: Blob, 파일, 테이블

/Pattern:"file-pattern"

복사할 파일을 나타내는 파일 패턴을 지정합니다. /Pattern 매개 변수의 동작은 원본 데이터의 위치 및 재귀 모드 옵션의 존재에 따라 결정됩니다. 재귀 모드는 /S 옵션을 통해 지정됩니다.

지정된 원본이 파일 시스템의 디렉터리인 경우 표준 와일드카드가 적용되고 제공된 파일 패턴이 디렉터리 내의 파일과 일치합니다. /S 옵션을 지정하면 AzCopy는 디렉터리 아래의 모든 하위 폴더에서 지정된 패턴과 일치하는 모든 파일을 찾습니다.

지정된 원본이 Blob 컨테이너 또는 가상 디렉터리인 경우 와일드카드가 적용되지 않습니다. /S 옵션을 지정하면 AzCopy는 지정된 파일 패턴을 Blob 접두사로 해석합니다. /S 옵션을 지정하지 않으면 AzCopy는 파일 패턴을 정확한 Blob 이름과 일치합니다.

지정된 원본이 Azure 파일 공유인 경우 정확한 파일 이름(예: abc.txt)을 지정하여 단일 파일을 복사하거나 공유의 모든 파일을 재귀적으로 복사하는 /S 옵션을 지정해야 합니다. 파일 패턴과 옵션 /S를 함께 지정하려고 시도하면 오류가 발생합니다.

AzCopy는 /Source가 Blob 컨테이너 또는 Blob 가상 디렉터리일 때 대/소문자 구분 일치를 사용하고 다른 모든 경우에서 대/소문자를 구분하지 않는 일치를 사용합니다.

파일 패턴이 지정되지 않은 경우 사용되는 기본 파일 패턴은 파일 시스템 위치 또는 Azure Storage 위치의 빈 접두사입니다. 여러 파일 패턴을 지정할 수는 없습니다.

적용 대상: Blob, 파일

/DestKey:"storage-key"

대상 리소스에 대한 스토리지 계정 키를 지정합니다.

적용 대상: Blob, 파일, 테이블

/DestSAS:"sas-token"

대상에 대한 읽기 및 쓰기 권한이 있는 SAS(공유 액세스 서명)를 지정합니다(해당하는 경우). 특수 명령줄 문자가 포함될 수 있으므로 SAS를 큰따옴표로 묶습니다.

대상 리소스가 Blob 컨테이너, 파일 공유 또는 테이블인 경우 이 옵션 뒤에 SAS 토큰을 지정하거나 이 옵션 없이 SAS를 대상 Blob 컨테이너, 파일 공유 또는 테이블 URI의 일부로 지정할 수 있습니다.

원본과 대상이 모두 Blob인 경우 대상 Blob은 원본 Blob과 동일한 스토리지 계정 내에 있어야 합니다.

적용 대상: Blob, 파일, 테이블

/SourceKey:"storage-key"

원본 리소스에 대한 스토리지 계정 키를 지정합니다.

적용 대상: Blob, 파일, 테이블

/SourceSAS:"sas-token"

원본에 대한 READ 및 LIST 권한이 있는 공유 액세스 서명을 지정합니다(해당하는 경우). 특수 명령줄 문자가 포함될 수 있으므로 SAS를 큰따옴표로 묶습니다.

원본 리소스가 Blob 컨테이너이고 키와 SAS가 제공되지 않는 경우 Blob 컨테이너는 익명 액세스를 통해 읽습니다.

원본이 파일 공유 또는 테이블인 경우 키 또는 SAS를 제공해야 합니다.

적용 대상: Blob, 파일, 테이블

/S

복사 작업에 대한 재귀 모드를 지정합니다. 재귀 모드에서 AzCopy는 하위 폴더에 있는 Blob 또는 파일을 포함하여 지정된 파일 패턴과 일치하는 모든 Blob 또는 파일을 복사합니다.

적용 대상: Blob, 파일

/BlobType:"block" | "page" | "append"

대상 Blob이 블록 Blob, 페이지 Blob 또는 추가 Blob인지 여부를 지정합니다. 이 옵션은 Blob을 업로드하는 경우에만 적용됩니다. 그렇지 않으면 오류가 생성됩니다. 대상이 Blob이고 이 옵션이 지정되지 않은 경우 기본적으로 AzCopy는 블록 Blob을 만듭니다.

적용 대상: Blob

/CheckMD5

다운로드한 데이터에 대한 MD5 해시를 계산하고 Blob 또는 파일의 Content-MD5 속성에 저장된 MD5 해시가 계산된 해시와 일치하는지 확인합니다. 값이 일치하지 않는 경우 AzCopy가 데이터를 다운로드하지 못합니다. MD5 검사는 기본적으로 꺼져 있으므로 데이터를 다운로드할 때 MD5 검사를 수행하려면 이 옵션을 지정해야 합니다.

Azure Storage는 Blob 또는 파일에 대해 저장된 MD5 해시가 최신 상태임을 보장하지 않습니다. Blob 또는 파일이 수정될 때마다 MD5를 업데이트하는 것은 클라이언트의 책임입니다. 디스크 이미지(관리 디스크 또는 관리되지 않는 디스크)의 경우 디스크 콘텐츠가 변경될 때 Azure VM은 MD5 값을 업데이트하지 않으므로 디스크 이미지를 다운로드할 때 /CheckMD5에서 오류가 발생합니다.

AzCopy v8은 서비스에 업로드한 후 항상 Azure Blob 또는 파일에 대한 Content-MD5 속성을 설정합니다.

적용 대상: Blob, 파일

/스냅 사진

스냅샷 전송 여부를 나타냅니다. 이 옵션은 원본이 Blob인 경우에만 유효합니다.

전송된 Blob 스냅샷의 이름을 blob-name (snapshot-time).extension 형식으로 바꿉니다.

기본적으로 스냅샷은 복사되지 않습니다.

적용 대상: Blob

/V:[verbose-log-file]

세부 정보 표시 상태 메시지를 로그 파일로 출력합니다.

기본적으로 자세한 정보 표시 로그 파일의 이름은 에 %LocalAppData%\Microsoft\Azure\AzCopyAzCopyVerbose.log. 이 옵션에 대한 기존 파일 위치를 지정하면 자세한 정보 표시 로그가 해당 파일에 추가됩니다.

적용 대상: Blob, 파일, 테이블

/Z:[journal-file-folder]

작업을 다시 시작하기 위한 업무 일지 파일 폴더를 지정합니다.

AzCopy는 작업이 중단된 경우 항상 재개를 지원합니다.

이 옵션을 지정하지 않았거나 폴더 경로 없이 지정한 경우 AzCopy는 기본 위치에 %LocalAppData%\Microsoft\Azure\AzCopy인 저널 파일을 만듭니다.

AzCopy에 명령을 실행할 때마다 저널 파일이 기본 폴더에 있는지 또는 이 옵션을 통해 지정한 폴더에 있는지 확인합니다. 저널 파일이 어느 위치에도 없으면 AzCopy는 작업을 새 작업으로 처리하고 새 저널 파일을 생성합니다.

저널 파일이 존재하면 AzCopy는 입력한 명령줄이 저널 파일의 명령줄과 일치하는지 확인합니다. 두 명령줄이 일치하면 AzCopy는 불완전한 작업을 다시 시작합니다. 일치하지 않으면 저런 파일을 덮어써서 새 작업을 시작할지 또는 현재 작업을 취소할지 묻는 메시지가 표시됩니다.

작업이 성공적으로 완료되면 저널 파일이 삭제됩니다.

이전 버전의 AzCopy에서 만든 저널 파일에서 작업을 다시 시작해도 지원되지 않습니다.

적용 대상: Blob, 파일, 테이블

/@:"parameter-file"

매개 변수를 포함하는 파일을 지정합니다. AzCopy는 파일의 매개 변수가 명령줄에 지정된 것처럼 처리합니다.

지시 파일에서 단일 줄에 여러 매개 변수를 지정하거나 한 줄에 매개 변수를 하나씩 지정할 수 있습니다. 하나의 매개 변수가 여러 줄에 걸쳐 있을 수 없습니다.

응답 파일에는 # 기호로 시작하는 주석 줄이 포함될 수 있습니다.

여러 응답 파일을 지정할 수 있습니다. 그러나 AzCopy는 중첩된 응답 파일을 지원하지 않습니다.

적용 대상: Blob, 파일, 테이블

/Y

모든 AzCopy 확인 프롬프트를 표시하지 않습니다. 이 옵션을 사용하면 /XO 및 /XN이 지정되지 않은 경우 데이터 업로드 시나리오에 쓰기 전용 SAS 토큰을 사용할 수도 있습니다.

적용 대상: Blob, 파일, 테이블

/L

열거 작업만 지정하고 데이터는 복사되지 않습니다.

AzCopy는 이 옵션 /L 없이 명령줄을 실행하기 위한 시뮬레이션으로 이 옵션의 사용을 해석하고 복사되는 개체 수를 계산합니다. 동시에 옵션 /V를 지정하여 자세한 정보 표시 로그에 복사되는 개체를 확인할 수 있습니다.

이 옵션의 동작은 소스 데이터의 위치와 재귀 모드 옵션 /S 및 파일 패턴 옵션 /Pattern의 유무에 따라 결정됩니다.

이 옵션을 사용할 때 AzCopy에는 이 원본 위치의 LIST 및 READ 권한이 필요합니다.

적용 대상: Blob, 파일

/MT

다운로드한 파일의 마지막 수정 시간을 원본 Blob 또는 파일의 시간과 동일하게 설정합니다.

적용 대상: Blob, 파일

/XN

최신 원본 리소스를 제외합니다. 원본의 마지막 수정 시간이 대상과 동일하거나 최신인 경우 리소스가 복사되지 않습니다.

적용 대상: Blob, 파일

/XO

이전 원본 리소스를 제외합니다. 원본의 마지막 수정 시간이 대상과 동일하거나 오래된 경우 리소스가 복사되지 않습니다.

적용 대상: Blob, 파일

/ A

Archive 특성이 설정된 파일만 업로드합니다.

적용 대상: Blob, 파일

/IA:[RASHCNETOI]

지정된 특성 집합 중 하나라도 있는 파일만 업로드합니다.

사용 가능한 특성에는 다음이 포함됩니다.

  • R = 읽기 전용 파일
  • A = 보관할 준비가 된 파일
  • S = 시스템 파일
  • H = 숨겨진 파일
  • C = 압축 파일
  • N = 일반 파일
  • E = 암호화된 파일
  • T = 임시 파일
  • O = 오프라인 파일
  • I = 인덱싱되지 않은 파일

적용 대상: Blob, 파일

/XA:[RASHCNETOI]

지정된 특성 집합이 있는 파일을 제외합니다.

사용 가능한 특성에는 다음이 포함됩니다.

  • R = 읽기 전용 파일
  • A = 보관할 준비가 된 파일
  • S = 시스템 파일
  • H = 숨겨진 파일
  • C = 압축 파일
  • N = 일반 파일
  • E = 암호화된 파일
  • T = 임시 파일
  • O = 오프라인 파일
  • I = 인덱싱되지 않은 파일

적용 대상: Blob, 파일

/Delimiter:"delimiter"

Blob 이름에서 가상 디렉터리를 구분하는 데 사용되는 구분 기호를 나타냅니다.

기본적으로 AzCopy는 /를 구분 기호 문자로 사용합니다. 그러나 AzCopy는 공통 문자(예: @, #또는 %)를 구분 기호로 사용할 수 있습니다. 명령줄에 이러한 특수 문자 중 하나를 포함해야 하는 경우 파일 이름을 큰따옴표로 묶습니다.

이 옵션은 Blob 다운로드에만 적용됩니다.

적용 대상: Blob

/NC:"number-of-concurrent-operations"

동시 작업 수를 지정합니다.

AzCopy는 데이터 전송 처리량을 높이기 위해 기본적으로 특정 수의 동시 작업을 시작합니다. 저대역폭 환경에서는 많은 수의 동시 작업으로 네트워크 연결에 과부하가 걸려 작업이 완전히 실행되지 못할 수 있습니다. 사용 가능한 실제 네트워크 대역폭을 기준으로 동시 작업을 제한합니다.

동시 작업의 상한은 512개입니다.

적용 대상: Blob, 파일, 테이블

/SourceType:"Blob" | "테이블"

리소스가 source 스토리지 에뮬레이터에서 실행되는 로컬 개발 환경에서 사용할 수 있는 Blob임을 지정합니다.

적용 대상: Blob, 테이블

/DestType:"Blob" | "테이블"

리소스가 destination 스토리지 에뮬레이터에서 실행되는 로컬 개발 환경에서 사용할 수 있는 Blob임을 지정합니다.

적용 대상: Blob, 테이블

/PKRS:"key1#key2#key3#..."

테이블 데이터를 병렬로 내보낼 수 있도록 파티션 키 범위를 분할하여 내보내기 작업의 속도를 높입니다.

이 옵션을 지정하지 않으면 AzCopy는 단일 스레드를 사용하여 테이블 엔터티를 내보냅니다. 예를 들어 사용자가 /PKRS:"aa#bb"를 지정하는 경우 AzCopy는 세 가지 동시 작업을 시작합니다.

각 작업은 아래와 같이 세 파티션 키 범위 중 하나를 내보냅니다.

[first-partition-key, aa)

[aa, bb)

[bb, last-partition-key]

적용 가능: 테이블

/SplitSize:"file-size"

내보낸 파일 분할 크기를 MB로 지정하고 허용되는 최소값은 32입니다.

이 옵션을 지정하지 않으면 AzCopy는 단일 파일로 테이블 데이터를 내보냅니다.

테이블 데이터를 Blob으로 내보내고 내보낸 파일 크기가 Blob 크기에 대한 200GB 제한에 도달하면 AzCopy는 이 옵션을 지정하지 않더라도 내보낸 파일을 분할합니다.

적용 가능: 테이블

/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"

테이블 데이터 가져오기 동작을 지정합니다.

  • InsertOrSkip - 기존 엔터티를 건너뛰거나 테이블에 엔터티가 없으면 새 엔터티를 삽입합니다.
  • InsertOrMerge - 기존 엔터티를 병합하거나 테이블에 없는 경우 새 엔터티를 삽입합니다.
  • InsertOrReplace - 기존 엔터티를 대체하거나 테이블에 없는 경우 새 엔터티를 삽입합니다.

적용 가능: 테이블

/Manifest:"manifest-file"

테이블 내보내기 및 가져오기 작업에 대한 매니페스트 파일을 지정합니다.

이 옵션은 내보내기 작업 중에 선택 사항입니다. 이 옵션을 지정하지 않으면 AzCopy는 미리 정의된 이름을 사용하여 매니페스트 파일을 생성합니다.

이 옵션은 데이터 파일을 찾기 위해 가져오기 작업 중에 필요합니다.

적용 가능: 테이블

/SyncCopy

두 Azure Storage 엔드포인트 간에 Blob 또는 파일을 동기적으로 복사할지 여부를 나타냅니다.

AzCopy는 기본적으로 서버 쪽 비동기 복사본을 사용합니다. Blob 또는 파일을 로컬 메모리에 다운로드한 다음 Azure Storage에 업로드하는 동기 복사를 수행하려면 이 옵션을 지정합니다.

Blob Storage 내에서, File Storage 내에서 또는 Blob Storage에서 파일 스토리지로 혹은 그 반대로 파일을 복사할 때 이 옵션을 사용할 수 있습니다.

적용 대상: Blob, 파일

/SetContentType:"content-type"

대상 Blob 또는 파일의 MIME 콘텐츠 형식을 지정합니다.

AzCopy는 기본적으로 Blob 또는 파일의 콘텐츠 형식을 application/octet-stream으로 설정합니다. 이 옵션의 값을 명시적으로 지정하여 모든 Blob 또는 파일에 대한 콘텐츠 형식을 설정할 수 있습니다.

값 없이 이 옵션을 지정하는 경우 AzCopy는 각 Blob 또는 파일의 콘텐츠 형식을 파일 확장명별로 설정합니다.

적용 대상: Blob, 파일

/PayloadFormat:"JSON" | "CSV"

내보낸 테이블 데이터 파일의 형식을 지정합니다.

이 옵션을 지정하지 않으면 기본적으로 AzCopy는 테이블 데이터 파일을 JSON 형식으로 내보냅니다.

적용 가능: 테이블

알려진 문제 및 모범 사례

알려진 문제 및 모범 사례 중 일부를 살펴보겠습니다.

데이터를 복사하는 동안 동시 쓰기 제한

AzCopy를 사용하여 Blob 또는 파일을 복사하는 경우 데이터를 복사하는 동안 다른 애플리케이션이 데이터를 수정할 수 있습니다. 가능한 경우 복사 중인 데이터가 복사 작업 중에 수정되지 않도록 합니다. 예를 들어 Azure 가상 머신과 연결된 VHD를 복사할 때 다른 애플리케이션이 현재 VHD에 쓰고 있지 않은지 확인합니다. 이 작업을 수행하는 좋은 방법은 복사할 리소스를 임대하는 것입니다. 또는 먼저 VHD의 스냅샷을 만든 다음 스냅샷을 복사할 수 있습니다.

다른 애플리케이션이 복사되는 동안 Blob 또는 파일에 쓰는 것을 방지할 수 없는 경우 작업이 완료될 때까지 복사된 리소스가 더 이상 원본 리소스와 완전히 동등하지 않을 수 있음을 명심하세요.

"암호화, 해시 및 서명에 FIPS 규격 알고리즘을 사용"할 때 AzCopy에 FIPS 규격 MD5 알고리즘을 사용하도록 설정합니다.

기본적으로 AzCopy는 개체를 복사할 때 .NET MD5 구현을 사용하여 MD5를 계산하지만 보안 요구 때문에 FIPS 규격 MD5 설정을 사용하도록 설정하는 데 AzCopy가 필요합니다.

속성을 AzureStorageUseV1MD5 사용하여 app.config 파일을 AzCopy.exe.config 만들고 AzCopy.exe 함께 배치할 수 있습니다.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="AzureStorageUseV1MD5" value="false"/>
  </appSettings>
</configuration>

속성 "AzureStorageUseV1MD5"의 경우:

  • True - 기본값인 AzCopy는 .NET MD5 구현을 사용합니다.
  • False – AzCopy는 FIPS 규격 MD5 알고리즘을 사용합니다.

FIPS 규격 알고리즘은 Windows에서 기본적으로 비활성화됩니다. 컴퓨터에서 이 정책 설정을 변경할 수 있습니다. 실행 창(Windows+R)에서 secpol.msc를 입력하여 로컬 보안 정책 창을 엽니다. 보안 설정 창에서 보안 설정>로컬 정책>보안 옵션으로 이동합니다. 시스템 암호화 찾기: 암호화, 해시 및 서명 정책에 FIPS 규격 알고리즘을 사용합니다. 보안 설정 열에 표시되는 값을 보려면 정책을 두 번 클릭합니다.

다음 단계

Azure Storage 및 AzCopy에 대한 자세한 내용은 다음 리소스를 참조하세요.

Azure Storage 설명서:

Azure Storage 블로그 게시물: