Compartilhar via

Adicionar origem da CDA do Azure Cosmos DB a um Eventstream

  • Artigo

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.

    Captura de tela do URI e da chave primária na página Chaves do Azure Cosmos DB no portal do Azure.

  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.

    Captura de tela da listagem Contêineres de uma conta da API NoSQL do Azure Cosmos DB.

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.

Captura de tela que mostra a seleção do 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.

Captura de tela que mostra a seleção de Adicionar fonte para o menu Fontes externas.  

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

Captura de tela que mostra a seleção do Azure Cosmos DB (CDC) como o tipo de fonte no assistente Selecionar uma fonte de dados.

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.

    Captura de tela mostrando a página Conectar com o link Nova conexão selecionado.

  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.

    Captura de tela das Configurações de conexão para a origem da CDA do Azure Cosmos DB.

  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.

      Captura de tela dos detalhes da conexão para a origem da CDA do Azure Cosmos DB.

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

    Captura de tela que mostra a página Revisar + conectar da fonte CDC do Azure Cosmos DB.

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.

    Captura de tela da origem da CDA do Azure Cosmos DB adicionada no Modo de edição com o botão Publicar realçado.

  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.

    Captura de tela do Eventstream publicado com a origem do Azure Cosmos DB na Exibição ao vivo.

Conteúdo relacionado

Outros conectores: