Configuración de Event Hubs con Microsoft Purview para enviar y recibir mensajes de temas de Atlas Kafka

En este artículo se muestra cómo configurar Microsoft Purview para poder enviar y recibir eventos de temas de Atlas Kafka con Azure Event Hubs.

Si ya ha configurado el entorno, puede seguir nuestra guía para empezar a trabajar con la biblioteca .NET de Azure.Messaging.EventHubs para enviar y recibir mensajes.

Requisitos previos

Para configurar el entorno, necesita cumplir ciertos requisitos previos:

  • Una suscripción de Microsoft Azure. Para usar los servicios de Azure, incluidos Event Hubs, necesita una suscripción de Azure. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita o usar las ventajas del suscriptor de MSDN al crear una cuenta.
  • Una cuenta de Microsoft Purview activa.

Configuración de Event Hubs

Para enviar o recibir mensajes de temas de Atlas Kafka, deberá configurar al menos un espacio de nombres de Event Hubs. Puede:

Nota:

Si la cuenta de Microsoft Purview se creó antes del 15 de diciembre de 2022, es posible que ya tenga un recurso de Event Hubs administrado asociado a su cuenta. Puede proteger recursos administrados en la configuración de la página de la cuenta de Microsoft Purview en la Azure Portal. Captura de pantalla que muestra el botón de alternancia del espacio de nombres de Event Hubs resaltado en la página Recursos administrados de la página de la cuenta de Microsoft Purview en el Azure Portal.

  • Si no ve este recurso o está deshabilitado, siga los pasos siguientes para configurar Event Hubs.

  • Si está habilitado, puede seguir usando este espacio de nombres de Event Hubs administrado si lo prefiere. (Hay un costo asociado. Consulte la página de precios). Si desea administrar su propia cuenta de Event Hubs, primero debe deshabilitar esta característica y seguir los pasos que se indican a continuación. Si deshabilita el recurso de Event Hubs administrado, no podrá volver a habilitar un recurso de Event Hubs administrado. Solo podrá configurar su propio Centro de eventos.

Traiga su propio espacio de nombres

Puede configurar un espacio de nombres de Azure Event Hubs existente con un centro de eventos o crear uno nuevo para conectarse con Microsoft Purview.

Importante

Actualmente, los centros de eventos que usan puntos de conexión privados no se pueden configurar con mensajes de temas de Microsoft Purview para Atlas Kafka. Si necesita un punto de conexión privado, use un espacio de nombres administrado.

Permisos de Event Hubs

Para autenticarse con Event Hubs, puede usar:

Una de estas identidades necesitará al menos permisos de colaborador en Event Hubs para poder configurarlas para usarlas con Microsoft Purview.

Configuración de Event Hubs para publicar mensajes en Microsoft Purview

  1. Vaya a Configuración de Kafka en configuración en la página de la cuenta de Microsoft Purview de la Azure Portal.

    Captura de pantalla que muestra la opción de configuración de Kafka en el menú Microsoft Purview del Azure Portal.

  2. Seleccione Agregar configuración y Enlazar configuración.

    Nota:

    Puede agregar tantas configuraciones de enlace como necesite.

    Captura de pantalla que muestra la página de configuración de Kafka con la configuración de agregar configuración y enlace resaltada.

  3. Asigne un nombre a la configuración de enlace, seleccione la suscripción, un espacio de nombres de Event Hubs existente, un Event Hubs existente al que enviar las notificaciones, el grupo de consumidores que desea usar y el tipo de autenticación que desea usar.

    Sugerencia

    Puede usar el mismo espacio de nombres de Event Hubs más de una vez, pero cada configuración necesitará sus propios Event Hubs.

    Captura de pantalla que muestra la página de configuración del enlace, con todos los valores rellenados.

  4. Seleccione Guardar. La configuración tardará un par de minutos en completarse.

  5. Una vez completada la configuración, puede comenzar los pasos para publicar mensajes en Microsoft Purview.

Configuración de Event Hubs para recibir mensajes de Microsoft Purview

  1. Vaya a Configuración de Kafka en configuración en la página de la cuenta de Microsoft Purview de la Azure Portal.

    Captura de pantalla que muestra la opción de configuración de Kafka en el menú Microsoft Purview del Azure Portal.

  2. Si hay una configuración que ya aparece como tipo Notificación, Event Hubs ya está configurado y puede comenzar los pasos para recibir mensajes de Microsoft Purview.

    Nota:

    Solo se puede configurar una instancia de Notification Event Hubs a la vez.

    Captura de pantalla que muestra la opción de configuración de Kafka con una configuración de tipo de notificación lista.

  3. Si aún no aparece una configuración de notificación , seleccione Agregar configuración y Configuración de notificación.

    Captura de pantalla que muestra la página de configuración de Kafka con agregar configuración y configuración de notificación resaltados.

  4. Asigne un nombre a la configuración de notificación, seleccione la suscripción, un espacio de nombres de Event Hubs existente, un Event Hubs existente al que enviar las notificaciones, las particiones que desea usar y el tipo de autenticación que desea usar.

    Sugerencia

    Puede usar el mismo espacio de nombres de Event Hubs más de una vez, pero cada configuración necesitará sus propios Event Hubs.

    Captura de pantalla que muestra la página de configuración del centro de notificaciones, con todos los valores rellenados.

  5. Seleccione Guardar. La configuración tardará un par de minutos en completarse.

  6. Una vez completada la configuración, puede comenzar los pasos para recibir mensajes de Microsoft Purview.

Eliminación de Event Hubs configurado

Para quitar los espacios de nombres de Event Hubs configurados, puede seguir estos pasos:

  1. Busque y abra la cuenta de Microsoft Purview en el Azure Portal.

  2. Seleccione Configuración de Kafka en Configuración en la página de la cuenta de Microsoft Purview en el Azure Portal.

  3. Seleccione event hubs que desea deshabilitar. (Los centros de enlace envían mensajes a Microsoft Purview. Los centros de notificaciones reciben notificaciones).

  4. Seleccione Quitar para guardar la opción e iniciar el proceso de deshabilitación. Esto puede tardar varios minutos en completarse.

    Captura de pantalla que muestra la página de configuración de Kafka de la página de la cuenta de Microsoft Purview en el Azure Portal con el botón Quitar resaltado.

Creación de un espacio de nombres administrado

Si necesita el espacio de nombres de Event Hubs para conectarse mediante un punto de conexión privado o prefiere tener un espacio de nombres de Event Hubs administrado, deberá usar la API REST para configurar la cuenta.

Puede usar el script siguiente (set apiVersion = 2021-12-01) para actualizar una cuenta y de esta manera solo afectará a la configuración del centro de eventos:

$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"

Pasos siguientes