Adicionar origem da CDA do Azure Cosmos DB a um Eventstream

Este artigo mostra como adicionar uma origem de captura de dados de alteração do Azure Cosmos DB (Azure Cosmos DB for NoSQL) a um Eventstream.

O conector de origem da captura de dados de alterações (CDA) 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 eventstream, você poderá processar esses dados da CDA em tempo real e enviá-los a diferentes destinos no Fabric para processamento ou análise adicionais.

Observação

Não há suporte para esta origem nas seguintes regiões de capacidade do espaço de trabalho: Oeste dos EUA 3 e Oeste da Suíça.

Pré-requisitos

• Acesso a um workspace no modo de licença de capacidade do Fabric (ou) no modo de licença de Avaliação com permissões de Colaborador ou superior.
• Acesso a uma conta e a um banco de dados do Azure Cosmos DB for NoSQL.
• O seu banco de dados do Azure Cosmos DB for NoSQL deve ser acessível publicamente e não estar protegido por um firewall ou ter a segurança de uma rede virtual.
• Se você não tiver um Eventstream, crie um Eventstream.

Obter os detalhes de conexão no 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>/, da Chave Primária, do Nome do banco de dados e das IDs de item para os quais deseja coletar dados.

Observação

A CDA do Azure Cosmos DB for NoSQL está usando a Última Versão do Modo do Feed de Alterações do Azure Cosmos DB. Ele captura as alterações nos registros na última versão. Observe que as Exclusões não são capturadas neste modo.

1. Na página do portal do Azure da sua conta do Azure Cosmos DB, selecione Chaves em Configurações na navegação à esquerda.

2. Na página Chaves, copie os valores de URI e Chave primária a serem usados para configurar a conexão do Eventstream.

   

3. Na página de Visão geral do portal do Azure da sua conta do Azure Cosmos DB, observe o Banco de dados e a ID do item para os quais deseja coletar dados.

   

Observação

O número máximo de origens e destinos para um fluxo de eventos é 11.

Adicionar Azure Cosmos DB (CDA) como origem

Se você ainda não adicionou nenhuma fonte ao Eventstream, selecione o bloco Usar fonte externa.

Caso esteja adicionando a fonte a um Eventstream já publicado, alterne para o modo Editar, selecione Adicionar fonte na faixa de opções e selecione Fontes externas.

 

Na página Selecionar uma fonte de dados, pesquise e selecione Conectar no bloco Hubs de Eventos do Azure.

Configurar e conectar com o Azure Cosmos DB (CDA)

1. Na tela Conectar, em Conexão, selecione Nova conexão para criar uma conexão de nuvem vinculada ao banco de dados do Azure Cosmos DB.

   

2. 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 copiados do portal do Azure.
   • Nome da conexão: é gerado automaticamente ou você pode inserir um novo nome para essa conexão.
   • Chave de conta: insira a Chave Primária da sua conta do Azure Cosmos DB copiada do portal do Azure.

   

3. Selecione Conectar.

4. Forneça as informações a seguir para seus recursos do Azure Cosmos DB e selecione Avançar.

   • ID do contêiner: insira o nome do contêiner ou da tabela do Azure Cosmos DB ao qual deseja se conectar.

   • Banco de dados: insira o nome do 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.

     Você também pode alterar o Nome da fonte na seção Detalhes do fluxo à direita selecionando o botão Lápis.

     

5. Na página Revisar + conectar, examine o resumo e selecione Adicionar.

   

Exibir o Eventstream atualizado

1. Você vê a origem do Azure Cosmos DB (CDA) adicionada ao Eventstream no Modo de edição. Selecione Publicar para publicar as alterações e começar a transmitir dados da CDA do Azure Cosmos DB ao Eventstream.

   

2. Você verá o Eventstream no modo dinâmico. Selecione Editar na faixa de opções para voltar ao modo Editar para atualizar o Eventstream.

   

Conteúdo relacionado

Outros conectores:

• Amazon Kinesis Data Streams
• Hubs de eventos do Azure
• Hub IoT do Azure
• Captura de dados de alterações (CDA) com o Banco de Dados SQL do Azure
• Kafka para Confluent
• Ponto de extremidade personalizado
• Pub/Sub do Google Cloud
• CDA do Banco de Dados MySQL
• CDA do Banco de dados PostgreSQL
• Dados de amostra
• Eventos de Armazenamento de Blobs do Azure
• Evento de espaço de trabalho do Fabric