Tutorial: Configurar o banco de dados espelhado do Microsoft Fabric para o Azure Cosmos DB (versão prévia)

2025-08-22

Neste tutorial, você configurará um banco de dados espelhado do Fabric 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 RUs (Unidades de Solicitação). Você pode criar relatórios do Power BI diretamente nos dados no OneLake, usando o modo DirectLake. Você pode executar consultas ad hoc no SQL ou Spark, criar modelos de dados usando notebooks e usar 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 versão prévia. Não há suporte para cargas de trabalho de produção durante a visualização. Atualmente, há suporte apenas para contas do Azure Cosmos DB para NoSQL.

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 existente do Fabric. 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 do Fabric. Para obter mais informações, consulte regiões com suporte.

Dica

Durante a visualização pública, é recomendável usar uma cópia de teste ou desenvolvimento de seus 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 de origem do Azure Cosmos DB está configurada corretamente para usar com o espelhamento do Fabric.

Navegue até sua conta do Azure Cosmos DB no portal do Azure.
Verifique se o backup contínuo está habilitado. Se não estiver habilitado, siga o guia para migrar uma conta existente do Azure Cosmos DB para o 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.
Verifique se as opções de rede estão definidas como acesso à rede pública para todas as redes. Caso contrário, siga o guia para 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.

Navegue até a página inicial do portal do Fabric .
Abra um workspace existente ou crie um novo workspace.
No menu de navegação, selecione Criar.
Selecione Criar, localize a seção Data Warehouse e selecione Espelhado Azure Cosmos DB (versão prévia).
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.

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

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 conexão	Nome exclusivo para a conexão.
Tipo de autenticação	Selecione a chave da conta ou a conta organizacional.
Chave de Conta	Chave de leitura/gravação para a conta de origem.
Conta organizacional	Token de acesso da ID do Microsoft Entra.

Observação

Para a autenticação da ID do Microsoft Entra, as seguintes permissões RBAC são necessárias:

Microsoft.DocumentDB/databaseAccounts/readMetadata
Microsoft.DocumentDB/databaseAccounts/readAnalytics

Para obter mais informações, consulte a documentação do controle de acesso baseado em função do plano de dados.

Selecione Conectar. Em seguida, selecione um banco de dados para espelhar. Opcionalmente, selecione contêineres específicos para espelhar.

Iniciar o processo de espelhamento

Selecione Espelhar banco de dados. O espelhamento agora começa.
Aguarde de dois a cinco minutos. Em seguida, selecione Monitorar replicação para ver o status da ação de replicação.
Após alguns minutos, o status deve ser alterado para Em execução, o que indica que os contêineres estão sendo sincronizados.

Dica

Se você não conseguir encontrar os contêineres e o status de replicação correspondente, aguarde alguns segundos e atualize o painel. Em casos raros, você pode receber mensagens de erro transitórias. Você pode ignorá-los com segurança e continuar a atualizar.
Quando o espelhamento conclui a cópia inicial dos contêineres, uma data aparece na última coluna de atualização . Se os dados tiverem sido replicados com êxito, a coluna total de linhas conterá o número de itens replicados.

Monitorar espelhamento do Fabric

Agora que seus dados estão em funcionamento, há vários cenários de análise disponíveis em todo o Fabric.

Depois que o Espelhamento de Malha estiver configurado, você será navegado automaticamente para o painel Status da Replicação .
Aqui, monitore o estado atual da replicação. Para obter mais informações e detalhes sobre os estados de replicação, veja Monitorar a replicação de banco de dados espelhados do Fabric.

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 cosmos DB de origem.

Navegue até o banco de dados espelhado no portal do Fabric.
Selecione Exibir e, em seguida, Banco de dados de origem. Essa ação abre o data explorer do Azure Cosmos DB com uma exibição somente leitura do banco de dados de origem.
Selecione um contêiner e, em seguida, abra o menu de contexto e selecione Nova consulta SQL.
Execute qualquer consulta. Por exemplo, use SELECT COUNT(1) FROM container para contar o número de itens no contêiner.

Observação

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

Analisar o banco de dados espelhado de destino

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

Navegue até o banco de dados espelhado no portal do Fabric.
Alterne do Azure Cosmos DB espelhado para o ponto de extremidade de análise do SQL.
Cada contêiner no banco de dados de origem deve ser representado no ponto de extremidade de análise do SQL como uma tabela de warehouse.
Selecione qualquer tabela, abra o menu de contexto e selecione Nova Consulta SQL e, por fim, selecione Top 100.
A consulta é executada e retorna 100 registros na tabela selecionada.

Abra o menu de contexto da mesma tabela e selecione Nova Consulta SQL. Escreva uma consulta de exemplo que use agregações comoSUM, , MINCOUNTou MAX. Junte várias tabelas no warehouse para executar a consulta em vários contêineres.

Observação

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 pressupõe o nome da tabela e das colunas. Use sua própria tabela e colunas ao escrever sua consulta SQL.

Selecione a consulta e, em seguida, selecione Salvar como exibição. Dê ao modo de exibição um nome exclusivo. Você pode acessar essa exibição a qualquer momento no portal do Fabric.
Retorne ao banco de dados espelhado no portal do Fabric.
Selecione Nova consulta visual. Use o editor de consultas para criar consultas complexas.

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

Selecione a consulta ou a exibição e, em seguida, selecione Explorar esses dados (versão prévia). Essa ação explora a consulta no Power BI diretamente usando dados espelhados do Direct Lake no OneLake.
Edite os gráficos conforme necessário e salve o relatório.

Dica

Opcionalmente, você também pode usar Copilot ou outros aprimoramentos para criar dashboards e relatórios sem qualquer movimentação de dados adicional.

Mais exemplos

Saiba mais sobre como acessar e consultar dados espelhados do Azure Cosmos DB no Fabric: