教學：在 Microsoft Fabric 中查詢 Cosmos DB 中的 Microsoft Fabric 鏡像資料庫

在本教學課程中，您會從 Fabric 資料庫中的現有 Cosmos DB 查詢 Fabric 鏡像資料庫。 您將瞭解如何在資料庫上啟用鏡像、驗證鏡像狀態，然後同時使用來源和鏡射資料進行分析。

先決條件

• 現有的 Fabric 架構容量

  • 如果您沒有 Fabric 容量，請 啟動 Fabric 試用版。

• Fabric 中現有的 Cosmos DB 資料庫

  • 如果您還沒有，請 在 Fabric 中建立新的 Cosmos DB 資料庫。

在 Fabric 資料庫中配置 Cosmos DB

首先，請確定 Fabric 資料庫中的 Cosmos DB 已正確設定，並包含鏡像的資料。

1. 開啟 Fabric 入口網站 （https://app.fabric.microsoft.com）。

2. 流覽至您現有的 Cosmos DB 資料庫。

   這很重要

   在本教學課程中，現有的 Cosmos DB 資料庫應該已載入 範例資料集 。 本教學課程中的其餘步驟假設您針對此資料庫使用相同的資料集。

3. 確認您的資料庫至少包含一個包含資料的容器。 透過展開導覽窗格中的容器並觀察項目是否存在來執行此驗證。

4. 在功能表列中 ，選取 設定 以存取資料庫組態。

5. 在「 設定 」對話方塊中，導覽至 「鏡像」 區段，以確認此資料庫已啟用鏡像。

   備註

   Fabric 中的所有 Cosmos DB 資料庫都會自動啟用鏡像。 這項功能不需要任何額外的設定，並確保您的資料在 OneLake 中始終可供分析。

連線到來源資料庫

接下來，確認您可以直接連線並查詢來源 Cosmos DB 資料庫。

1. 流覽回 Fabric 入口網站中現有的 Cosmos DB 資料庫。

2. 選取並展開現有的容器以檢視其內容。

3. 選取 [項目] 以直接瀏覽資料庫中的資料。

4. 確認您可以看到容器中的項目。 例如，如果使用範例資料集，您應該會看到具有 、 name和 category等countryOfOrigin屬性的項目。

5. 從功能表中選取 新增查詢 ，以開啟 NoSQL 查詢編輯器。

6. 執行測試查詢以驗證連線能力和資料可用性：

   SELECT COUNT(1) AS itemCount FROM container
   

   此查詢應該會傳回容器中的項目總數。

連線到鏡像資料庫

現在，透過 SQL 分析端點存取資料庫的鏡像版本，以使用 T-SQL 查詢相同的資料。

1. 在功能表列中，選取 [Cosmos DB ] 清單，然後選取 [SQL 分析端點 ] 以切換至鏡像資料庫檢視。

2. 確認您的容器在 SQL 分析端點中顯示為資料表。 資料表的名稱應該與您的容器相同。

3. 從功能表中選取 [ 新增 SQL 查詢 ] 以開啟 T-SQL 查詢編輯器。

4. 執行測試查詢以確認鏡射是否運作正常：

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

   備註

   如果您未使用範例資料集，請取代 [SampleData] 為容器的名稱。

5. 查詢應該傳回與 NoSQL 查詢相同的計數，以確認鏡像正在成功複寫您的資料。

從 Fabric 查詢來源資料庫

使用 Fabric 入口網站來探索 Azure Cosmos DB 帳戶中已存在的資料，並查詢來源 Cosmos DB 資料庫。

1. 流覽至 Fabric 入口網站中的鏡像資料庫。

2. 選取 [ 檢視]，然後選取 [ 來源資料庫]。 此動作會開啟 Azure Cosmos DB 資料總管，其中包含來源資料庫的唯讀檢視。

   

3. 選取容器，然後開啟操作功能表並選取 新增 SQL 查詢。

4. 執行任何查詢。 例如，用於 SELECT COUNT(1) FROM container 計算容器中的項目數量。

   備註

   來源資料庫上的所有讀取都會路由至 Azure，並消耗帳戶上配置的要求單位 (RU)。

分析目標鏡像資料庫

現在，使用 T-SQL 來查詢現在儲存在 Fabric OneLake 中的 NoSQL 資料。

1. 流覽至 Fabric 入口網站中的鏡像資料庫。

2. 從 鏡像 Azure Cosmos DB 切換至 SQL 分析端點。

   

3. 來源資料庫中的每個容器都應該在 SQL 分析端點中表示為倉儲資料表。

4. 選取任何資料表，開啟操作功能表，然後選取 [新增 SQL 查詢]，最後選取 [ 選取前 100 個]。

5. 查詢會執行，並在選取的資料表中傳回 100 筆記錄。

6. 開啟相同資料表的內容功能表，然後選取 [新增 SQL 查詢]。 撰寫使用彙總 （例如 SUM、 COUNT、 MIN或 MAX） 的範例查詢。 聯結倉儲中的多個資料表，以跨多個容器執行查詢。

   備註

   例如，此查詢會跨多個容器執行：

   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]
   

   此範例假設您的資料表和資料行的名稱。 撰寫 SQL 查詢時，請使用您自己的資料表和資料行。

7. 選取查詢，然後選取 [另存為檢視]。 為視圖提供唯一的名稱。 您可以隨時從 Fabric 入口網站存取此檢視。

8. 返回 Fabric 入口網站中的鏡像資料庫。

9. 選取 新增視覺查詢。 使用查詢編輯器來建置複雜的查詢。

   

在 SQL 查詢或檢視上建置 BI 報告

1. 選取查詢或檢視，然後選取 [探索此資料 （預覽版）]。 此動作會直接使用 OneLake 鏡像資料上的 Direct Lake 探索 Power BI 中的查詢。
2. 視需要編輯圖表並儲存報告。

小提示

您也可以選擇使用 Copilot 或其他增強功能來建立儀表板和報表，而無需任何進一步的資料移動。

相關內容

• 在 Microsoft Fabric 中了解 Cosmos DB
• 在 Microsoft Fabric 中的 Cosmos DB 資料庫中實現 OneLake 的鏡像
• 從 Microsoft Fabric 中的 Lakehouse 存取鏡像的 Cosmos DB 資料
• 在 Microsoft Fabric 的 Cosmos DB 中查詢跨資料庫資料