Tutorial: Configurar o banco de dados espelhado do Microsoft Fabric para o Azure Cosmos DB (Visualização)

Neste tutorial, você configura um banco de dados espelhado de malha a partir de uma conta existente do Azure Cosmos DB para NoSQL.

O espelhamento replica incrementalmente os dados do Azure Cosmos DB no Fabric OneLake quase em tempo real, sem afetar o desempenho de cargas de trabalho transacionais ou consumir Unidades de Solicitação (RUs). Você pode criar relatórios do Power BI diretamente nos dados no OneLake, usando o modo DirectLake. Você pode executar consultas ad-hoc em SQL ou Spark, criar modelos de dados usando blocos de anotações e aproveitar recursos internos Copilot e avançados de IA no Fabric para analisar os dados.

Importante

O espelhamento para o Azure Cosmos DB está atualmente em visualização. Não há suporte para cargas de trabalho de produção durante a visualização. Atualmente, apenas contas do Azure Cosmos DB para NoSQL são suportadas.

Pré-requisitos

• Uma conta existente do Azure Cosmos DB para NoSQL.
  • Se você não tiver uma assinatura do Azure, experimente o Azure Cosmos DB para NoSQL gratuitamente.
  • Se você tiver uma assinatura existente do Azure, crie uma nova conta do Azure Cosmos DB para NoSQL.
• Uma capacidade de malha existente. Se você não tiver uma capacidade existente, inicie uma avaliação do Fabric. O espelhamento pode não estar disponível em algumas regiões de malha. Para obter mais informações, consulte Regiões suportadas.

Gorjeta

Durante a visualização pública, é recomendável usar uma cópia de teste ou desenvolvimento dos dados existentes do Azure Cosmos DB que podem ser recuperados rapidamente de um backup.

Configurar sua conta do Azure Cosmos DB

Primeiro, verifique se a conta do Azure Cosmos DB de origem está configurada corretamente para ser usada com o espelhamento de malha.

1. Navegue até sua conta do Azure Cosmos DB no portal do Azure.

2. Certifique-se de que o backup contínuo esteja ativado. Se não estiver habilitado, siga o guia em migrar uma conta existente do Azure Cosmos DB para backup contínuo para habilitar o backup contínuo. Esse recurso pode não estar disponível em alguns cenários. Para obter mais informações, consulte Limitações de banco de dados e conta.

3. Certifique-se de que as opções de rede estão definidas para acesso à rede pública para todas as redes. Caso contrário, siga o guia em Configurar o acesso à rede para uma conta do Azure Cosmos DB.

Criar um banco de dados espelhado

Agora, crie um banco de dados espelhado que seja o destino dos dados replicados. Para obter mais informações, consulte O que esperar do espelhamento.

1. Navegue até a página inicial do portal do Fabric.

2. Abra um espaço de trabalho existente ou crie um novo espaço de trabalho.

3. No menu de navegação, selecione Criar.

4. Selecione Criar, localize a seção Data Warehouse e selecione Azure Cosmos DB espelhado (Visualização).

5. Forneça um nome para o banco de dados espelhado e selecione Criar.

Conectar-se ao banco de dados de origem

Em seguida, conecte o banco de dados de origem ao banco de dados espelhado.

1. Na seção Nova conexão, selecione Azure Cosmos DB para NoSQL.

2. Forneça credenciais para a conta do Azure Cosmos DB para NoSQL, incluindo estes itens:

   	Value
   Ponto de extremidade do Azure Cosmos DB	Ponto de extremidade de URL para a conta de origem.
   Nome da ligação	Nome exclusivo para a conexão.
   Tipo de autenticação	Selecione Chave da conta.
   Chave da conta	Chave de leitura-gravação para a conta de origem.

   

3. Selecione Ligar. Em seguida, selecione um banco de dados para espelhar.

   Nota

   Todos os contêineres no banco de dados são espelhados.

Iniciar o processo de espelhamento

1. Selecione Espelhar banco de dados. O espelhamento começa agora.

2. Aguarde dois a cinco minutos. Em seguida, selecione Monitorar replicação para ver o status da ação de replicação.

3. Após alguns minutos, o status deve mudar para Em execução, o que indica que os contêineres estão sendo sincronizados.

   Gorjeta

   Se não conseguir encontrar os contêineres e o status de replicação correspondente, aguarde alguns segundos e atualize o painel. Em casos raros, poderá receber mensagens de erro transitórias. Você pode ignorá-los com segurança e continuar a atualizar.

4. Quando o espelhamento conclui a cópia inicial dos contêineres, uma data aparece na última coluna de atualização . Se os dados fossem replicados com êxito, a coluna total de linhas conteria o número de itens replicados.

Espelhamento de malha do monitor

Agora que seus dados estão ativos e em execução, há vários cenários de análise disponíveis em toda a malha.

1. Depois que o Espelhamento de malha estiver configurado, você será automaticamente navegado para o painel Status da replicação.

2. Aqui, monitore o estado atual da replicação. Para obter mais informações e detalhes sobre os estados de replicação, consulte Monitorar a replicação do Fabric Mirror.

Consultar o banco de dados de origem do Fabric

Use o portal do Fabric para explorar os dados que já existem em sua conta do Azure Cosmos DB, consultando seu banco de dados do Cosmos DB de origem.

1. Navegue até o banco de dados espelhado no portal da malha.

2. Selecione Exibir e, em seguida , Banco de dados de origem. Esta ação abre o explorador de dados do Azure Cosmos DB com uma exibição somente leitura do banco de dados de origem.

   

3. Selecione um contêiner, abra o menu de contexto e selecione Nova consulta SQL.

4. Execute qualquer consulta. Por exemplo, use SELECT COUNT(1) FROM container para contar o número de itens no contêiner.

   Nota

   Todas as leituras no banco de dados de origem são roteadas para o Azure e consumirão Unidades de Solicitação (RUs) alocadas na conta.

Analisar o banco de dados espelhado de destino

Agora, use o T-SQL para consultar seus dados NoSQL que agora estão armazenados no Fabric OneLake.

1. Navegue até o banco de dados espelhado no portal da malha.

2. Mude do Azure Cosmos DB espelhado para o ponto de extremidade de análise SQL.

   

3. Cada contêiner no banco de dados de origem deve ser representado no ponto de extremidade da análise SQL como uma tabela de depósito.

4. Selecione qualquer tabela, abra o menu de contexto, selecione Nova Consulta SQL e, finalmente, selecione Selecionar Top 100.

5. A consulta executa e retorna 100 registros na tabela selecionada.

6. Abra o menu de contexto da mesma tabela e selecione Nova Consulta SQL. Escreva uma consulta de exemplo que use agregações como SUM, COUNT, MINou MAX. Junte várias tabelas no armazém para executar a consulta em vários contêineres.

   Nota

   Por exemplo, essa consulta seria executada em vários contêineres:

   SELECT
       d.[product_category_name],
       t.[order_status],
       c.[customer_country],
       s.[seller_state],
       p.[payment_type],
       sum(o.[price]) as price,
       sum(o.[freight_value]) freight_value 
   FROM
       [dbo].[products] p 
   INNER JOIN
       [dbo].[OrdersDB_order_payments] p 
           on o.[order_id] = p.[order_id] 
   INNER JOIN
       [dbo].[OrdersDB_order_status] t 
           ON o.[order_id] = t.[order_id] 
   INNER JOIN
       [dbo].[OrdersDB_customers] c 
           on t.[customer_id] = c.[customer_id] 
   INNER JOIN
       [dbo].[OrdersDB_productdirectory] d 
           ON o.product_id = d.product_id 
   INNER JOIN
       [dbo].[OrdersDB_sellers] s 
           on o.seller_id = s.seller_id 
   GROUP BY
       d.[product_category_name],
       t.[order_status],
       c.[customer_country],
       s.[seller_state],
       p.[payment_type]
   

   Este exemplo assume o nome da tabela e das colunas. Use sua própria tabela e colunas ao escrever sua consulta SQL.

7. Selecione a consulta e, em seguida, selecione Guardar como vista. Dê um nome exclusivo ao modo de exibição. Você pode acessar essa exibição a qualquer momento no portal do Fabric.

8. Retorne ao banco de dados espelhado no portal da malha.

9. Selecione Nova consulta visual. Use o editor de consultas para criar consultas complexas.

   

Criando relatórios de BI nas consultas ou exibições SQL

1. Selecione a consulta ou vista e, em seguida, selecione Explorar estes dados (pré-visualização). Esta ação explora a consulta no Power BI diretamente usando o Direct Lake nos dados espelhados do OneLake.
2. Edite os gráficos conforme necessário e salve o relatório.

Gorjeta

Você também pode, opcionalmente, usar Copilot ou outros aprimoramentos para criar painéis e relatórios sem qualquer movimento adicional de dados.

Mais exemplos

Saiba mais sobre como acessar e consultar dados espelhados do Azure Cosmos DB na malha:

• Como fazer: Consultar dados aninhados em bancos de dados espelhados do Microsoft Fabric do Azure Cosmos DB
• Como acessar dados espelhados do Azure Cosmos DB no Lakehouse e em blocos de anotações do Microsoft Fabric (Visualização)
• Como fazer: Unir dados espelhados do Azure Cosmos DB com outros bancos de dados espelhados no Microsoft Fabric

Conteúdos relacionados

• Espelhando o Azure Cosmos DB (Visualização)
• Perguntas frequentes: bancos de dados espelhados do Microsoft Fabric do Azure Cosmos DB