Adicionar a origem CDC do Azure Cosmos DB a um fluxo de eventos (visualização)

Artigo
06/18/2024

Este artigo mostra como adicionar uma fonte de Captura de Dados de Alteração do Azure Cosmos DB (Azure Cosmos DB para NoSQL) a um fluxo de eventos.

O conector de origem CDC (Change Data Capture) do Azure Cosmos DB para fluxos de eventos do Microsoft Fabric permite capturar um instantâneo dos dados atuais em um banco de dados do Azure Cosmos DB. Em seguida, o conector monitora e registra quaisquer alterações futuras no nível da linha nesses dados. Depois que as alterações forem capturadas no fluxo de eventos, você poderá processar esses dados CDC em tempo real e enviá-los para diferentes destinos no Fabric para processamento ou análise adicionais.

Importante

Os recursos aprimorados dos fluxos de eventos do Fabric estão atualmente em visualização.

Nota

Esta origem não é suportada nas seguintes regiões da capacidade do seu espaço de trabalho: Oeste US3, Suíça Oeste.

Pré-requisitos

Acesso ao espaço de trabalho premium do Fabric com permissões de Colaborador ou superior.
Acesso a uma conta e banco de dados do Azure Cosmos DB para NoSQL .
Seu banco de dados do Azure Cosmos DB para NoSQL deve ser acessível publicamente e não estar protegido por um firewall ou protegido em uma rede virtual.

Obter detalhes de conexão do portal do Azure

Os rótulos dos itens que você precisa coletar do portal do Azure são mostrados nas etapas a seguir. Você sempre precisa do URI do ponto de extremidade, em um formato como https://<account>.<api>.azure.com:<port>/, a Chave Primária e o Nome do banco de dados e IDs de item para os quais deseja coletar dados.

Nota

O Azure Cosmos DB para NoSQL CDC está usando o Modo de Versão Mais Recente do Feed de Alterações do Azure Cosmos DB. Ele captura as alterações nos registros na versão mais recente. Observe que as exclusões não são capturadas com esse modo.

Na página do portal do Azure para sua conta do Azure Cosmos DB, selecione Chaves em Configurações na navegação à esquerda.
Na página Chaves, copie os valores de URI e Chave primária a serem usados para configurar a conexão de fluxo de eventos.
Na página Visão Geral do portal do Azure para sua conta do Azure Cosmos DB, anote o Banco de Dados e a ID do item para os quais você deseja coletar dados.

Nota

O número máximo de fontes e destinos para um eventstream é 11.

Adicionar o Azure Cosmos DB (CDC) como fonte

Em Fabric Real-Time Intelligence, selecione Eventstream para criar um novo eventstream. Certifique-se de que a opção Capacidades Avançadas (pré-visualização) está ativada.
Na tela seguinte, selecione Adicionar fonte externa.

Configurar e conectar-se ao Azure Cosmos DB (CDC)

Na tela Selecione uma fonte de dados, selecione Azure Cosmos DB (CDC).
Na tela Conectar, em Conexão, selecione Nova conexão para criar uma conexão de nuvem vinculando ao seu banco de dados do Azure Cosmos DB.
Na tela Configurações de conexão , insira as seguintes informações:
- Ponto de extremidade do Cosmos DB: insira o URI ou o ponto de extremidade da sua conta do Cosmos DB que você copiou do portal do Azure.
- Nome da conexão: gerado automaticamente ou você pode inserir um novo nome para essa conexão.
- Chave da conta: insira a Chave Primária da sua conta do Azure Cosmos DB que você copiou do portal do Azure.
Selecione Ligar.
Forneça as seguintes informações para seus recursos do Azure Cosmos DB:
- ID do contêiner: insira o nome do contêiner ou da tabela do Azure Cosmos DB à qual você deseja se conectar.
- Banco de dados: insira o nome do seu banco de dados do Azure Cosmos DB.
- Política de deslocamento: selecione se deseja começar a ler os deslocamentos mais antigos ou mais recentes se não houver confirmação.
Selecione Seguinte.
Reveja o resumo e, em seguida, selecione Adicionar.