Azure Storage Blob에서 Azure Data Lake Storage Gen1로 데이터 복사
Data Lake Storage Gen1은 다음 원본에서 데이터를 복사하기 위해 AdlCopy라는 명령줄 도구를 제공합니다.
- Azure Storage Blob에서 Data Lake Storage Gen1로. AdlCopy를 사용하여 Data Lake Storage Gen1에서 Azure Storage Blob으로 데이터를 복사할 수는 없습니다.
- 두 Data Lake Storage Gen1 계정 사이.
또한 다음 두 가지 방법으로 AdlCopy 도구를 사용할 수 있습니다.
- 독립 실행형, 여기서 도구는 Data Lake Storage Gen1 리소스를 사용하여 작업을 수행합니다.
- 데이터 레이크 분석 계정 사용, 여기서 데이터 레이크 분석 계정에 할당된 단위는 복사 작업을 수행하는 데 사용됩니다. 예측 가능한 방식으로 복사 작업을 수행하려는 경우 이 옵션을 사용 수 있습니다.
사전 요구 사항
이 문서를 시작하기 전에 다음이 있어야 합니다.
- Azure 구독. Azure 평가판을 참조하세요.
- 일부 데이터가 포함된 Azure Storage Blob 컨테이너.
- Data Lake Storage Gen1 계정. 계정을 만드는 방법에 대한 지침은 Azure Data Lake Storage Gen1 시작을 참조하세요.
- Data Lake Analytics 계정(선택 사항) - Data Lake Analytics 계정을 만드는 방법에 대한 지침은 Azure Data Lake Analytics 시작을 참조하세요.
- AdlCopy 도구. AdlCopy 도구를 설치합니다.
AdlCopy 도구 구문
다음 구문에 따라 AdlCopy 도구를 사용합니다.
AdlCopy /Source <Blob or Data Lake Storage Gen1 source> /Dest <Data Lake Storage Gen1 destination> /SourceKey <Key for Blob account> /Account <Data Lake Analytics account> /Units <Number of Analytics units> /Pattern
이 구문에서 매개 변수는 다음과 같습니다.
| 옵션 | Description |
|---|---|
| 원본 | Azure Storage Blob에서 원본 데이터의 위치를 지정합니다. 원본은 Blob 컨테이너, Blob 또는 다른 Data Lake Storage Gen1 계정일 수 있습니다. |
| Dest | 복사할 Data Lake Storage Gen1 대상을 지정합니다. |
| SourceKey | Azure Storage Blob 원본에 대한 스토리지 액세스 키를 지정합니다. 원본이 Blob 컨테이너 또는 Blob인 경우에만 필요합니다. |
| 계정 | 선택 사항입니다. 복사 작업을 실행하기 위해 Azure 데이터 레이크 분석 계정을 사용하려는 경우 사용합니다. 구문에서 /Account 옵션을 사용하지만 데이터 레이크 분석 계정을 지정하지 않으면 AdlCopy는 기본 계정을 사용하여 작업을 실행합니다. 또한 이 옵션을 사용하는 경우 원본(Azure Storage Blob) 및 대상(Azure Data Lake Storage Gen1)을 Data Lake Analytics 계정에 대한 데이터 원본으로 추가해야 합니다. |
| 단위 | 복사 작업에 사용할 데이터 레이크 분석 단위의 수를 지정합니다. 이 옵션은 /Account 옵션을 사용하여 데이터 레이크 분석 계정을 지정하는 경우 필수입니다. |
| 패턴 | 복사할 Blob 또는 파일을 나타내는 regex 패턴을 지정합니다. AdlCopy는 대/소문자 구분 일치를 사용합니다. 지정된 패턴이 없는 경우의 기본 패턴은 모든 항목을 복사하는 것입니다. 여러 파일 패턴을 지정할 수는 없습니다. |
AdlCopy(독립 실행형)를 사용하여 Azure Storage Blob에서 데이터 복사
명령 프롬프트를 열고 AdlCopy가 설치된 디렉터리로 이동합니다(일반적으로
%HOMEPATH%\Documents\adlcopy).다음 명령을 실행하여 원본 컨테이너에서 Data Lake Storage Gen1 폴더로 특정 Blob을 복사합니다.
AdlCopy /source https://<source_account>.blob.core.windows.net/<source_container>/<blob name> /dest swebhdfs://<dest_adlsg1_account>.azuredatalakestore.net/<dest_folder>/ /sourcekey <storage_account_key_for_storage_container>예를 들면 다음과 같습니다.
AdlCopy /source https://mystorage.blob.core.windows.net/mycluster/HdiSamples/HdiSamples/WebsiteLogSampleData/SampleLog/909f2b.log /dest swebhdfs://mydatalakestorage.azuredatalakestore.net/mynewfolder/ /sourcekey uJUfvD6cEvhfLoBae2yyQf8t9/BpbWZ4XoYj4kAS5Jf40pZaMNf0q6a8yqTxktwVgRED4vPHeh/50iS9atS5LQ==참고
위의 구문은 Data Lake Storage Gen1 계정의 폴더에 복사할 파일을 지정합니다. 지정한 폴더 이름이 존재하지 않는 경우 AdlCopy 도구는 폴더를 만듭니다.
Data Lake Storage Gen1 계정이 있는 Azure 구독에 대한 자격 증명을 입력하라는 메시지가 표시됩니다. 다음과 유사한 출력이 표시됩니다.
Initializing Copy. Copy Started. 100% data copied. Finishing Copy. Copy Completed. 1 file copied.다음 명령을 사용하여 한 컨테이너에서 Data Lake Storage Gen1 계정으로 모든 Blob을 복사할 수도 있습니다.
AdlCopy /source https://<source_account>.blob.core.windows.net/<source_container>/ /dest swebhdfs://<dest_adlsg1_account>.azuredatalakestore.net/<dest_folder>/ /sourcekey <storage_account_key_for_storage_container>예를 들면 다음과 같습니다.
AdlCopy /Source https://mystorage.blob.core.windows.net/mycluster/example/data/gutenberg/ /dest adl://mydatalakestorage.azuredatalakestore.net/mynewfolder/ /sourcekey uJUfvD6cEvhfLoBae2yyQf8t9/BpbWZ4XoYj4kAS5Jf40pZaMNf0q6a8yqTxktwVgRED4vPHeh/50iS9atS5LQ==
성능 고려 사항
Azure Blob Storage 계정에서 복사할 경우 Blob Storage 쪽에서 복사하는 동안 제한될 수 있습니다. 따라서 복사 작업의 성능이 저하됩니다. Azure Blob Storage의 제한에 대한 자세한 내용은 Azure 구독 및 서비스 제한에서 Azure Storage 제한을 참조하세요.
AdlCopy(독립 실행형)를 사용하여 다른 Data Lake Storage Gen1 계정에서 데이터 복사
AdlCopy를 사용하여 두 Data Lake Storage Gen1 계정 간에 데이터를 복사할 수도 있습니다.
명령 프롬프트를 열고 AdlCopy가 설치된 디렉터리로 이동합니다(일반적으로
%HOMEPATH%\Documents\adlcopy).다음 명령을 실행하여 하나의 Data Lake Storage Gen1 계정에서 다른 계정으로 특정 파일을 복사합니다.
AdlCopy /Source adl://<source_adlsg1_account>.azuredatalakestore.net/<path_to_file> /dest adl://<dest_adlsg1_account>.azuredatalakestore.net/<path>/예를 들면 다음과 같습니다.
AdlCopy /Source adl://mydatastorage.azuredatalakestore.net/mynewfolder/909f2b.log /dest adl://mynewdatalakestorage.azuredatalakestore.net/mynewfolder/참고
위의 구문은 대상 Data Lake Storage Gen1 계정의 폴더에 복사할 파일을 지정합니다. 지정한 폴더 이름이 존재하지 않는 경우 AdlCopy 도구는 폴더를 만듭니다.
Data Lake Storage Gen1 계정이 있는 Azure 구독에 대한 자격 증명을 입력하라는 메시지가 표시됩니다. 다음과 유사한 출력이 표시됩니다.
Initializing Copy. Copy Started.| 100% data copied. Finishing Copy. Copy Completed. 1 file copied.다음 명령은 원본 Data Lake Storage Gen1 계정의 특정 폴더에 있는 모든 파일을 대상 Data Lake Storage Gen1 계정의 폴더로 복사합니다.
AdlCopy /Source adl://mydatastorage.azuredatalakestore.net/mynewfolder/ /dest adl://mynewdatalakestorage.azuredatalakestore.net/mynewfolder/
성능 고려 사항
AdlCopy를 독립 실행형 도구로 사용할 때는 공유된 Azure 관리 리소스에서 복사본이 실행됩니다. 이 환경에서의 성능은 시스템 부하 및 사용 가능한 리소스에 따라 다릅니다. 이 모드는 임시로 작은 양을 전송하는 데 가장 적합합니다. AdlCopy를 독립 실행형 도구로 사용하는 경우 매개 변수를 조정할 필요가 없습니다.
Data Lake Analytics 계정에 AdlCopy를 사용하여 데이터 복사
Data Lake Analytics 계정을 사용하여 Azure Storage Blob에서 Data Lake Storage Gen1로 데이터를 복사하는 AdlCopy 작업을 실행할 수도 있습니다. 이동할 데이터가 기가바이트 및 테라바이트 범위에 있고 보다 향상되고 예측 가능한 성능 처리량을 원하는 경우 일반적으로 이 옵션을 사용합니다.
AdlCopy와 함께 Data Lake Analytics 계정을 사용하여 Azure Storage Blob에서 복사하려면 원본(Azure Storage Blob)을 Data Lake Analytics 계정의 데이터 원본으로 추가해야 합니다. Data Lake Aanlytics 계정에 추가 데이터 원본을 추가하는 방법에 대한 지침은 Data Lake Aanlytics 계정 데이터 원본 관리를 참조하세요.
참고
Data Lake Analytics 계정을 사용하여 Azure Data Lake Storage Gen1 계정을 원본으로 데이터를 복사하는 경우 Data Lake Storage Gen1 계정을 Data Lake Analytics 계정에 연결할 필요가 없습니다. 원본 저장소를 Data Lake Analytics 계정에 연결하려는 경우 원본이 Azure Storage 계정이기만 하면 됩니다.
다음 명령을 실행하여 Data Lake Analytics 계정을 사용하여 Azure Storage Blob에서 Data Lake Storage Gen1 계정으로 복사합니다.
AdlCopy /source https://<source_account>.blob.core.windows.net/<source_container>/<blob name> /dest swebhdfs://<dest_adlsg1_account>.azuredatalakestore.net/<dest_folder>/ /sourcekey <storage_account_key_for_storage_container> /Account <data_lake_analytics_account> /Units <number_of_data_lake_analytics_units_to_be_used>
예를 들면 다음과 같습니다.
AdlCopy /Source https://mystorage.blob.core.windows.net/mycluster/example/data/gutenberg/ /dest swebhdfs://mydatalakestorage.azuredatalakestore.net/mynewfolder/ /sourcekey uJUfvD6cEvhfLoBae2yyQf8t9/BpbWZ4XoYj4kAS5Jf40pZaMNf0q6a8yqTxktwVgRED4vPHeh/50iS9atS5LQ== /Account mydatalakeanalyticaccount /Units 2
마찬가지로, Data Lake Analytics 계정을 사용하여 원본 Data Lake Storage Gen1 계정의 특정 폴더에 있는 모든 파일을 대상 Data Lake Storage Gen1 계정의 폴더로 복사하려면 다음 명령을 실행합니다.
AdlCopy /Source adl://mysourcedatalakestorage.azuredatalakestore.net/mynewfolder/ /dest adl://mydestdatastorage.azuredatalakestore.net/mynewfolder/ /Account mydatalakeanalyticaccount /Units 2
성능 고려 사항
테라바이트 범위의 데이터를 복사할 때 사용자 고유의 Azure Data Lake Analytics 계정으로 AdlCopy를 사용하면 보다 예측 가능하고 더욱 뛰어난 성능을 제공합니다. 조정해야 할 매개 변수는 복사 작업에 사용할 Azure Data Lake Analytics 단위의 수입니다. 단위 수를 늘리면 복사 작업의 성능이 향상됩니다. 복사할 각 파일은 최대 하나의 단위를 사용할 수 있습니다. 복사할 파일 수보다 더 많은 단위를 지정한다고 성능이 증가되지는 않습니다.
AdlCopy를 사용하여 패턴 일치를 통해 데이터 복사
이 섹션에서는 AdlCopy를 사용하여 패턴 일치를 통해 원본(아래 예제에서는 Azure Storage Blob)의 데이터를 대상 Data Lake Storage Gen1 계정으로 복사하는 방법을 알아봅니다. 예를 들어 아래 단계를 사용하여 원본 Blob에서 확장명이 .csv인 모든 파일을 대상으로 복사할 수 있습니다.
명령 프롬프트를 열고 AdlCopy가 설치된 디렉터리로 이동합니다(일반적으로
%HOMEPATH%\Documents\adlcopy).다음 명령을 실행하여 원본 컨테이너의 특정 Blob 중에서 확장명이 *.csv인 모든 파일을 Data Lake Storage Gen1 폴더로 복사합니다.
AdlCopy /source https://<source_account>.blob.core.windows.net/<source_container>/<blob name> /dest swebhdfs://<dest_adlsg1_account>.azuredatalakestore.net/<dest_folder>/ /sourcekey <storage_account_key_for_storage_container> /Pattern *.csv예를 들면 다음과 같습니다.
AdlCopy /source https://mystorage.blob.core.windows.net/mycluster/HdiSamples/HdiSamples/FoodInspectionData/ /dest adl://mydatalakestorage.azuredatalakestore.net/mynewfolder/ /sourcekey uJUfvD6cEvhfLoBae2yyQf8t9/BpbWZ4XoYj4kAS5Jf40pZaMNf0q6a8yqTxktwVgRED4vPHeh/50iS9atS5LQ== /Pattern *.csv
결제
- AdlCopy 도구를 독립 실행형으로 사용하는 경우 원본 Azure Storage 계정이 Data Lake Storage Gen1 계정과 동일한 지역에 없는 경우 데이터 이동에 따른 송신 비용이 청구됩니다.
- 데이터 레이크 분석 계정과 함께 AdlCopy 도구를 사용하면 표준 데이터 레이크 분석 청구 금액 이 적용 됩니다.
AdlCopy 사용에 대한 고려 사항
- AdlCopy(버전 1.0.5)는 모두 수천 개가 넘는 파일과 폴더가 있는 원본에서 데이터를 복사하는 작업을 지원합니다. 그러나 대량의 데이터 세트를 복사할 때 문제가 발생할 경우, 파일/폴더를 다른 하위 폴더에 배포하고 해당 하위 폴더에 대한 경로를 원본으로 대신 사용할 수 있습니다.
AdlCopy 사용에 대한 성능 고려 사항
AdlCopy는 수천 개의 파일 및 폴더가 포함된 데이터의 복사를 지원합니다. 그러나 대량의 데이터 세트를 복사할 때 문제가 발생할 경우 파일/폴더를 더 작은 하위 폴더에 배포할 수 있습니다. AdlCopy는 임시 복사본용으로 빌드되었습니다. 반복적으로 데이터를 복사하려는 경우 복사 작업 관련 전체 관리 기능을 제공하는 Azure Data Factory 사용을 고려해야 합니다.
릴리스 정보
- 1.0.13 - 여러 adlcopy 명령을 통해 데이터를 동일한 Azure Data Lake Storage Gen1 계정에 복사하는 경우 실행할 때마다 자격 증명을 다시 입력할 필요가 없습니다. 이제 Adlcopy가 여러 번 실행할 때 해당 정보를 캐시합니다.