Tutorial: Consultar uma base de dados espelhada do Microsoft Fabric a partir do Cosmos DB no Microsoft Fabric

Neste tutorial, irás consultar um banco de dados espelhado de Fabric a partir de um Cosmos DB existente. Você aprende a habilitar o espelhamento em seu banco de dados, verificar o status do espelhamento e, em seguida, usar os dados de origem e espelhados para análise.

Pré-requisitos

• Uma capacidade de malha existente

  • Se não tiver capacidade de Fabric, começa uma avaliação do Fabric.

• Um banco de dados existente do Cosmos DB na plataforma Fabric

  • Se você ainda não tiver um, crie um novo banco de dados do Cosmos DB no Fabric.

Configurar seu Cosmos DB no banco de dados Fabric

Primeiro, verifique se o banco de dados do Cosmos DB in Fabric está configurado corretamente e contém dados para espelhamento.

1. Abra o portal do Fabric (https://app.fabric.microsoft.com).

2. Navegue até o banco de dados existente do Cosmos DB.

   Importante

   Para este tutorial, o banco de dados existente do Cosmos DB deve ter o conjunto de dados de exemplo já carregado. As etapas restantes neste tutorial pressupõem que você esteja usando o mesmo conjunto de dados para esse banco de dados.

3. Verifique se o banco de dados contém pelo menos um contêiner com dados. Faça essa verificação expandindo o contêiner no painel de navegação e observando se os itens existem.

4. Na barra de menus, selecione Configurações para acessar a configuração do banco de dados.

5. Na caixa de diálogo Configurações , navegue até a seção Espelhamento para verificar se o espelhamento está habilitado para esse banco de dados.

   Observação

   O espelhamento é ativado automaticamente para todos os bancos de dados do Cosmos DB no Fabric. Esse recurso não requer nenhuma configuração extra e garante que seus dados estejam sempre prontos para análise no OneLake.

Conectar-se ao banco de dados de origem

Em seguida, confirme se você pode se conectar e consultar o banco de dados do Cosmos DB de origem diretamente.

1. Navegue de volta para o banco de dados existente do Cosmos DB no portal do Fabric.

2. Selecione e expanda seu contêiner existente para exibir seu conteúdo.

3. Selecione Itens para procurar os dados diretamente no banco de dados.

4. Verifique se você pode ver os itens em seu contêiner. Por exemplo, se estiver usando o conjunto de dados de exemplo, você verá itens com propriedades como name, categorye countryOfOrigin.

5. Selecione Nova consulta no menu para abrir o editor de consultas NoSQL.

6. Execute uma consulta de teste para verificar a conectividade e a disponibilidade de dados:

   SELECT COUNT(1) AS itemCount FROM container
   

   Essa consulta deve retornar o número total de itens em seu contêiner.

Conectar-se ao banco de dados espelhado

Agora aceda à versão espelhada do seu banco de dados através do endpoint de análise SQL para consultar os mesmos dados utilizando T-SQL.

1. Na barra de menus, selecione a lista do Cosmos DB e depois escolha o endpoint de análise SQL para alternar para a vista espelhada do banco de dados.

2. Verifique se o seu contentor aparece como uma tabela no endpoint de análises SQL. A tabela deve ter o mesmo nome do seu contêiner.

3. Selecione Nova consulta SQL no menu para abrir o editor de consultas T-SQL.

4. Execute uma consulta de teste para verificar se o espelhamento está funcionando corretamente:

   SELECT COUNT(*) AS itemCount FROM [dbo].[SampleData]
   

   Observação

   Substitua [SampleData] pelo nome do contêiner se você não estiver usando o conjunto de dados de exemplo.

5. A consulta deve retornar a mesma contagem que sua consulta NoSQL, confirmando que o espelhamento está replicando seus dados com êxito.

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.

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

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

   

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

Conteúdo relacionado

• Saiba mais sobre o Cosmos DB no Microsoft Fabric
• Espelhar o OneLake no banco de dados do Cosmos DB no Microsoft Fabric
• Aceder aos dados espelhados no Cosmos DB, através do Lakehouse no Microsoft Fabric
• Consultar dados entre bancos de dados no Cosmos DB no Microsoft Fabric