Tutorial: Consultar o banco de dados espelhado do Microsoft Fabric a partir do Cosmos DB no ambiente do Microsoft Fabric

Neste tutorial, você consulta um banco de dados espelhado do Fabric de um Banco de Dados Cosmos DB existente no banco de dados do Fabric. Você aprenderá a habilitar o espelhamento em seu banco de dados, verificar o status de espelhamento e, em seguida, usar os dados de origem e espelhados para análise.

Pré-requisitos

• Uma capacidade existente do Fabric

  • Se você não tiver capacidade do Fabric, comece um teste do Fabric.

• Um banco de dados do Cosmos DB existente no Fabric

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

Configurar o Cosmos DB no banco de dados do Fabric

Primeiro, verifique se o banco de dados do Cosmos DB no 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 do Cosmos DB existente.

   Importante

   Para este tutorial, o banco de dados do Cosmos DB existente 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 que 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 é habilitado 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 diretamente o banco de dados cosmos DB de origem.

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

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

3. Selecione Itens para navegar 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ê deverá 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, acesse a versão espelhada do seu banco de dados através do endpoint de análise SQL e consulte os mesmos dados usando T-SQL.

1. Na barra de menus, selecione a lista do Cosmos DB e, em seguida, selecione o endpoint de análise SQL para mudar para a visualização de banco de dados espelhado.

2. Verifique se o contêiner aparece como uma tabela no endpoint de análise SQL. A tabela deve ter o mesmo nome que o 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 a 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 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.

   

3. Selecione um contêiner e, em seguida, 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 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.

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.

   

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 e selecione Nova Consulta SQL e, por fim, selecione Top 100.

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 usa agregações comoSUM, , COUNTMINou 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ê ao modo de exibição um nome exclusivo. 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.

   

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). Essa ação explora a consulta no Power BI diretamente usando dados espelhados do Direct Lake no 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
• Acessar dados espelhados do Cosmos DB do Lakehouse no Microsoft Fabric
• Consultar dados entre bancos de dados no Cosmos DB no Microsoft Fabric