Настройка Центров событий с помощью Microsoft Purview для отправки и получения сообщений в разделах Atlas Kafka
В этой статье показано, как настроить Microsoft Purview для отправки и получения событий в разделах Atlas Kafka с помощью Центры событий Azure.
Если вы уже настроили среду, вы можете следовать нашему руководству, чтобы приступить к работе с библиотекой Azure.Messaging.EventHubs .NET для отправки и получения сообщений.
Предварительные требования
Чтобы настроить среду, необходимо выполнить определенные предварительные требования:
- Подписка Microsoft Azure. Чтобы использовать службы Azure, включая Центры событий, требуется подписка Azure. Если у вас нет учетной записи Azure, вы можете зарегистрироваться для получения бесплатной пробной версии или использовать преимущества подписчика MSDN при создании учетной записи.
- Активная учетная запись Microsoft Purview.
Настройка Центров событий
Чтобы отправлять или получать сообщения тем Atlas Kafka, необходимо настроить по крайней мере одно пространство имен Центров событий. Вы можете:
- Создайте собственное пространство имен Центры событий Azure и настройте его для работы с Microsoft Purview
- Создание управляемого пространства имен с помощью REST API
Примечание.
Если учетная запись Microsoft Purview была создана до 15 декабря 2022 г., возможно, с вашей учетной записью уже связан управляемый ресурс Центров событий.
Вы можете проверка в разделе Управляемые ресурсы в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.
Если этот ресурс не отображается или он отключен, выполните следующие действия, чтобы настроить центры событий.
Если он включен, вы можете продолжать использовать это управляемое пространство имен Центров событий, если хотите. (Есть связанные затраты. См. страницу цен.) Если вы хотите управлять собственной учетной записью Центров событий, сначала необходимо отключить эту функцию и выполнить следующие действия. Если вы отключите управляемый ресурс Центров событий, вы не сможете повторно включить управляемый ресурс Концентратора событий. Вы сможете настроить только собственные Центры событий..
Создание собственного пространства имен
Вы можете настроить существующее пространство имен Центры событий Azure с помощью Центров событий или создать новое пространство имен для подключения к Microsoft Purview.
Важно!
В настоящее время центры событий, использующие частные конечные точки, не могут быть настроены с помощью Microsoft Purview для сообщений тем Atlas Kafka. Если вам нужна частная конечная точка, используйте управляемое пространство имен.
Разрешения Центров событий
Для проверки подлинности в Центрах событий можно использовать:
- Управляемое удостоверение Microsoft Purview
- Управляемое удостоверение, назначаемое пользователем , доступно только при настройке пространств имен после создания учетной записи.
Для одного из этих удостоверений потребуется по крайней мере участник разрешений на центры событий, чтобы настроить их для использования с Microsoft Purview.
Настройка Центров событий для публикации сообщений в Microsoft Purview
Перейдите к конфигурации Kafka в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.
Выберите Добавить конфигурацию и Конфигурацию перехватчика.
Примечание.
Вы можете добавить любое количество конфигураций перехватчиков.
Присвойте имя конфигурации перехватчика, выберите подписку, существующее пространство имен Центров событий, существующие Центры событий для отправки уведомлений, группу потребителей, которую вы хотите использовать, и тип проверки подлинности, которую вы хотите использовать.
Совет
Одно и то же пространство имен Центров событий можно использовать несколько раз, но каждой конфигурации потребуются собственные Центры событий.
Нажмите кнопку Сохранить. Для завершения настройки потребуется несколько минут.
После завершения настройки можно приступить к публикации сообщений в Microsoft Purview.
Настройка Центров событий для получения сообщений из Microsoft Purview
Перейдите к конфигурации Kafka в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.
Если конфигурация уже указана как тип Уведомления, центры событий уже настроены, и вы можете приступить к получению сообщений Microsoft Purview.
Примечание.
Одновременно можно настроить только один концентратор событий уведомлений .
Если конфигурация уведомлений еще не указана, выберите Добавить конфигурацию и конфигурацию уведомлений.
Укажите имя конфигурации уведомлений, выберите подписку, существующее пространство имен Центров событий, существующие Центры событий для отправки уведомлений, разделы, которые вы хотите использовать, и тип проверки подлинности, который вы хотите использовать.
Совет
Одно и то же пространство имен Центров событий можно использовать несколько раз, но каждой конфигурации потребуются собственные Центры событий.
Нажмите кнопку Сохранить. Для завершения настройки потребуется несколько минут.
После завершения настройки можно приступить к получению сообщений Microsoft Purview.
Удаление настроенных Центров событий
Чтобы удалить настроенные пространства имен Центров событий, выполните следующие действия.
Найдите и откройте учетную запись Microsoft Purview в портал Azure.
Выберите Конфигурация Kafka в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.
Выберите Центры событий, которые нужно отключить. (Центры перехватчиков отправляют сообщения в Microsoft Purview. Центры уведомлений получают уведомления.)
Нажмите кнопку Удалить , чтобы сохранить выбор и начать процесс отключения. Это может занять несколько минут.
Создание управляемого пространства имен
Если вам нужно, чтобы пространство имен Центров событий подключалось с помощью частной конечной точки или вы предпочитаете использовать управляемое пространство имен Центров событий, необходимо использовать 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"