Tutoriel : Interroger une base de données mise en miroir Microsoft Fabric à partir de Cosmos DB dans Microsoft Fabric

Dans ce tutoriel, vous interrogez une base de données mise en miroir Fabric à partir d’une base de données Cosmos DB existante dans la base de données Fabric. Vous allez apprendre à activer la mise en miroir sur votre base de données, à vérifier l’état de mise en miroir, puis à utiliser les données sources et mises en miroir pour l’analytique.

Prerequisites

• Capacité de Fabric existante

  • Si vous n’avez pas de capacité Fabric, démarrez un essai Fabric.

• Base de données Cosmos DB existante dans Fabric

  • Si vous n’en avez pas déjà, créez une base de données Cosmos DB dans Fabric.

Configurer votre base de données Cosmos DB dans Fabric

Tout d’abord, vérifiez que votre base de données Cosmos DB dans Fabric est correctement configuré et contient des données pour la mise en miroir.

1. Ouvrez le portail Fabric (https://app.fabric.microsoft.com).

2. Accédez à votre base de données Cosmos DB existante.

   Important

   Pour ce tutoriel, la base de données Cosmos DB existante doit avoir l’exemple de jeu de données déjà chargé. Les étapes restantes de ce tutoriel supposent que vous utilisez le même jeu de données pour cette base de données.

3. Vérifiez que votre base de données contient au moins un conteneur avec des données. Effectuez cette vérification en développant le conteneur dans le volet de navigation et en observant que les éléments existent.

4. Dans la barre de menus, sélectionnez Paramètres pour accéder à la configuration de la base de données.

5. Dans la boîte de dialogue Paramètres , accédez à la section Mise en miroir pour vérifier que la mise en miroir est activée pour cette base de données.

   Note

   La mise en miroir est automatiquement activée pour toutes les bases de données Cosmos DB dans Fabric. Cette fonctionnalité ne nécessite aucune configuration supplémentaire et garantit que vos données sont toujours prêtes pour l’analytique dans OneLake.

Se connecter à la base de données source

Ensuite, vérifiez que vous pouvez vous connecter et interroger directement la base de données Cosmos DB source.

1. Revenez à votre base de données Cosmos DB existante dans le portail Fabric.

2. Sélectionnez et développez votre conteneur existant pour afficher son contenu.

3. Sélectionnez Éléments pour parcourir les données directement dans la base de données.

4. Vérifiez que vous pouvez voir les éléments de votre conteneur. Par exemple, si vous utilisez l’exemple de jeu de données, vous devez voir des éléments avec des propriétés telles que name, categoryet countryOfOrigin.

5. Sélectionnez Nouvelle requête dans le menu pour ouvrir l’éditeur de requête NoSQL.

6. Exécutez une requête de test pour vérifier la connectivité et la disponibilité des données :

   SELECT COUNT(1) AS itemCount FROM container
   

   Cette requête doit retourner le nombre total d’éléments dans votre conteneur.

Se connecter à la base de données mise en miroir

À présent, accédez à la version mise en miroir de votre base de données via le point de terminaison d’analytique SQL pour interroger les mêmes données à l’aide de T-SQL.

1. Dans la barre de menus, sélectionnez la liste Cosmos DB , puis sélectionnez point de terminaison d’analytique SQL pour basculer vers la vue de base de données mise en miroir.

2. Vérifiez que votre conteneur apparaît sous la forme d’une table dans le point de terminaison d’analyse SQL. La table doit avoir le même nom que votre conteneur.

3. Sélectionnez Nouvelle requête SQL dans le menu pour ouvrir l’éditeur de requête T-SQL.

4. Exécutez une requête de test pour vérifier que la mise en miroir fonctionne correctement :

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

   Note

   Remplacez [SampleData] par le nom de votre conteneur si vous n’utilisez pas l’exemple de jeu de données.

5. La requête doit retourner le même nombre que votre requête NoSQL, confirmant que la mise en miroir réplique correctement vos données.

Interroger la base de données source à partir de Fabric

Utilisez le portail Fabric pour explorer les données qui existent déjà dans votre compte Azure Cosmos DB, en interrogeant votre base de données Cosmos DB source.

1. Accédez à la base de données mise en miroir dans le portail Fabric.

2. Sélectionnez Affichage, puis base de données source. Cette action ouvre l’Explorateur de données Azure Cosmos DB avec une vue en lecture seule de la base de données source.

   

3. Sélectionnez un conteneur, puis ouvrez le menu contextuel et sélectionnez Nouvelle requête SQL.

4. Exécutez n’importe quelle requête. Par exemple, utilisez SELECT COUNT(1) FROM container pour compter le nombre d’éléments dans le conteneur.

   Note

   Toutes les lectures de la base de données source sont routées vers Azure et consomment des unités de requête allouées sur le compte.

Analyser la base de données mise en miroir cible

À présent, utilisez T-SQL pour interroger vos données NoSQL stockées dans Fabric OneLake.

1. Accédez à la base de données mise en miroir dans le portail Fabric.

2. Passez d’Azure Cosmos DB en miroir au point de terminaison d’analytique SQL.

   

3. Chaque conteneur de la base de données source doit être représenté dans le point de terminaison d’analytique SQL en tant que table d’entrepôt.

4. Sélectionnez n’importe quel tableau, ouvrez le menu contextuel, puis sélectionnez Nouvelle requête SQL, puis sélectionnez Sélectionner le top 100.

5. La requête s’exécute et retourne 100 enregistrements dans la table sélectionnée.

6. Ouvrez le menu contextuel de la même table et sélectionnez Nouvelle requête SQL. Écrivez un exemple de requête qui utilise des agrégats tels que SUM, , COUNTMINou MAX. Joignez plusieurs tables dans l’entrepôt pour exécuter la requête sur plusieurs conteneurs.

   Note

   Par exemple, cette requête s’exécuterait sur plusieurs conteneurs :

   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]
   

   Cet exemple suppose le nom de votre table et de vos colonnes. Utilisez votre propre table et colonnes lors de l’écriture de votre requête SQL.

7. Sélectionnez la requête, puis sélectionnez Enregistrer en tant qu’affichage. Donnez un nom unique à l’affichage. Vous pouvez accéder à cette vue à tout moment à partir du portail Fabric.

8. Revenez à la base de données mise en miroir dans le portail Fabric.

9. Sélectionnez Nouvelle requête visuelle. Utilisez l’éditeur de requête pour générer des requêtes complexes.

   

Créer des rapports BI sur les requêtes ou vues SQL

1. Sélectionnez la requête ou l’affichage, puis sélectionnez Explorer ces données (préversion). Cette action explore la requête dans Power BI directement à l’aide de Direct Lake sur oneLake en miroir.
2. Modifiez les graphiques en fonction des besoins et enregistrez le rapport.

Contenu connexe

• En savoir plus sur Cosmos DB dans Microsoft Fabric
• Mettre en miroir OneLake dans la base de données Cosmos DB dans Microsoft Fabric
• Accéder aux données Cosmos DB mises en miroir à partir de Lakehouse dans Microsoft Fabric
• Interroger des données inter-bases de données dans Cosmos DB dans Microsoft Fabric