Configurar hubs de eventos com o Microsoft Purview para enviar e receber mensagens de tópicos do Atlas Kafka
Este artigo irá mostrar-lhe como configurar o Microsoft Purview para poder enviar e receber eventos de tópicos do Atlas Kafka com Hubs de Eventos do Azure.
Se já tiver configurado o seu ambiente, pode seguir o nosso guia para começar a utilizar a biblioteca .NET Azure.Messaging.EventHubs para enviar e receber mensagens.
Pré-requisitos
Para configurar o seu ambiente, precisa de determinados pré-requisitos:
- Uma subscrição do Microsoft Azure. Para utilizar os serviços do Azure, incluindo os Hubs de Eventos, precisa de uma subscrição do Azure. Se não tiver uma conta do Azure, pode inscrever-se numa avaliação gratuita ou utilizar os benefícios de subscritor do MSDN quando criar uma conta.
- Uma conta ativa do Microsoft Purview.
Configurar Hubs de Eventos
Para enviar ou receber mensagens de tópicos do Atlas Kafka, terá de configurar pelo menos um espaço de nomes dos Hubs de Eventos. Você pode:
- Criar o seu próprio espaço de nomes Hubs de Eventos do Azure e configurá-lo para funcionar com o Microsoft Purview
- Utilizar a API REST para criar um espaço de nomes gerido
Observação
Se a sua conta do Microsoft Purview tiver sido criada antes de 15 de dezembro de 2022, poderá já ter um recurso dos Hubs de Eventos gerido associado à sua conta.
Pode marcar em Recursos Geridos nas definições na página da sua conta do Microsoft Purview no portal do Azure.
Se não vir este recurso ou estiver desativado, siga os passos abaixo para configurar os Hubs de Eventos.
Se estiver ativado, pode continuar a utilizar este espaço de nomes dos Hubs de Eventos gerido, se preferir. (Existe um custo associado. Veja a página de preços.) Se quiser gerir a sua própria conta dos Hubs de Eventos, primeiro tem de desativar esta funcionalidade e seguir os passos abaixo. Se desativar o recurso dos Hubs de Eventos geridos, não poderá reativar um recurso do Hub de Eventos gerido. Só poderá configurar os seus próprios Hubs de Eventos.
Traga o seu próprio espaço de nomes dos Hubs de Eventos
Pode configurar um espaço de nomes Hubs de Eventos do Azure existente com um Hub de Eventos ou criar um novo para se ligar ao Microsoft Purview.
Permissões dos Hubs de Eventos
Para se autenticar com os Hubs de Eventos, pode utilizar:
- Identidade gerida do Microsoft Purview (Recomendado)
- Identidade gerida atribuída pelo utilizador – apenas disponível ao configurar espaços de nomes após a criação da conta e se estiver a utilizar Hubs de Eventos com uma rede aberta.
Estas identidades precisarão de, pelo menos, contribuidor permissões nos Hubs de Eventos para poderem configurá-las para serem utilizadas com o Microsoft Purview.
Redes dos Hubs de Eventos
Se a sua conta do Microsoft Purview estiver a utilizar pontos finais privados, configure um ponto final privado de ingestão para ligar aos Hubs de Eventos.
A rede da área de trabalho dos Hubs de Eventos tem de ser configurada de uma de duas formas:
- Acesso à rede pública definido como Redes selecionadas ou Desativado, Permitir que os serviços Microsoft fidedignos ignorem esta firewall definida como Sim e utilizar a identidade gerida do Microsoft Purview para autenticar.
- Acesso à rede pública definido como Todas as redes e com a identidade gerida do Microsoft Purview ou uma identidade gerida atribuída pelo utilizador para autenticar.
O status do Microsoft Purview como um serviço fidedigno significa que, desde que a opção Permitir que os serviços Microsoft fidedignos ignorem esta firewall esteja definida como Sim no recurso dos Hubs de Eventos, os seus hooks ainda podem receber mensagens dos Hubs de Eventos.
Para obter mais informações sobre a rede dos Hubs de Eventos, veja a documentação do Hubs de Eventos do Azure.
Configurar Os Hubs de Eventos para publicar mensagens no Microsoft Purview
Navegue para a configuração do Kafka nas definições na página da sua conta do Microsoft Purview no portal do Azure.
Selecione Adicionar configuração e Configuração do hook.
Observação
Pode adicionar o número de configurações de hook de que precisar.
Atribua um nome à configuração do hook, selecione a sua subscrição, um espaço de nomes dos Hubs de Eventos existente, um Hub de Eventos existente para o qual enviar as notificações, o grupo de consumidores que pretende utilizar e o tipo de autenticação que pretende utilizar.
Dica
Pode utilizar o mesmo espaço de nomes dos Hubs de Eventos mais do que uma vez, mas cada configuração precisará dos seus próprios Hubs de Eventos.
Selecione Salvar. A conclusão da configuração demorará alguns minutos.
Assim que a configuração estiver concluída, pode começar os passos para publicar mensagens no Microsoft Purview.
Configurar os Hubs de Eventos para receber mensagens do Microsoft Purview
Navegue para a configuração do Kafka nas definições na página da sua conta do Microsoft Purview no portal do Azure.
Se já existir uma configuração listada como tipo Notificação, os Hubs de Eventos já estão configurados e pode começar os passos para receber mensagens do Microsoft Purview.
Observação
Só é possível configurar um Hub de Eventos de Notificação de cada vez.
Se ainda não existir uma Configuração de notificação listada, selecione Adicionar configuração e Configuração de notificação.
Atribua um nome à configuração de notificação, selecione a sua subscrição, um espaço de nomes dos Hubs de Eventos existente, um Hub de Eventos existente para onde enviar as notificações, as partições que pretende utilizar e o tipo de autenticação que pretende utilizar.
Dica
Pode utilizar o mesmo espaço de nomes dos Hubs de Eventos mais do que uma vez, mas cada configuração precisará dos seus próprios Hubs de Eventos.
Selecione Salvar. A conclusão da configuração demorará alguns minutos.
Assim que a configuração estiver concluída, pode começar os passos para receber mensagens do Microsoft Purview.
Remover Hubs de Eventos configurados
Para remover espaços de nomes dos Hubs de Eventos configurados, pode seguir estes passos:
Procure e abra a sua conta do Microsoft Purview no portal do Azure.
Selecione Configuração do Kafka nas definições na página da sua conta do Microsoft Purview no portal do Azure.
Selecione os Hubs de Eventos que pretende desativar. (Os hubs hook enviam mensagens para o Microsoft Purview. Os hubs de notificação recebem notificações.)
Selecione Remover para guardar a opção e iniciar o processo de desativação. Esta ação pode demorar vários minutos a concluir.
Criar um espaço de nomes gerido
Se preferir ter um espaço de nomes dos Hubs de Eventos gerido, terá de utilizar a API REST para configurar a sua conta.
Pode utilizar o script abaixo (set apiVersion = 2021-12-01) para atualizar uma conta e desta 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"