Поделиться через


Настройка Центров событий с помощью Microsoft Purview для отправки и получения сообщений в разделах Atlas Kafka

В этой статье показано, как настроить Microsoft Purview для отправки и получения событий в разделах Atlas Kafka с помощью Центры событий Azure.

Если вы уже настроили среду, вы можете следовать нашему руководству, чтобы приступить к работе с библиотекой Azure.Messaging.EventHubs .NET для отправки и получения сообщений.

Предварительные требования

Чтобы настроить среду, необходимо выполнить определенные предварительные требования:

Настройка Центров событий

Чтобы отправлять или получать сообщения тем Atlas Kafka, необходимо настроить по крайней мере одно пространство имен Центров событий. Вы можете:

Примечание.

Если учетная запись Microsoft Purview была создана до 15 декабря 2022 г., возможно, с вашей учетной записью уже связан управляемый ресурс Центров событий. Вы можете проверка в разделе Управляемые ресурсы в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure. Снимок экрана: переключатель пространства имен Центров событий, выделенный на странице Управляемые ресурсы страницы учетной записи Microsoft Purview в портал Azure.

  • Если этот ресурс не отображается или он отключен, выполните следующие действия, чтобы настроить центры событий.

  • Если он включен, вы можете продолжать использовать это управляемое пространство имен Центров событий, если хотите. (Есть связанные затраты. См. страницу цен.) Если вы хотите управлять собственной учетной записью Центров событий, сначала необходимо отключить эту функцию и выполнить следующие действия. Если вы отключите управляемый ресурс Центров событий, вы не сможете повторно включить управляемый ресурс Концентратора событий. Вы сможете настроить только собственные Центры событий..

Создание собственного пространства имен

Вы можете настроить существующее пространство имен Центры событий Azure с помощью Центров событий или создать новое пространство имен для подключения к Microsoft Purview.

Важно!

В настоящее время центры событий, использующие частные конечные точки, не могут быть настроены с помощью Microsoft Purview для сообщений тем Atlas Kafka. Если вам нужна частная конечная точка, используйте управляемое пространство имен.

Разрешения Центров событий

Для проверки подлинности в Центрах событий можно использовать:

Для одного из этих удостоверений потребуется по крайней мере участник разрешений на центры событий, чтобы настроить их для использования с Microsoft Purview.

Настройка Центров событий для публикации сообщений в Microsoft Purview

  1. Перейдите к конфигурации Kafka в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.

    Снимок экрана: параметр конфигурации Kafka в меню Microsoft Purview в портал Azure.

  2. Выберите Добавить конфигурацию и Конфигурацию перехватчика.

    Примечание.

    Вы можете добавить любое количество конфигураций перехватчиков.

    Снимок экрана: страница конфигурации Kafka с выделенными выделенными параметрами добавления конфигурации и конфигурации перехватчика.

  3. Присвойте имя конфигурации перехватчика, выберите подписку, существующее пространство имен Центров событий, существующие Центры событий для отправки уведомлений, группу потребителей, которую вы хотите использовать, и тип проверки подлинности, которую вы хотите использовать.

    Совет

    Одно и то же пространство имен Центров событий можно использовать несколько раз, но каждой конфигурации потребуются собственные Центры событий.

    Снимок экрана: страница конфигурации перехватчика со всеми заполненными значениями.

  4. Нажмите кнопку Сохранить. Для завершения настройки потребуется несколько минут.

  5. После завершения настройки можно приступить к публикации сообщений в Microsoft Purview.

Настройка Центров событий для получения сообщений из Microsoft Purview

  1. Перейдите к конфигурации Kafka в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.

    Снимок экрана: параметр конфигурации Kafka в меню Microsoft Purview в портал Azure.

  2. Если конфигурация уже указана как тип Уведомления, центры событий уже настроены, и вы можете приступить к получению сообщений Microsoft Purview.

    Примечание.

    Одновременно можно настроить только один концентратор событий уведомлений .

    Снимок экрана: параметр конфигурации Kafka с готовой конфигурацией типа уведомления.

  3. Если конфигурация уведомлений еще не указана, выберите Добавить конфигурацию и конфигурацию уведомлений.

    Снимок экрана: страница конфигурации Kafka с выделенными параметрами добавления конфигурации и уведомлений.

  4. Укажите имя конфигурации уведомлений, выберите подписку, существующее пространство имен Центров событий, существующие Центры событий для отправки уведомлений, разделы, которые вы хотите использовать, и тип проверки подлинности, который вы хотите использовать.

    Совет

    Одно и то же пространство имен Центров событий можно использовать несколько раз, но каждой конфигурации потребуются собственные Центры событий.

    Снимок экрана: страница конфигурации центра уведомлений со всеми значениями.

  5. Нажмите кнопку Сохранить. Для завершения настройки потребуется несколько минут.

  6. После завершения настройки можно приступить к получению сообщений Microsoft Purview.

Удаление настроенных Центров событий

Чтобы удалить настроенные пространства имен Центров событий, выполните следующие действия.

  1. Найдите и откройте учетную запись Microsoft Purview в портал Azure.

  2. Выберите Конфигурация Kafka в разделе Параметры на странице учетной записи Microsoft Purview в портал Azure.

  3. Выберите Центры событий, которые нужно отключить. (Центры перехватчиков отправляют сообщения в Microsoft Purview. Центры уведомлений получают уведомления.)

  4. Нажмите кнопку Удалить , чтобы сохранить выбор и начать процесс отключения. Это может занять несколько минут.

    Снимок экрана: страница конфигурации Kafka на странице учетной записи Microsoft Purview в портал Azure с выделенной кнопкой удаления.

Создание управляемого пространства имен

Если вам нужно, чтобы пространство имен Центров событий подключалось с помощью частной конечной точки или вы предпочитаете использовать управляемое пространство имен Центров событий, необходимо использовать 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"

Дальнейшие действия