다음을 통해 공유

Azure CLI를 통해 Azure Data Lake Storage의 디렉터리 및 파일 관리

  • 아티클

이 문서에서는 Azure CLI를 사용하여 계층 구조 네임스페이스가 있는 스토리지 계정에서 디렉터리 및 파일을 만들고 관리하는 방법을 보여 줍니다.

디렉터리 및 파일의 ACL(액세스 제어 목록)을 가져와서 설정하고 업데이트하는 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Azure Data Lake Storage에서 ACL을 관리하세요.

샘플 | 피드백 제공

필수 구성 요소

  • Azure 구독 자세한 내용은 Azure 무료 평가판 가져오기 를 참조하세요.

  • 계층 구조 네임스페이스가 사용하도록 설정된 스토리지 계정입니다. 이러한 지침에 따라 라이브러리를 만듭니다.

  • Azure CLI 버전 2.6.0 이상.

올바른 버전의 Azure CLI를 설치했는지 확인

  1. Azure Cloud Shell을 열거나 Azure CLI를 로컬로 설치한 경우 Windows PowerShell과 같은 명령 콘솔 애플리케이션을 엽니다.

  2. 다음 명령을 사용하여 설치된 Azure CLI 버전이 2.6.0 이상인지 확인합니다.

     az --version

    Azure CLI 버전이 2.6.0보다 낮은 경우 이후 버전을 설치합니다. 자세한 내용은 Azure CLI 설치를 참조하세요.

계정에 연결

  1. Azure CLI를 로컬로 사용하는 경우 로그인 명령을 실행합니다.

    az login

    CLI는 기본 브라우저를 열 수 있으면 기본 브라우저를 열고 Azure 로그인 페이지를 로드합니다.

    그렇지 않으면 https://aka.ms/devicelogin 에서 브라우저 페이지를 열고 터미널에 표시된 권한 부여 코드를 입력합니다. 그런 다음 브라우저에서 계정 자격 증명으로 로그인합니다.

    다른 인증 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Blob 또는 큐 데이터에 대한 액세스 권한 부여를 참조하세요.

  2. ID가 둘 이상의 구독과 연결된 경우 정적 웹 사이트를 호스트하는 스토리지 계정의 구독으로 활성 구독을 설정합니다.

    az account set --subscription <subscription-id>

    <subscription-id> 자리 표시자 값을 구독의 ID로 바꿉니다.

참고 항목

이 문서에 제시된 예는 Microsoft Entra 권한 부여를 보여 줍니다. 권한 부여 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Blob 또는 큐 데이터에 대한 액세스 권한 부여I를 참조하세요.

컨테이너 만들기

컨테이너는 파일의 파일 시스템 역할을 합니다. az storage fs create 명령을 사용하여 만들 수 있습니다.

다음 예제에서는 my-file-system이라는 컨테이너를 만듭니다.

az storage fs create -n my-file-system --account-name mystorageaccount --auth-mode login

컨테이너 속성 표시

az storage fs show 명령을 사용하여 콘솔에 컨테이너 속성을 출력할 수 있습니다.

az storage fs show -n my-file-system --account-name mystorageaccount --auth-mode login

컨테이너 내용 나열

az storage fs file list 명령을 사용하여 디렉터리의 콘텐츠를 나열합니다.

다음 예제에서는 my-file-system이라는 컨테이너의 콘텐츠를 나열합니다.

az storage fs file list -f my-file-system --account-name mystorageaccount --auth-mode login

컨테이너 삭제

az storage fs delete 명령을 사용하면 컨테이너를 삭제할 수 있습니다.

다음 예제에서는 my-file-system라는 컨테이너를 삭제합니다.

az storage fs delete -n my-file-system --account-name mystorageaccount --auth-mode login

디렉터리 만들기

az storage fs directory create 명령을 사용하여 디렉터리 참조를 만듭니다.

다음 예제에서는 mystorageaccount라는 계정에 있는 my-file-system이라는 컨테이너에 my-directory라는 디렉터리를 추가합니다.

az storage fs directory create -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

디렉터리 속성 표시

az storage fs directory show 명령을 사용하여 콘솔에 디렉터리의 속성을 출력할 수 있습니다.

az storage fs directory show -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

디렉터리 이름 바꾸기 또는 이동

az storage fs directory move 명령을 사용하여 디렉터리의 이름을 바꾸거나 디렉터리를 이동합니다.

다음 예제에서는 동일한 컨테이너에 있는 디렉터리의 이름을 my-directory에서 my-new-directory로 바꿉니다.

az storage fs directory move -n my-directory -f my-file-system --new-directory "my-file-system/my-new-directory" --account-name mystorageaccount --auth-mode login

다음 예제에서는 my-second-file-system이라는 컨테이너로 디렉터리를 이동합니다.

az storage fs directory move -n my-directory -f my-file-system --new-directory "my-second-file-system/my-new-directory" --account-name mystorageaccount --auth-mode login

디렉터리 삭제

az storage fs directory delete 명령을 사용하여 디렉터리를 삭제합니다.

다음 예제에서는 my-directory라는 디렉터리를 삭제합니다.

az storage fs directory delete -n my-directory -f my-file-system  --account-name mystorageaccount --auth-mode login

디렉터리가 존재하는지 확인

az storage fs directory exists 명령을 사용하여 컨테이너에 특정 디렉터리가 있는지 확인합니다.

다음 예제에서는 my-file-system 컨테이너에 my-directory라는 디렉터리가 있는지 확인합니다.

az storage fs directory exists -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

디렉터리에서 다운로드

az storage fs file download 명령을 사용하여 디렉터리에서 파일을 다운로드합니다.

다음 예제에서는 my-directory라는 디렉터리에서 upload.txt라는 파일을 다운로드합니다.

az storage fs file download -p my-directory/upload.txt -f my-file-system -d "C:\myFolder\download.txt" --account-name mystorageaccount --auth-mode login

디렉터리 콘텐츠 나열

az storage fs file list 명령을 사용하여 디렉터리의 콘텐츠를 나열합니다.

다음 예제에서는 mystorageaccount라는 스토리지 계정의 my-file-system 컨테이너에 있는 my-directory라는 디렉터리의 콘텐츠를 나열합니다.

az storage fs file list -f my-file-system --path my-directory --account-name mystorageaccount --auth-mode login

디렉터리에 파일 업로드

az storage fs file upload 명령을 사용하여 디렉터리에 파일을 업로드합니다.

다음 예제에서는 upload.txt라는 파일을 my-directory라는 디렉터리에 업로드합니다.

az storage fs file upload -s "C:\myFolder\upload.txt" -p my-directory/upload.txt  -f my-file-system --account-name mystorageaccount --auth-mode login

파일 속성 표시

az storage fs file show 명령을 사용하여 콘솔에 파일의 속성을 출력할 수 있습니다.

az storage fs file show -p my-file.txt -f my-file-system --account-name mystorageaccount --auth-mode login

파일 이름 바꾸기 또는 이동

az storage fs file move 명령을 사용하여 파일의 이름을 바꾸거나 파일을 이동합니다.

다음 예제에서는 파일의 이름을 my-file.txt에서 my-file-renamed.txt로 바꿉니다.

az storage fs file move -p my-file.txt -f my-file-system --new-path my-file-system/my-file-renamed.txt --account-name mystorageaccount --auth-mode login

파일 삭제

az storage fs file delete 명령을 사용하여 파일을 삭제합니다.

다음 예제에서는 my-file.txt라는 파일을 삭제합니다.

az storage fs file delete -p my-directory/my-file.txt -f my-file-system  --account-name mystorageaccount --auth-mode login

참고 항목