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

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

Pré-requisitos

Dica

Durante a versão prévia 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 do Fabric.

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

  2. Certifique-se de que o backup contínuo esteja habilitado. 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 saber mais, confira limitações de bancos de dados e contas.

  3. Verifique se as opções de rede estão definidas como acesso à rede pública em 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é o início do portal do Fabric.

  2. Abrir um workspace existente ou criar um novo.

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

  4. Selecione Criar, localize a seção Data Warehouse e selecione Azure Cosmos DB Espelhado (Versão prévia).

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

Conectar-se ao bando 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:

    Valor
    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 Chave da conta.
    Chave de Conta Chave de leitura/gravação para a conta de origem.

    Captura de tela da nova caixa de diálogo de conexão com credenciais para uma conta do Azure Cosmos DB para NoSQL.

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

    Observação

    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 nesse momento.

  2. Aguarde de 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.

    Dica

    Se não conseguir localizar 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á-las com segurança e continuar a atualizar.

  4. Quando o espelhamento concluir a cópia inicial dos contêineres, uma data será exibida na coluna última atualização. Se os dados foram 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.

  1. Depois que o Espelhamento do Fabric estiver configurado, você será direcionado automaticamente ao 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 espelho 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 do Cosmos DB de origem.

  1. Navegue até o banco de dados espelhado no portal do Fabric.

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

    Captura de tela do data explorer com uma exibição somente leitura de dados NoSQL na conta do Azure Cosmos DB.

  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.

    Observação

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

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

    Captura de tela do seletor para alternar entre itens no portal do Fabric.

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

  4. Selecione qualquer tabela, abra o menu de contexto, selecione Nova Consulta SQL e, por fim, escolha Selecionar os 100 primeiros.

  5. A consulta é executada 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, MIN ou 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.

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

  8. Retorne ao banco de dados espelhado no portal do Fabric.

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

    Captura de tela do editor de consultas para consultas visuais e baseadas em texto no Fabric.

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

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

Dica

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

Mais exemplos

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