Atlas Kafka topics 메시지를 보내고 받도록 Microsoft Purview를 사용하여 Event Hubs 구성

아티클
10/06/2023

이 문서에서는 Azure Event Hubs Atlas Kafka topics 이벤트를 보내고 받을 수 있도록 Microsoft Purview를 구성하는 방법을 보여 줍니다.

환경을 이미 구성한 경우 가이드에 따라 Azure.Messaging.EventHubs .NET 라이브러리를 시작하여 메시지를 보내고 받을 수 있습니다.

필수 조건

환경을 구성하려면 다음과 같은 특정 필수 구성 요소가 필요합니다.

Microsoft Azure 구독. Event Hubs를 비롯한 Azure 서비스를 사용하려면 Azure 구독이 필요합니다. Azure 계정이 없는 경우 평가판 에 등록하거나 계정을 만들 때 MSDN 구독자 혜택을 사용할 수 있습니다.
활성 Microsoft Purview 계정입니다.

Event Hubs 구성

Atlas Kafka topics 메시지를 보내거나 받으려면 하나 이상의 Event Hubs 네임스페이스를 구성해야 합니다. 구체적으로 다음과 같은 옵션을 선택할 수 있습니다.

고유한 Azure Event Hubs 네임스페이스를 만들고 Microsoft Purview에서 작동하도록 구성
REST API를 사용하여 관리되는 네임스페이스 만들기

참고

Microsoft Purview 계정이 2022년 12월 15일 이전에 만들어진 경우 계정과 이미 연결된 관리되는 Event Hubs 리소스가 있을 수 있습니다. Azure Portal Microsoft Purview 계정 페이지의 설정 아래 관리되는 리소스에서 검사 수 있습니다.

이 리소스가 표시되지 않거나 사용하지 않도록 설정된 경우 아래 단계에 따라 Event Hubs를 구성합니다.
사용하도록 설정된 경우 원하는 경우 이 관리되는 Event Hubs 네임스페이스를 계속 사용할 수 있습니다. (관련 비용이 있습니다. 가격 책정 페이지를 참조하세요.) 고유한 Event Hubs 계정을 관리하려면 먼저 이 기능을 사용하지 않도록 설정하고 아래 단계를 따라야 합니다. 관리되는 Event Hubs 리소스를 사용하지 않도록 설정하면 관리되는 Event Hub 리소스를 다시 사용하도록 설정할 수 없습니다. 사용자 고유의 Event Hubs만 구성할 수 있습니다..

고유한 네임스페이스 가져오기

Event Hubs를 사용하여 기존 Azure Event Hubs 네임스페이스를 구성하거나 Microsoft Purview와 연결할 새 네임스페이스를 만들 수 있습니다.

중요

현재 프라이빗 엔드포인트를 사용하는 이벤트 허브는 Microsoft Purview for Atlas Kafka topics 메시지로 구성할 수 없습니다. 프라이빗 엔드포인트가 필요한 경우 관리되는 네임스페이스를 사용합니다.

Event Hubs 권한

Event Hubs를 사용하여 인증하려면 다음을 사용할 수 있습니다.

Microsoft Purview 관리 ID
사용자가 할당한 관리 ID - 계정을 만든 후에 네임스페이스를 구성할 때만 사용할 수 있습니다.

이러한 ID 중 하나는 Event Hubs에서 Microsoft Purview와 함께 사용하도록 구성할 수 있도록 최소 기여자 권한이 필요합니다.

Microsoft Purview에 메시지를 게시하도록 Event Hubs 구성

Azure Portal Microsoft Purview 계정 페이지의 설정에서 Kafka 구성으로 이동합니다.
구성 추가 및 후크 구성을 선택합니다.

참고

필요한 만큼 후크 구성을 추가할 수 있습니다.
후크 구성에 이름을 지정하고, 구독, 기존 Event Hubs 네임스페이스, 알림을 보낼 기존 Event Hubs, 사용하려는 소비자 그룹 및 사용하려는 인증 종류를 선택합니다.

팁

동일한 Event Hubs 네임스페이스를 두 번 이상 사용할 수 있지만 각 구성에는 고유한 Event Hubs가 필요합니다.
저장을 선택합니다. 구성을 완료하는 데 몇 분 정도 걸립니다.
구성이 완료되면 Microsoft Purview에 메시지를 게시하는 단계를 시작할 수 있습니다.

Microsoft Purview에서 메시지를 받도록 Event Hubs 구성

Azure Portal Microsoft Purview 계정 페이지의 설정에서 Kafka 구성으로 이동합니다.
이미 알림 유형으로 나열된 구성이 있는 경우 Event Hubs가 이미 구성되어 있으며 Microsoft Purview 메시지를 받는 단계를 시작할 수 있습니다.

참고

한 번에 하나의 Notification Event Hubs만 구성할 수 있습니다.
알림 구성이 아직 나열되지 않은 경우 구성 추가 및 알림 구성을 선택합니다.
알림 구성에 이름을 지정하고, 구독, 기존 Event Hubs 네임스페이스, 알림을 보낼 기존 Event Hubs, 사용하려는 파티션 및 사용하려는 인증 종류를 선택합니다.

팁

동일한 Event Hubs 네임스페이스를 두 번 이상 사용할 수 있지만 각 구성에는 고유한 Event Hubs가 필요합니다.
저장을 선택합니다. 구성을 완료하는 데 몇 분 정도 걸립니다.
구성이 완료되면 Microsoft Purview 메시지를 받는 단계를 시작할 수 있습니다.

구성된 Event Hubs 제거

구성된 Event Hubs 네임스페이스를 제거하려면 다음 단계를 수행할 수 있습니다.

Azure Portal Microsoft Purview 계정을 검색하여 엽니다.
Azure Portal Microsoft Purview 계정 페이지의 설정에서 Kafka 구성을 선택합니다.
사용하지 않도록 설정할 Event Hubs를 선택합니다. (후크 허브는 Microsoft Purview에 메시지를 보냅니다. 알림 허브는 알림을 받습니다.)
제거를 선택하여 선택을 저장하고 비활성화 프로세스를 시작합니다. 완료하는 데 몇 분 정도 걸릴 수 있습니다.

관리되는 네임스페이스 만들기

프라이빗 엔드포인트를 사용하여 연결하기 위해 Event Hubs 네임스페이스가 필요하거나 관리되는 Event Hubs 네임스페이스를 사용하려는 경우 REST API를 사용하여 계정을 구성해야 합니다.

아래 스크립트(apiVersion = 2021-12-01 설정)를 사용하여 계정을 업데이트할 수 있으며 이 방법은 이벤트 허브 구성에만 영향을 줍니다.

$body = @{"properties" = @{ "managedEventHubState" = "Enabled" }; "location" = $($location); "identity" = @{ "type"= $($type) } } | ConvertTo-Json
$Token=Get-AzAccessToken
$Headers = @{ "Authorization" = "Bearer $($Token.Token)" }
$Uri = "https://management.azure.com/subscriptions/$($subscription)/resourceGroups/$($rg)/providers/Microsoft.Purview/accounts/$($accountName)?api-version=$($apiVersion)"

Invoke-WebRequest -URI $Uri -Method Put -Body $body -Headers $Headers -ContentType "application/json"