Python을 사용하여 블록 Blob의 액세스 계층 설정 또는 변경

아티클
03/07/2024

이 문서에서는 Python용 Azure Storage 클라이언트 라이브러리를 사용하여 블록 Blob에 대한 액세스 계층을 설정하거나 변경하는 방법을 보여 줍니다.

비동기 API를 사용하여 Blob의 액세스 계층을 변경하는 방법에 대한 자세한 내용은 비동기적으로 Blob의 액세스 계층 변경을 참조하세요.

필수 조건

이 문서에서는 Python용 Azure Blob Storage 클라이언트 라이브러리로 작업하도록 프로젝트가 이미 설정되어 있다고 가정합니다. 패키지 설치, import 문 추가 및 권한 있는 클라이언트 개체 만들기를 포함하여 프로젝트를 설정하는 방법에 대한 자세한 내용은 Azure Blob Storage 및 Python 시작을 참조하세요.
권한 부여 메커니즘에는 Blob의 액세스 계층을 설정할 수 있는 권한이 있어야 합니다. 자세한 내용은 다음 REST API 작업에 대한 권한 부여 지침을 참조하세요.
- Blob 계층 설정

블록 Blob 액세스 계층 정보

스토리지 요구에 따른 비용을 관리하기 위해 액세스 빈도 및 보존 기간을 기준으로 데이터를 구성하는 것이 도움이 될 수 있습니다. Azure Storage는 사용 방법에 따라 Blob 데이터를 가장 비용 효율적인 방식으로 저장할 수 있도록 다양한 액세스 계층을 제공합니다.

Blob 데이터를 위한 액세스 계층

Azure Storage 액세스 계층에는 다음이 포함됩니다.

핫 계층 - 자주 액세스하거나 수정하는 데이터를 저장하는 데 최적화된 온라인 계층입니다. 핫 계층은 스토리지 비용이 가장 높지만 액세스 비용은 가장 낮습니다.
쿨 계층 - 자주 액세스하거나 수정하지 않는 데이터를 저장하는 데 최적화된 온라인 계층입니다. 쿨 계층의 데이터는 최소 30일 동안 저장해야 합니다. 쿨 계층은 핫 계층에 비해 스토리지 비용이 낮고 액세스 비용은 높습니다.
콜드 계층 - 자주 액세스하거나 수정하지 않는 데이터를 저장하는 데 최적화된 온라인 계층입니다. 콜드 계층의 데이터는 최소 90일 동안 저장해야 합니다. 콜드 계층은 쿨 계층에 비해 스토리지 비용이 낮고 액세스 비용은 높습니다.
보관 계층 - 거의 액세스하지 않고 요구되는 대기 시간(시간 기준)이 유연한 데이터를 저장하는 데 최적화된 오프라인 계층입니다. 보관 계층의 데이터는 최소 180일 동안 저장해야 합니다.

액세스 계층에 대한 자세한 내용은 Blob 데이터에 대한 액세스 계층을 참조하세요.

Blob이 보관 액세스 계층에 있는 동안에는 오프라인으로 간주되며 읽거나 수정할 수 없습니다. 보관된 Blob의 데이터를 읽거나 수정하려면 먼저 Blob을 온라인 계층으로 리하이드레이션해야 합니다. 보관 계층에서 온라인 계층으로 Blob을 리하이드레이션하는 방법에 대한 자세한 내용은 보관 계층에서 Blob 리하이드레이션을 참조하세요.

제한 사항

액세스 계층 설정은 블록 Blob에서만 허용됩니다. 블록 Blob의 액세스 계층 설정의 제한 사항에 대해서는 내용은 Blob 계층 설정(REST API)을 참조하세요.

참고 항목

Python을 사용하여 액세스 계층을 Cold로 설정하려면 최소 클라이언트 라이브러리 버전, 12.15.0을 사용해야 합니다.

업로드 동안 Blob의 액세스 계층 설정

standard_blob_tier 키워드 인수를 upload_blob 또는 upload_blob_from_url로 전달하여 업로드 시 Blob의 액세스 계층을 설정할 수 있습니다.

다음 코드 예제에서는 BLOB을 업로드할 때 액세스 계층을 설정하는 방법을 보여 줍니다.

def upload_blob_access_tier(self, blob_service_client: BlobServiceClient, container_name: str, blob_name: str):
    blob_client = blob_service_client.get_blob_client(container=container_name, blob=blob_name)
    
    #Upload blob to the cool tier
    with open(file=os.path.join(r'file_path', blob_name), mode="rb") as data:
        blob_client = blob_client.upload_blob(data=data, overwrite=True, standard_blob_tier=StandardBlobTier.COOL)

Python을 사용하여 BLOB을 업로드하는 방법에 대한 자세한 내용은 Python을 사용하여 BLOB 업로드를 참조하세요.

기존 블록 Blob에 대한 액세스 계층 변경

다음 함수를 사용하여 기존 블록 Blob의 액세스 계층을 변경할 수 있습니다.

set_standard_blob_tier

다음 코드 예제에서는 기존 Blob에 대한 액세스 계층을 Cool로 변경하는 방법을 보여 줍니다.

def change_blob_access_tier(self, blob_client: BlobClient):
    # Change the blob access tier to cool
    blob_client.set_standard_blob_tier(StandardBlobTier.COOL)

보관된 Blob을 리하드레이션하는 경우 필요에 따라 rehydrate_priority 키워드 인수를 HIGH 또는 STANDARD로 전달할 수 있습니다.

Blob을 다른 액세스 계층으로 복사

복사 작업의 일부로 액세스 계층을 지정하여 기존 블록 Blob의 액세스 계층을 변경할 수 있습니다. 복사 작업 중 액세스 계층을 변경하려면 standard_blob_tier 키워드 인수를 start_copy_from_url에 전달합니다. 복사 작업을 사용하여 보관 계층에서 Blob을 리하이드레이션하는 경우 필요에 따라 rehydrate_priority 키워드 인수를 HIGH 또는 STANDARD로 전달할 수 있습니다.

다음 코드 예제에서는 복사 작업을 사용하여 보관된 Blob을 Hot 계층으로 리하이드레이션하는 방법을 보여 줍니다.

def rehydrate_blob_using_copy(self, source_archive_blob: BlobClient, destination_rehydrated_blob: BlobClient):
    # Note: the destination blob must have a different name than the source blob

    # Start the copy operation - specify the rehydrate priority and blob access tier
    copy_operation = dict()
    copy_operation = destination_rehydrated_blob.start_copy_from_url(
        source_url=source_archive_blob.url,
        standard_blob_tier=StandardBlobTier.HOT,
        rehydrate_priority=RehydratePriority.STANDARD,
        requires_sync=False)

Python을 사용하여 Blob을 복사하는 방법에 대한 자세한 내용은 Python을 사용하여 Blob 복사를 참조하세요.

Blob의 액세스 계층을 비동기적으로 변경

Python용 Azure Blob Storage 클라이언트 라이브러리는 Blob의 액세스 계층을 비동기적으로 변경할 수 있도록 지원합니다. 프로젝트 설정 요구 사항에 대해 자세히 알아보려면 비동기 프로그래밍을 참조하세요.

비동기 API를 사용하여 Blob의 액세스 계층을 변경하려면 다음 단계를 수행합니다.

다음 import 문을 추가합니다.

import asyncio

from azure.storage.blob import (
StandardBlobTier
)
from azure.identity.aio import DefaultAzureCredential
from azure.storage.blob.aio import (
BlobServiceClient,
BlobClient
)

asyncio.run을 사용하여 프로그램을 실행하는 코드를 추가합니다. 이 함수는 전달된 코루틴(예에서는 main())을 실행하고 asyncio 이벤트 루프를 관리합니다. 코루틴은 async/await 구문으로 선언됩니다. 이 예에서 main() 코루틴은 먼저 async with를 사용하여 최상위 수준 BlobServiceClient를 만든 다음 Blob의 액세스 계층을 변경하는 메서드를 호출합니다. 이 클라이언트에서 만들어진 다른 클라이언트는 동일한 연결 풀을 공유하기 때문에 최상위 클라이언트에서만 async with를 사용해야 합니다.

async def main():
    sample = BlobAccessTierSamples()

    # TODO: Replace <storage-account-name> with an actual storage account name
    account_url = "https://<storage-account-name>.blob.core.windows.net"
    credential = DefaultAzureCredential()

    async with BlobServiceClient(account_url, credential=credential) as blob_service_client:
        # Change the blob access tier to cool
        blob_client = blob_service_client.get_blob_client(container="sample-container", blob="sample-blob.txt")
        await sample.change_blob_access_tier(blob_client=blob_client)

if __name__ == '__main__':
    asyncio.run(main())

Blob의 액세스 계층을 변경하는 코드를 추가합니다. 메서드가 async 키워드로 선언되고 set_standard_blob_tier 메서드를 호출할 때 await 키워드가 사용된다는 점을 제외하면 코드는 동기 예와 동일합니다.
```
async def change_blob_access_tier(self, blob_client: BlobClient):
    # Change the blob access tier to cool
    await blob_client.set_standard_blob_tier(StandardBlobTier.COOL)
```

이 기본 설정을 사용하면 async/await 구문을 통해 이 문서의 다른 예를 코루틴으로 구현할 수 있습니다.

리소스

Python용 Azure Blob Storage 클라이언트 라이브러리를 사용하여 액세스 계층을 설정하는 방법에 대한 자세한 내용은 다음 리소스를 참조하세요.

REST API 작업

Python용 Azure SDK에는 Azure REST API를 기반으로 빌드되는 라이브러리가 포함되어 있어 친숙한 Python 패러다임을 통해 REST API 작업과 상호 작용할 수 있습니다. 액세스 계층을 설정하기 위한 클라이언트 라이브러리 메서드는 다음 REST API 작업을 사용합니다.

Share via