Tutorial: Configurar a base de dados espelhada Microsoft Fabric para Azure Cosmos DB

Neste tutorial, configura um banco de dados espelhado do Fabric 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 notebooks e usar recursos de IA internos Copilot e avançados no Fabric para analisar os dados.

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 Fabric 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 do Fabric. Para obter mais informações, consulte Regiões suportadas.

Sugestão

Recomenda-se usar uma cópia de teste ou desenvolvimento dos seus dados existentes do Azure Cosmos DB, que possa ser rapidamente recuperada a partir de um backup.

Configurar a 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 do Fabric.

Navegue até à sua conta do Azure Cosmos DB no portal do Azure.
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. Este 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.
Se a sua conta Azure Cosmos DB usar redes virtuais ou endpoints privados, precisa de configurar o Network ACL Bypass para permitir que o seu espaço de trabalho Fabric aceda à conta. Para mais informações, consulte Configurar espelhamento para contas Azure Cosmos DB com restrições de rede. Se a sua conta estiver configurada para acesso público a todas as redes, pode saltar para a secção seguinte.

Criar uma base de dados espelhada

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é à página inicial do Fabric portal.
Abra um espaço de trabalho existente ou crie um novo espaço de trabalho.
No menu de navegação, selecione Criar.
Selecione Criar, localize a secção Data Warehouse e depois selecione Mirrored Azure Cosmos DB.
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:

Credenciais da conta	Valor
Ponto final do Azure Cosmos DB	Endpoint de URL para a conta de origem.
Nome da conexão	Nome exclusivo para a conexão.
Tipo de autenticação	Selecione Chave da conta ou Conta organizacional.
Chave da conta	Chave de leitura-gravação para a conta de origem.
Conta organizacional	Token de acesso do Microsoft Entra ID.

Observação

Para autenticação do Microsoft Entra ID, 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 de controle de acesso baseado em função do plano de dados.

Para obter um exemplo de um script para aplicar automaticamente uma função de controle de acesso baseada em função personalizada, consulte rbac-cosmos-mirror.sh azure-samples/azure-cli-samples.

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

Iniciar o processo de espelhamento

Selecione Base de dados de espelho. O espelhamento começa agora.
Aguarde dois a cinco minutos. Em seguida, selecione Monitor replication para ver o estado da ação de replicação.
Após alguns minutos, o status deve mudar para Em execução, o que indica que os contêineres estão sendo sincronizados.

Sugestão

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.
Quando o espelhamento conclui a cópia inicial dos contêineres, uma data aparece na coluna última 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 os seus dados estão em funcionamento, há vários cenários de análise disponíveis em todo o Fabric.

Depois que o Fabric Mirroring estiver configurado, você será automaticamente navegado para o painel Status da replicação.
Aqui, monitorize o estado atual da replicação. Para obter mais informações e detalhes sobre os estados de replicação, consulte Replicação de banco de dados espelhado do Monitor Fabric.

Consultar a base de dados de origem do Fabric

Use o portal do Fabric para explorar os dados que já existem na sua conta do Azure Cosmos DB, consultando a sua base de dados do Cosmos DB de origem.

Navegue até o banco de dados espelhado no portal do Fabric.
Selecione Ver 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.
Selecione um contêiner, 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 consomem Unidades de Solicitação (RUs) alocadas na conta.

Analisar a base de dados de destino em espelho

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

Navegue até à base de dados em espelho no portal do Fabric.
Mude do Azure Cosmos DB espelhado para o ponto de extremidade de análise SQL.
Cada contentor na base de dados de origem deve ser representado no ponto final de análise SQL como uma tabela de armazém de dados.
Selecione qualquer tabela, abra o menu de contexto, selecione Nova Consulta SQL e, finalmente, selecione Selecionar Top 100.
A consulta executa e retorna 100 registos 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 como SUM, COUNT, MINou MAX. Junte várias tabelas no data warehouse para executar a consulta entre vários contentores.

Observação

Por exemplo, esta consulta seria executada em vários contentores:

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 sua tabela e das suas colunas. Utilize a sua própria tabela e colunas ao escrever a sua consulta SQL.

Selecione a consulta e, em seguida, selecione Guardar como vista. Dê um nome exclusivo à vista. Você pode aceder a esta vista a qualquer momento a partir do portal do Fabric.
Retorne ao banco de dados espelhado no portal do Fabric.
Selecione Nova consulta visual. Utilize o editor de consultas para criar consultas complexas.

Crie relatórios de BI nas consultas ou vistas SQL

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.
Edite os gráficos conforme necessário e guarde o relatório.

Sugestão

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 aceder e consultar dados espelhados do Azure Cosmos DB no Fabric:

Comentários

Esta página foi útil?

Última atualização a 2026-10-08