Blob Storage 이벤트에 응답

아티클
04/24/2024

Azure Storage 이벤트를 사용하면 애플리케이션에서 Blob 만들기 및 삭제와 같은 이벤트에 대응할 수 있습니다. 복잡한 코드나 비용이 많이 들고 비효율적인 폴링 서비스가 없어도 이렇게 할 수 있습니다. 가장 좋은 측면은 사용한 기능에 대해서만 비용만 지불한다는 것입니다.

대신, Blob Storage 이벤트는 Azure Event Grid를 통해 Azure Functions, Azure Logic Apps 또는 고유한 http 수신기로도 푸시됩니다. Event Grid은 풍부한 재시도 정책 및 배달 못 한 편지를 통해 애플리케이션에 안정적으로 이벤트를 배달합니다.

Blob Storage에서 지원하는 이벤트의 전체 목록을 보려면 Blob Storage 이벤트 스키마 문서를 참조하세요.

일반적인 Blob Storage 이벤트 시나리오에는 이미지 또는 비디오 처리, 검색 인덱싱, 또는 파일 중심의 워크플로가 포함됩니다. 비동기 파일 업로드는 이벤트에 매우 적합합니다. 변경 빈도가 낮더라도 즉각적인 대응이 필요한 시나리오에서는 이벤트 기반 아키텍처가 특히 효율적일 수 있습니다.

Blob Storage 이벤트를 시도하려는 경우 다음 빠른 시작 문서를 참조하세요.

사용하려는 도구:	참조 문서:
Azure Portal	빠른 시작: Azure Portal을 사용하여 Blob Storage 이벤트를 웹 엔드포인트로 라우팅
PowerShell	빠른 시작: PowerShell을 사용하여 스토리지 이벤트를 웹 엔드포인트로 라우팅
Azure CLI	빠른 시작: Azure CLI를 사용하여 웹 엔드포인트에 스토리지 이벤트 라우팅

Azure 함수를 사용하여 Blob Storage 이벤트에 대응하는 방법에 대한 자세한 예제를 보려면 다음 문서를 참조하세요.

참고 항목

스토리지(범용 v1)는 Event Grid와의 통합을 지원하지 않습니다.

이벤트 모델

Event Grid는 이벤트 구독을 사용하여 이벤트 메시지를 구독자에게 라우팅합니다. 이 이미지는 이벤트 게시자, 이벤트 구독 및 이벤트 처리기 간 관계를 보여 줍니다.

Event Grid 모델

먼저 이벤트에 엔드포인트를 구독합니다. 그러면 이벤트가 트리거될 때 Event Grid 서비스는 해당 이벤트에 대한 데이터를 엔드포인트로 보냅니다.

다음을 확인하려면 Blob Storage 이벤트 스키마 문서를 참조하세요.

Blob Storage 이벤트의 전체 목록 및 각 이벤트가 트리거되는 방식
이러한 각 이벤트에 대해 Event Grid에서 전송하는 데이터 예제
데이터에 표시되는 각 키 값 쌍의 용도

이벤트 필터링

이벤트 유형, 컨테이너 이름 또는 생성/삭제된 개체의 이름에 따라 Blob 이벤트를 필터링할 수 있습니다. Event Grid의 필터는 제목이 일치하는 이벤트가 구독자에게 이동되도록 제목의 시작 및 끝과 일치합니다.

필터를 적용하는 방법에 대한 자세한 내용은 Event Grid에 대한 이벤트 필터링을 참조하세요.

Blob Storage 이벤트의 제목은 다음 형식을 사용합니다.

/blobServices/default/containers/<containername>/blobs/<blobname>

스토리지 계정의 모든 이벤트와 일치하는 항목을 찾으려면 제목 필터를 비워 둡니다.

접두사를 공유하는 컨테이너 집합에서 생성된 Blob의 이벤트와 일치하는 항목을 찾으려면 다음과 같은 subjectBeginsWith 필터를 사용합니다.

/blobServices/default/containers/containerprefix

특정 컨테이너에서 생성된 Blob의 이벤트와 일치하는 항목을 찾으려면 다음과 같은 subjectBeginsWith 필터를 사용합니다.

/blobServices/default/containers/containername/

Blob 이름 접두사를 공유하는 특정 컨테이너에서 생성된 Blob의 이벤트와 일치하는 항목을 찾으려면 다음과 같은 subjectBeginsWith 필터를 사용합니다.

/blobServices/default/containers/containername/blobs/blobprefix

Blob 접미사를 공유하는 특정 컨테이너에 만들어진 Blob의 이벤트와 일치시키려면 subjectEndsWith 필터(예: ".log" 또는 ".jpg")를 사용합니다. 자세한 내용은 Event Grid 개념을 참조하세요.

이벤트 사용에 관한 지침

Blob Storage 이벤트를 처리하는 애플리케이션은 아래 권장되는 몇 가지 지침을 따라야 합니다.

동일한 이벤트 처리기로 이벤트를 라우팅하도록 여러 구독이 구성될 수 있으므로, 이벤트가 특정 원본에서 온 것이라고 가정하지 않고 메시지의 토픽을 확인하여 예상하는 스토리지 계정에서 왔음을 확실히 아는 것이 중요합니다.
마찬가지로, eventType이 본인이 처리하려는 형식인지 확인하고, 수신된 모든 이벤트가 예상하는 형식일 것이라고 간주하지 않도록 합니다.
대부분의 메시지는 거의 실시간으로 도착하지만 메시지가 도착하는 데 걸리는 시간에 대한 서비스 수준 계약은 없습니다. 경우에 따라 메시지가 도착하는 데 몇 분 정도 걸릴 수 있습니다. 메시지가 조금 늦게 도착할 수도 있으므로 etag 필드를 사용하여 개체에 대한 정보가 아직 최신 상태인지 여부를 확인합니다. etag 필드를 사용하는 방법을 알아보려면 Blob Storage에서 동시성 관리를 참조하세요.
메시지가 잘못된 순서로 도착할 수 있으므로 sequencer 필드를 사용하여 특정 개체에 대한 이벤트 순서를 파악합니다. sequencer 필드는 특정 Blob 이름에 대한 이벤트의 논리 시퀀스를 나타내는 문자열 값입니다. 표준 문자열 비교를 사용하여 동일한 Blob 이름에 대한 두 이벤트의 상대적 순서를 이해할 수 있습니다.
스토리지 이벤트는 구독자에게 한 번 이상 전송되도록 보장하여 모든 메시지가 출력되도록 합니다. 그러나 백 엔드 노드와 서비스 간의 재시도 또는 구독의 가용성으로 인해 중복 메시지가 발생할 수 있습니다. 메시지 배달 및 다시 시도에 대한 자세한 내용은 Event Grid 메시지 배달 및 다시 시도를 참조하세요.
blobType 필드를 사용하여 Blob에 허용되는 작업 형식을 파악하고 Blob에 액세스하는 데 사용해야 하는 클라이언트 라이브러리 형식을 확인합니다. 유효한 값은 BlockBlob 또는 PageBlob입니다.
Blob에 액세스하려면 CloudBlockBlob 및 CloudAppendBlob 생성자에 URL 필드를 사용합니다.
이해할 수 없는 필드는 무시합니다. 이 지침은 나중에 추가될 수 있는 새로운 기능에 적용하는 데도 도움이 됩니다.
블록 Blob이 완전히 커밋되었을 때만 Microsoft.Storage.BlobCreated 이벤트가 트리거되는지 확인하려면 CopyBlob, PutBlob, PutBlockList 또는 FlushWithClose REST API 호출에 대한 이벤트를 필터링합니다. 해당 API 호출은 데이터가 블록 Blob에 완전히 커밋된 후에만 Microsoft.Storage.BlobCreated 이벤트를 트리거합니다. 필터를 만드는 방법은 Event Grid에 대한 필터 이벤트를 참조하세요.

기능 지원

이 기능에 대한 지원은 Data Lake Storage Gen2, NFS(네트워크 파일 시스템) 3.0 프로토콜 또는 SSH SFTP(파일 전송 프로토콜)를 사용하도록 설정하면 영향을 받을 수 있습니다. 이러한 기능을 사용하도록 설정한 경우 Azure Storage 계정의 Blob Storage 기능 지원을 참조하여 이 기능에 대한 지원을 평가합니다.

다음 단계

Event Grid에 대해 자세히 알아보고 Blob Storage 이벤트를 사용해보세요.

다음을 통해 공유