Adicionar Azure Cosmos DB CDC como origem no hub em tempo real

Este artigo descreve como adicionar o Azure Cosmos DB for NoSQL Change Data Capture (CDC) como uma fonte de eventos no hub Fabric Real-Time.

O conector de origem CDC (Change Data Capture) do Azure Cosmos DB 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 são capturadas em um fluxo, você pode processar esses dados CDC em tempo real e enviá-los para diferentes destinos no Fabric para processamento ou análise adicionais.

Pré-requisitos

• Acesso a um espaço de trabalho no modo de licença de capacidade de malha (ou) no modo de licença de avaliação com permissões de Colaborador ou superiores.
• 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.
• Se você não tiver um eventstream, crie um eventstream.

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.

1. Na página do portal do Azure para 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 de fluxo de eventos.

   

3. 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.

   

Obter eventos de um CDC do Azure Cosmos DB

Você pode obter eventos de um CDC do Azure Cosmos DB para o hub em tempo real de uma das maneiras:

• Usando a experiência Adicionar código-fonte
• Usando a página de códigos-fonte da Microsoft

Página de origens de dados

1. Entre no Microsoft Fabric.

2. Se você vir Power BI no canto inferior esquerdo da página, alterne para a carga de trabalho do Fabric selecionando Power BI e, em seguida, selecionando Fabric.

   

3. Selecione Tempo Real na barra de navegação esquerda.

   

4. Na página do hub em Tempo Real, selecione + Fontes de dados em Conectar a no menu de navegação esquerdo.

   

   Você também pode acessar a página Fontes de dados nas páginas Todos os fluxos de dados ou Meus fluxos de dados selecionando o botão + Conectar fonte de dados no canto superior direito.

   

Use as instruções da seção Adicionar CDC do Azure Cosmos DB como origem .

Página de fontes da Microsoft

1. No hub em tempo real, selecione Fontes da Microsoft.

2. Na lista suspensa Origem, selecione Azure Cosmos DB (CDC).

3. Em Assinatura, selecione uma assinatura do Azure que tenha o grupo de recursos com sua conta do Cosmos DB.

4. Em Grupo de recursos, selecione um grupo de recursos que tenha sua conta do Cosmos DB.

5. Em Região, selecione um local onde o Cosmos DB está localizado.

6. Agora, mova o mouse sobre o nome da fonte CDC do Cosmos DB que você deseja conectar ao hub em tempo real na lista de bancos de dados e selecione o botão Conectar ou selecione ... (reticências) e, em seguida, selecione o botão Ligar .

   

   Para configurar informações de conexão, use as etapas da seção Adicionar CDC do Azure Cosmos DB como origem . Ignore a primeira etapa de selecionar o Azure Cosmos DB CDC como um tipo de fonte no assistente Adicionar origem.

Adicionar CDC do Azure Cosmos DB como fonte

1. Na página Conectar, selecione Nova conexão.

   

2. Na seção Configurações de conexão, especifique o ponto de extremidade do Cosmos DB. Insira o URI ou ponto de extremidade da sua conta do Cosmos DB que você copiou do portal do Azure.

   

3. Expanda Opções avançadas e siga estas etapas:

   1. Para Número de tentativas, especifique o número máximo de vezes que o conector deve retransmitir uma solicitação para o banco de dados do Cosmos DB se a solicitação falhar devido a um erro recuperável.

   2. Para Enable AVERAGE function pass down, especifique se o conector deve passar a função de agregação AVG para o banco de dados do Cosmos DB.

   3. Para Habilitar passagem SORT para várias colunas, especifique se o conector deve permitir que várias colunas sejam passadas para o banco de dados do Cosmos DB quando especificado na cláusula ORDER BY da consulta SQL.

      

4. Role para baixo e, na seção Credenciais de conexão, siga estas etapas.

   1. Selecione uma conexão existente e mantenha a opção padrão Criar nova conexão .
   2. Para criar uma conexão, insira os seguintes valores:

      1. Em Nome da conexão, insira um nome para a conexão.

      2. Em Tipo de autenticação, selecione Chave da conta.

      3. Em Chave de conta, insira o valor da chave que você salvou anteriormente.

      4. Selecione Ligar.

         

5. Agora, na página Conectar , siga estas etapas:

   1. Especifique a ID do contêiner em sua conta do Azure Cosmos DB.

   2. Na seção Detalhes do fluxo à direita, selecione o espaço de trabalho Malha onde deseja salvar o fluxo de eventos que o Assistente vai criar.

   3. Para eventstream name, insira um nome para eventstream. O assistente cria um fluxo de eventos com o Azure Cosmos DB CDC selecionado como origem.

   4. O nome do fluxo é gerado automaticamente para você anexando -stream ao nome do fluxo de eventos. Você pode ver esse fluxo na página Todos os fluxos de dados do hub em tempo real quando o assistente terminar.

   5. Selecione Seguinte.

      

6. No ecrã Rever + ligar, reveja o resumo e, em seguida, selecione Criar origem.

   

Ver detalhes do fluxo de dados

1. Na página Rever + ligar, se selecionar Abrir fluxo de eventos, o assistente abre o fluxo de eventos que criou para si com o Azure Cosmos DB CDC selecionado como origem. Para fechar o assistente, selecione Fechar ou X* no canto superior direito da página.

   

2. No hub em tempo real, selecione Todos os fluxos de dados. Para ver o novo fluxo de dados, atualize a página Todos os fluxos de dados.

   

   Para obter etapas detalhadas, consulte Exibir detalhes de fluxos de dados no hub Fabric Real-Time.

Conteúdos relacionados

Para saber mais sobre como consumir fluxos de dados, consulte os seguintes artigos:

• Processar fluxos de dados
• Analise fluxos de dados
• Definir alertas em fluxos de dados