패브릭 Real-Time 허브에서 Azure Blob Storage 이벤트 탐색(미리 보기)
이 문서에서는 Fabric 실시간 허브에서 Azure Blob Storage 이벤트를 탐색하는 방법을 보여줍니다. Azure Blob Storage 이벤트를 사용하면 미확인 개체에서 특정 작업이 발생할 때 알림을 받을 수 있습니다. 예를 들어, 새로운 미확인 개체가 생성되거나 기존 미확인 개체가 수정되면 알림을 받을 수 있습니다. 이러한 이벤트는 데이터베이스 업데이트나 알림 전송 등의 다른 작업이나 워크플로에 대한 경고를 설정하는 데 사용할 수 있습니다. 이 문서에서는 Azure Blob Storage 이벤트에 대한 속성 및 스키마를 제공합니다.
참고 항목
Eventstream 또는 Activator의 용량 지역이 독일 중서부, 미국 중남부, 미국 중서부 2, 미국 서부 3, 인도 서부에 있는 경우 Eventstream 또는 Fabric Activator를 통해 Fabric 및 Azure 이벤트를 사용하는 것은 지원되지 않습니다.
Azure Blob Storage 이벤트 세부 정보 페이지 보기
실시간 허브의 왼쪽 탐색 메뉴에서 Azure 이벤트를 선택합니다.
목록에서 Azure Blob Storage 이벤트를 선택합니다.
Azure Blob Storage 이벤트 세부 정보 페이지가 표시됩니다.
actions
Azure Blob Storage 이벤트 세부 정보 페이지 맨 위에는 다음 두 가지 작업이 표시됩니다.
Eventstream 만들기 - 선택한 Azure Blob Storage의 이벤트를 기반으로 Eventstream을 만들 수 있습니다.
경고 설정 - Azure Blob Storage 아티팩트에서 작업이 완료될 때 경고를 설정할 수 있습니다. 예를 들어, 미확인 개체가 생성되거나 삭제될 때 경고를 설정할 수 있습니다.
이 범주를 사용하는 항목 확인
이 섹션에서는 Azure Blob Storage 이벤트를 사용하는 아티팩트를 보여줍니다. 목록에 표시된 열과 설명은 다음과 같습니다.
| 열 | 설명 |
|---|---|
| 이름 | Azure Blob Storage 이벤트를 사용하는 아티팩트의 이름입니다. |
| Type | 아티팩트 형식 – Activator 또는 Eventstream |
| 작업 영역 | 아티팩트가 있는 작업 영역입니다. |
| Source | 원본(Azure Blob Storage 계정)의 이름입니다. |
Azure Blob Storage 이벤트 프로필
이벤트 유형
| 이벤트 유형 이름 | 설명 |
|---|---|
| Microsoft.Storage.BlobCreated | 이 이벤트는 새로운 미확인 개체가 추가되거나 기존 미확인 개체가 업데이트될 때 활성화됩니다. 이 이벤트는 Azure Data Lake Storage Gen2 REST API에서 찾을 수 있는 CreateFile 및FlushWithClose 작업을 사용하는 클라이언트에 의해 트리거됩니다. |
| Microsoft.Storage.BlobDeleted | 이 이벤트는 미확인 개체가 제거될 때 활성화됩니다. 이 이벤트는 클라이언트가 Azure Data Lake Storage Gen2 REST API에서 찾을 수 있는 DeleteFile 작업을 사용할 때 트리거됩니다. |
| Microsoft.Storage.BlobRenamed | 이 이벤트는 미확인 개체의 이름이 변경되면 활성화되며, 특히 사용자가 Azure Data Lake Storage Gen2 REST API에서 찾은 RenameFile 함수를 사용할 때 활성화됩니다. |
| Microsoft.Storage.BlobTierChanged | 이 이벤트는 Blob REST API의 SetBlobTier 작업을 통해 Blob 액세스 계층이 수정될 때 활성화되고, 변경 내용이 완전히 처리되면 트리거됩니다. |
| Microsoft.Storage.AsyncOperationInitiated | 이 이벤트는 데이터가 아카이브에서 핫 계층이나 쿨 계층으로 이동되거나 복사될 때 발생합니다. 이 문제는 클라이언트가 SetBlobTier API를 사용하여 아카이브에서 핫 또는 쿨 계층으로 미확인 개체를 이동하거나, 클라이언트가 CopyBlob API를 사용하여 아카이브 계층 미확인 개체에서 핫 또는 쿨 계층 미확인 개체로 데이터를 복사할 때 발생합니다. |
| Microsoft.Storage.DirectoryCreated | 이 이벤트는 새 디렉터리가 생성되거나 클라이언트가 Azure Data Lake Storage Gen2 REST API에서 제공된 CreateDirectory 작업을 활용하여 새 디렉터리를 형성할 때 활성화됩니다. |
| Microsoft.Storage.DirectoryRenamed | 이 이벤트는 디렉터리 이름이 변경되면 활성화되며, 특히 클라이언트가 Azure Data Lake Storage Gen2 REST API의 RenameDirectory 기능을 활용할 때 활성화됩니다. |
| Microsoft.Storage.DirectoryDeleted | 이 이벤트는 고객이 Azure Data Lake Storage Gen2 REST API에 있는 DeleteDirectory 기능을 활용할 때 디렉터리가 제거되면 활성화됩니다. |
| Microsoft.Storage.BlobInventoryPolicyCompleted | 이 이벤트는 인벤토리 정책으로 지정된 정책에 대해 인벤토리 실행이 완료되면 활성화됩니다. 또한 인벤토리 실행이 시작되기 전에 사용자 오류(예: 잘못된 정책 또는 목적지 컨테이너 없음)로 인해 실패하는 경우에도 활성화됩니다. |
| Microsoft.Storage.LifecyclePolicyCompleted | 이 이벤트는 정의된 작업이 실행될 때 수명 주기 관리 정책이 활성화되는 것을 나타냅니다. |
스키마
이벤트에는 다음과 같은 최상위 데이터가 있습니다.
| 속성 | Type | 설명 | 예시 |
|---|---|---|---|
source |
string | 이벤트 원본에 대한 전체 리소스 경로입니다. 이 필드는 쓸 수 없습니다. Event Grid는 이 값을 제공합니다. | /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account |
subject |
string | 게시자가 정의한 이벤트 주체의 경로입니다. | /blobServices/default/containers/my-file-system/blobs/new-file.txt |
type |
string | 이 이벤트 원본에 대해 등록된 이벤트 유형 중 하나입니다. | Microsoft.Storage.BlobCreated |
time |
string | 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다. | 2017-06-26T18:41:00.9584103Z |
id |
string | 이벤트에 대한 고유 식별자입니다. | 00000000-0000-0000-0000-000000000000 |
data |
개체 | Blob Storage 이벤트 데이터입니다. | {{Data object}} |
specversion |
string | CloudEvents 스키마 사양 버전입니다. | 1.0 |
fabricsource |
string | Azure Blob Storage 이벤트 원본에 대한 Fabric Eventstream의 ID입니다. | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
string | Azure Blob Storage 이벤트 원본에 대한 이벤트 링크의 ID입니다. | eventLinks/00000000-0000-0000-0000-000000000000 |
data 개체의 속성은 다음과 같습니다.
| 속성 | Type | 설명 | 예시 |
|---|---|---|---|
api |
string | 이벤트를 트리거하는 작업입니다. | CreateFile |
clientRequestId |
string | 스토리지 API 작업에 대한 클라이언트 제공 요청 ID입니다. 이 ID는 로그의 필드를 사용하여 client-request-id Azure Storage 진단 로그와 상관 관계를 지정하는 데 사용할 수 있으며 헤더를 사용하는 x-ms-client-request-id 클라이언트 요청에서 제공할 수 있습니다.
로그 형식을 참조하세요. |
00000000-0000-0000-0000-000000000000 |
requestId |
string | 스토리지 API 작업에 대한 서비스에서 생성된 요청 ID입니다. 로그의 필드를 사용하여 request-id-header Azure Storage 진단 로그와 상관 관계를 지정하는 데 사용할 수 있으며 헤더에서 API 호출 x-ms-request-id 을 시작할 때 반환됩니다.
로그 형식을 참조하세요. |
00000000-0000-0000-0000-000000000000 |
eTag |
string | 조건부로 작업을 수행하는 데 사용할 수 있는 값입니다. | \"0x8D4BCC2E4835CD0\" |
contentType |
string | Blob에 대해 지정된 콘텐츠 형식입니다. | text/plain |
contentLength |
정수 | Blob의 크기(바이트)입니다. | 0 |
blobType |
string | Blob의 형식입니다. 유효한 값은 BlockBlob 또는 PageBlob입니다. |
BlockBlob |
contentOffset |
number | 이벤트 트리거 애플리케이션에서 파일에 쓰기를 완료한 시점에 수행된 쓰기 작업의 바이트 단위 오프셋입니다. 계층 구조 네임스페이스가 있는 Blob Storage 계정에서 활성화되는 이벤트에 대해서만 나타납니다. |
0 |
destinationUrl |
string | 작업이 완료된 후 존재하는 파일의 URL입니다. 예를 들어, 파일의 이름을 바꾸면 destinationUrl 속성에 새 파일 이름의 URL이 포함됩니다. 계층 구조 네임스페이스가 있는 Blob Storage 계정에서 활성화되는 이벤트에 대해서만 나타납니다. |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
string | 작업을 완료하기 전에 존재하는 파일의 URL입니다. 예를 들어, 파일의 이름을 바꾸면 sourceUrl은 이름 바꾸기 작업 전 원래 파일 이름의 URL을 포함합니다. 계층 구조 네임스페이스가 있는 Blob Storage 계정에서 활성화되는 이벤트에 대해서만 나타납니다. |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
string | Blob에 대한 경로입니다. 클라이언트가 Blob REST API를 사용할 경우 URL의 구조는 다음과 같습니다 |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
string | 모든 자식 디렉터리에서 작업을 실행하려면 True이고, 그렇지 않으면 False입니다. 계층 구조 네임스페이스가 있는 Blob Storage 계정에서 활성화되는 이벤트에 대해서만 나타납니다. |
true |
sequencer |
string | 특정 Blob 이름에 대한 이벤트의 논리적 순서를 나타내는 불투명 문자열 값입니다. 사용자는 표준 문자열 비교를 사용하여 동일한 Blob 이름에 대한 두 이벤트의 상대적 순서를 이해할 수 있습니다. | 00000000000004420000000000028963 |
identity |
string | 이벤트와 연결된 ID를 나타내는 문자열 값입니다. SFTP(보안 파일 전송 프로토콜)의 경우 값은 로컬 사용자 이름입니다. | localuser |
storageDiagnostics |
개체 | 경우에 따라 Azure Storage 서비스에 의해 포함되는 진단 데이터입니다. 포함될 경우, 이벤트 소비자는 이를 무시해야 합니다. | {{Storage diagnostic object}} |