다음을 통해 공유

Go를 사용하여 Blob 나열

  • 아티클

이 문서에서는 Go용 Azure Storage 클라이언트 모듈을 사용하여 Blob을 나열하는 방법을 보여 줍니다.

필수 조건

환경 설정

기존 프로젝트가 없는 경우 이 섹션에서는 Go용 Azure Blob Storage 클라이언트 모듈에서 작업하도록 프로젝트를 설정하는 방법을 보여 줍니다. 단계에는 모듈 설치, import 경로 추가 및 권한이 있는 클라이언트 개체 만들기가 포함됩니다. 자세한 내용은 Azure Blob Storage 및 Go 시작을 참조하세요.

모듈 설치

다음 명령을 사용하여 azblob 모듈을 설치합니다.

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

Microsoft Entra ID로 인증(권장)하려면 다음 명령을 사용하여 azidentity 모듈을 설치합니다.

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

가져오기 경로 추가

코드 파일에 다음 가져오기 경로를 추가합니다.

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
)

이 문서의 일부 코드 예제에는 추가 가져오기 경로가 필요할 수 있습니다. 구체적인 세부 정보와 사용 예를 보려면 코드 샘플을 참조하세요.

클라이언트 개체 만들기

앱을 Blob Storage에 연결하려면 azblob.NewClient를 사용하여 클라이언트 개체를 만듭니다. 다음 예에서는 권한 부여를 위해 DefaultAzureCredential을 사용하여 클라이언트 개체를 만드는 방법을 설명합니다.

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

권한 부여

권한 부여 메커니즘에는 Blob을 업로드하는 데 필요한 권한이 있어야 합니다. Microsoft Entra ID(권장)로 권한 부여하려면 Azure RBAC 기본 제공 역할 Storage Blob 데이터 읽기 권한자 이상이 필요합니다. 자세한 내용은 목록 Blob(REST API)에 대한 권한 부여 지침을 참조하세요.

Blob 목록 옵션 정보

코드에서 Blob을 나열하는 경우 Azure Storage에서 결과가 반환되는 방식을 관리하는 많은 옵션을 지정할 수 있습니다. 각 결과 세트에서 반환할 결과 수를 지정하고 후속 세트를 검색할 수 있습니다. 이름이 해당 문자 또는 문자열로 시작하는 Blob을 반환하는 접두사를 지정할 수 있습니다. 플랫 목록 구조나 계층 구조로 Blob을 나열할 수 있습니다. 계층형 목록은 폴더로 구성된 것처럼 Blob을 반환합니다.

단순 목록을 사용하여 컨테이너의 Blob을 나열하려면 다음 메서드를 호출합니다.

계층적 목록을 사용하여 컨테이너의 Blob을 나열하려면 컨테이너 클라이언트 개체에서 다음 메서드를 호출합니다.

반환되는 결과 수 관리

기본적으로 목록 작업은 한 번에 최대 5,000개의 결과를 반환합니다. 더 작은 결과 집합을 반환하려면 ListBlobsFlatOptions 또는 ListBlobsHierarchyOptions의 MaxResults 필드에 0이 아닌 값을 제공합니다.

접두사를 사용하여 결과 필터링

반환된 blob 목록을 필터링하려면 ListBlobsFlatOptions 또는 ListBlobsHierarchyOptions의 Prefix 필드에 문자열 또는 문자를 지정합니다. 접두사 문자열은 하나 이상의 문자를 포함할 수 있습니다. 그러면 Azure Storage는 이름이 해당 접두사로 시작하는 Blob만 반환합니다.

Blob 메타데이터 또는 기타 정보 포함

결과에 blob 메타데이터를 포함하려면 ListBlobsInclude의 일부로 Metadata 필드를 true로 설정합니다. Azure Storage에는 반환된 각 Blob과 함께 메타데이터가 포함되어 있으므로 Blob 메타데이터를 별도로 가져올 필요가 없습니다.

스냅샷, 버전, blob 인덱스 태그 및 기타 정보를 결과에 포함하는 추가 옵션을 보려면 ListBlobsInclude를 참조하세요.

단순 목록 및 계층 구조 목록

Azure Storage Blob은 계층형 패러다임(예: 클래식 파일 시스템)이 아닌 플랫 패러다임으로 구성됩니다. 그러나 폴더 구조를 모방하기 위해 Blob을 가상 디렉터리로 구성할 수 있습니다. 가상 디렉터리는 Blob 이름의 일부를 형성하며 구분 기호 문자로 표시됩니다.

Blob을 가상 디렉터리로 구성하려면 Blob 이름에 구분 기호 문자를 사용합니다. 기본 구분 기호 문자는 정방향 슬래시(/)이지만 어떤 문자도 구분 기호로 지정할 수 있습니다.

구분 기호를 사용하여 Blob의 이름을 지정할 경우 Blob을 계층형으로 나열하도록 선택할 수 있습니다. 계층 구조 목록 작업의 경우 Azure Storage는 부모 개체 아래에 가상 디렉터리와 Blob을 반환합니다. 클래식 파일 시스템을 프로그래밍 방식으로 트래버스하는 방법과 비슷하게 목록 작업을 재귀적으로 호출하여 계층 구조를 트래버스할 수 있습니다.

참고 항목

Blob 스냅샷은 계층형 목록 작업에 나열할 수 없습니다.

플랫 목록 사용

기본적으로 목록 작업은 Blob을 플랫 목록으로 반환합니다. 플랫 목록에서 Blob은 가상 디렉터리로 구성되지 않습니다.

다음 예제에서는 단순 목록을 사용하여 지정된 컨테이너에 있는 Blob을 나열합니다. 이 예 Blob 스냅샷 및 Blob 버전은 다음과 같습니다(있는 경우).

func listBlobsFlat(client *azblob.Client, containerName string) {
    // List the blobs in the container
    pager := client.NewListBlobsFlatPager(containerName, &azblob.ListBlobsFlatOptions{
        Include: azblob.ListBlobsInclude{Snapshots: true, Versions: true},
    })

    fmt.Println("List blobs flat:")
    for pager.More() {
        resp, err := pager.NextPage(context.TODO())
        handleError(err)

        for _, blob := range resp.Segment.BlobItems {
            fmt.Println(*blob.Name)
        }
    }
}

샘플 출력은 다음과 유사합니다.

List blobs flat:
file4.txt
folderA/file1.txt
folderA/file2.txt
folderA/folderB/file3.txt

다음 예에서는 특정 접두사로 시작하는 컨테이너의 Blob을 나열합니다.

func listBlobsFlatOptions(client *azblob.Client, containerName string, prefix string) {
    // List the blobs in the container with a prefix
    pager := client.NewListBlobsFlatPager(containerName, &azblob.ListBlobsFlatOptions{
        Prefix: to.Ptr(prefix),
    })

    fmt.Println("List blobs with prefix:")
    for pager.More() {
        resp, err := pager.NextPage(context.TODO())
        handleError(err)

        for _, blob := range resp.Segment.BlobItems {
            fmt.Println(*blob.Name)
        }
    }
}

"sample"이라는 접두사 문자열을 전달하면 출력은 다음과 유사합니다.

List blobs with prefix:
sample-blob1.txt
sample-blob2.txt
sample-blob3.txt

참고 항목

표시된 샘플 출력에서는 단일 구조 네임스페이스가 있는 스토리지 계정이 있다고 가정합니다. 스토리지 계정에서 계층 구조 네임스페이스 기능을 사용한 경우 디렉터리는 가상이 아닙니다. 구체적이고 독립적인 개체입니다. 결과적으로 디렉터리는 목록에 길이가 0인 blob으로 나타납니다.

계층 구조 네임스페이스 작업 시 대체 목록 옵션을 보려면 NewListPathsPager를 참조하세요.

계층형 목록 사용

목록 작업을 계층형으로 호출하는 경우 Azure Storage는 계층의 첫 번째 수준에서 가상 디렉터리 및 Blob을 반환합니다.

Blob을 계층적으로 나열하려면 다음 메서드를 사용합니다.

다음 예제에서는 계층적 목록을 사용하여 지정된 컨테이너에 있는 Blob을 나열합니다. 이 예에서 prefix 매개 변수는 컨테이너의 모든 Blob을 나열하기 위해 처음에 빈 문자열로 설정됩니다. 그런 다음 이 예에서는 나열 작업을 재귀적으로 호출하여 가상 디렉터리 계층 구조를 트래버스하고 Blob을 나열합니다.

func listBlobsHierarchy(client *azblob.Client, containerName string, prefix string) {
    // Reference the container as a client object
    containerClient := client.ServiceClient().NewContainerClient(containerName)

    pager := containerClient.NewListBlobsHierarchyPager("/", &container.ListBlobsHierarchyOptions{
        Prefix:     to.Ptr(prefix),
        MaxResults: to.Ptr(int32(1)), // MaxResults set to 1 for demonstration purposes
    })

    for pager.More() {
        resp, err := pager.NextPage(context.TODO())
        handleError(err)

        if resp.Segment.BlobPrefixes != nil {
            for _, prefix := range resp.Segment.BlobPrefixes {
                fmt.Println("Virtual directory prefix:", *prefix.Name)

                // Recursively list blobs in the prefix
                listBlobsHierarchy(client, containerName, *prefix.Name)
            }
        }

        for _, blob := range resp.Segment.BlobItems {
            fmt.Println("Blob:", *blob.Name)
        }
    }
}

샘플 출력은 다음과 유사합니다.

Virtual directory prefix: folderA/
Blob: folderA/file1.txt
Blob: folderA/file2.txt
Blob: folderA/file3.txt
Virtual directory prefix: folderA/folderB/
Blob: folderA/folderB/file1.txt
Blob: folderA/folderB/file2.txt
Blob: folderA/folderB/file3.txt

참고 항목

이 가이드의 코드 샘플은 Azure Blob Storage 및 Go를 시작하는 데 도움을 주기 위한 것입니다. 애플리케이션의 요구 사항에 맞게 오류 처리 및 Context 값을 수정해야 합니다.

리소스

Go용 Azure Blob Storage 클라이언트 모듈을 사용하여 Blob을 나열하는 방법에 대해 자세히 알아보려면 다음 리소스를 참조하세요.

샘플 코드

REST API 작업

Go용 Azure SDK에는 Azure REST API를 기반으로 빌드되는 라이브러리가 포함되어 있어 익숙한 Go 패러다임을 통해 REST API 작업과 상호 작용할 수 있습니다. Blob을 나열하기 위한 클라이언트 라이브러리 메서드는 다음 REST API 작업을 사용합니다.

클라이언트 모듈 리소스

참고 항목