Configurar hubs de eventos com o Microsoft Purview para enviar e receber mensagens de tópicos do Atlas Kafka

Este artigo mostrará como configurar o Microsoft Purview para poder enviar e receber eventos de tópicos do Atlas Kafka com hubs de eventos do Azure.

Se você já tiver configurado seu ambiente, poderá seguir nosso guia para começar a usar a biblioteca .NET do Azure.Messaging.EventHubs para enviar e receber mensagens.

Pré-requisitos

Para configurar seu ambiente, você precisa de determinados pré-requisitos em vigor:

• Uma assinatura do Microsoft Azure. Para usar os serviços do Azure, incluindo hubs de eventos, você precisa de uma assinatura do Azure. Se você não tiver uma conta do Azure, poderá se inscrever para uma avaliação gratuita ou usar seus benefícios de assinante do MSDN ao criar uma conta.
• Uma conta ativa do Microsoft Purview.

Configurar hubs de eventos

Para enviar ou receber mensagens de tópicos do Atlas Kafka, você precisará configurar pelo menos um namespace dos Hubs de Eventos. Você pode:

• Crie seu próprio namespace dos Hubs de Eventos do Azure e configure-o para trabalhar com o Microsoft Purview
• Use a API REST para criar um namespace gerenciado

Traga seu próprio namespace

Você pode configurar um namespace existente dos Hubs de Eventos do Azure com um Hubs de Eventos ou criar um novo para se conectar ao Microsoft Purview.

Permissões dos Hubs de Eventos

Para autenticar com seus Hubs de Eventos, você pode usar:

• Identidade gerenciada do Microsoft Purview
• Identidade gerenciada atribuída pelo usuário – disponível somente ao configurar namespaces após a criação da conta.

Uma dessas identidades precisará de pelo menos contribuidor permissões em seus Hubs de Eventos para poder configurá-las para usar com o Microsoft Purview.

Configurar hubs de eventos para publicar mensagens no Microsoft Purview

1. Navegue até a configuração do Kafka em configurações na página da conta do Microsoft Purview no portal do Azure.

   

2. Selecione Adicionar configuração e configuração do Gancho.

   Observação

   Você pode adicionar quantas configurações de gancho precisar.

   

3. Dê um nome à configuração do gancho, selecione sua assinatura, um namespace de Hubs de Eventos existente, um Hubs de Eventos existente para enviar as notificações, o grupo de consumidores para o qual você deseja usar e o tipo de autenticação que você gostaria de usar.

   Dica

   Você pode usar o mesmo namespace dos Hubs de Eventos mais de uma vez, mas cada configuração precisará de seus próprios Hubs de Eventos.

   

4. Selecione Salvar. Levará alguns minutos para a sua configuração ser concluída.

5. Depois que a configuração for concluída, você poderá iniciar as etapas para publicar mensagens no Microsoft Purview.

Configurar hubs de eventos para receber mensagens do Microsoft Purview

1. Navegue até a configuração do Kafka em configurações na página da conta do Microsoft Purview no portal do Azure.

   

2. Se houver uma configuração já listada como notificação de tipo, os Hubs de Eventos já estão configurados e você poderá iniciar as etapas para receber mensagens do Microsoft Purview.

   Observação

   Somente um Hub de Eventos de Notificação pode ser configurado por vez.

   

3. Se ainda não houver uma configuração de notificação listada, selecione Adicionar configuração e configuração de notificação.

   

4. Dê um nome à sua configuração de notificação, selecione sua assinatura, um namespace de Hubs de Eventos existente, um hub de eventos existente para o qual enviar as notificações, as partições que você deseja usar e o tipo de autenticação que você gostaria de usar.

   Dica

   Você pode usar o mesmo namespace dos Hubs de Eventos mais de uma vez, mas cada configuração precisará de seus próprios Hubs de Eventos.

   

5. Selecione Salvar. Levará alguns minutos para a sua configuração ser concluída.

6. Depois que a configuração for concluída, você poderá iniciar as etapas para receber mensagens do Microsoft Purview.

Remover hubs de eventos configurados

Para remover namespaces de Hubs de Eventos configurados, você pode seguir estas etapas:

1. Pesquise e abra sua conta do Microsoft Purview no portal do Azure.

2. Selecione Configuração do Kafka em configurações na página da conta do Microsoft Purview no portal do Azure.

3. Selecione os Hubs de Eventos que você deseja desabilitar. (Hubs de gancho enviam mensagens para o Microsoft Purview. Os hubs de notificação recebem notificações.)

4. Selecione Remover para salvar a escolha e iniciar o processo de desabilitação. Isso pode levar vários minutos para ser concluído.

   

Criar um namespace gerenciado

Se você precisar do namespace dos Hubs de Eventos para se conectar usando um ponto de extremidade privado ou preferir ter um namespace gerenciado dos Hubs de Eventos, precisará usar a API REST para configurar sua conta.

Você pode usar o script abaixo (definir apiVersion = 2021-12-01) para atualizar uma conta e dessa forma só afetará a configuração do hub 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"

Próximas etapas

• Publicar e processar mensagens de tópicos do Atlas Kafka usando seus Hubs de Eventos
• Exemplos de Hubs de Eventos no GitHub
• Exemplos de processador de eventos no GitHub
• Uma introdução às notificações do Atlas