Python을 사용하여 블록 Blob의 액세스 계층 설정 또는 변경
이 문서에서는 Python용 Azure Storage 클라이언트 라이브러리를 사용하여 블록 Blob에 대한 액세스 계층을 설정하거나 변경하는 방법을 보여 줍니다.
비동기 API를 사용하여 Blob의 액세스 계층을 변경하는 방법에 대한 자세한 내용은 비동기적으로 Blob의 액세스 계층 변경을 참조하세요.
필수 조건
- Azure 구독 - 체험 구독 만들기
- Azure Storage 계정 - 스토리지 계정 만들기
- Python 3.8+
환경 설정
기존 프로젝트가 없는 경우, 이 섹션에서는 Python Azure Blob Storage 클라이언트 라이브러리를 사용해서 작동하도록 프로젝트를 설정하는 방법을 보여 줍니다. 자세한 내용은 Azure Blob Storage 및 Python 시작을 참조하세요.
이 문서의 코드 예제를 사용하려면 다음 단계에 따라 프로젝트를 설정합니다.
패키지 설치
pip install를 사용하여 다음 패키지를 설치합니다.
pip install azure-storage-blob azure-identity
Import 문 추가
다음 import 문을 추가합니다.
from azure.identity import DefaultAzureCredential
from azure.storage.blob import (
BlobServiceClient,
BlobClient,
StandardBlobTier,
RehydratePriority
)
권한 부여
권한 부여 메커니즘에는 Blob의 액세스 계층을 설정하는 데 필요한 권한이 있어야 합니다. Microsoft Entra ID로 권한을 부여하려면(권장) Azure RBAC 기본 제공 역할 Storage Blob 데이터 기여자 이상이 필요합니다. 자세한 내용은 Blob 계층 설정에 대한 권한 부여 지침을 참조하세요.
클라이언트 개체 만들기
Blob Storage에 앱을 연결하려면 BlobServiceClient의 인스턴스를 만듭니다. 다음 예에서는 권한 부여를 위해 DefaultAzureCredential을 사용하여 클라이언트 개체를 만드는 방법을 설명합니다.
# TODO: Replace <storage-account-name> with your actual storage account name
account_url = "https://<storage-account-name>.blob.core.windows.net"
credential = DefaultAzureCredential()
# Create the BlobServiceClient object
blob_service_client = BlobServiceClient(account_url, credential=credential)
BlobServiceClient 개체에서 또는 직접 특정 컨테이너 또는 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의 액세스 계층을 변경할 수 있습니다.
다음 코드 예제에서는 기존 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 작업을 사용합니다.
- Blob 계층 설정(REST API)