使用 Power BI 將 Azure Cosmos DB 資料視覺化

發行項
03/22/2024

適用於：NoSQL

此文章說明將 Azure Cosmos DB 資料連線至 Power BI Desktop 所需的步驟。

您可以使用下列其中一個選項，從 Power BI 桌面連線到 Azure Cosmos DB：

使用 Azure Synapse Link 建置 Power BI 報告，而不影響您交易式工作負載的效能或成本，也不會影響任何 ETL 管線。

您可以使用 DirectQuery 或匯入模式。運用 DirectQuery，您可以使用來自 Azure Cosmos DB 帳戶的即時資料來建置儀表板/報告，而不需要將資料匯入或複製至 Power BI。
透過適用於 Power BI 的 Azure Cosmos DB 連接器將 Power BI Desktop 連線至 Azure Cosmos DB 帳戶。此選項僅適用於匯入模式，並且會取用配置給交易式工作負載的 RU。

注意

在 Power BI Desktop 中建立的報表可以發佈至 PowerBI.com。您無法從 PowerBI.com 直接擷取 Azure Cosmos DB 資料。

必要條件

在依照本 Power BI 教學課程中的指示進行之前，請先確定您可以存取下列資源：

下載最新版的 Power BI Desktop。
建立 Azure Cosmos DB 資料庫帳戶，並將資料新增至您的 Azure Cosmos DB 容器。

若要在 PowerBI.com 上共用您的報告，您必須有 PowerBI.com 中的帳戶。若要深入了解 Power BI 和 Power BI Pro，請參閱 https://powerbi.microsoft.com/pricing (英文)。

現在就開始吧

使用 Azure Synapse Link 來建置 BI 報告

您只要按幾下滑鼠，即可使用 Azure Cosmos DB 入口網站在現有的 Azure Cosmos DB 容器上啟用 Azure Synapse Link，並在此資料上建置 BI 報告。 Power BI 會使用直接查詢模式連線至 Azure Cosmos DB，讓您能夠查詢即時 Azure Cosmos DB 資料，而不會影響您的交易式工作負載。

若要建置 Power BI 報告/儀表板：

登入 Azure 入口網站並瀏覽至 Azure Cosmos DB 帳戶。
從 [整合] 區段中，開啟 [Power BI] 窗格，然後選取 [開始使用]。

注意

目前，此選項僅適用於 API for NoSQL 帳戶。您可以直接在 Synapse 無伺服器 SQL 集區中建立 T-SQL 檢視，並建置適用於 MongoDB 的 Azure Cosmos DB 的 BI 儀表板。如需詳細資訊，請參閱「運用 Synapse，使用 Power BI 和無伺服器 Synapse SQL 集區來分析 Azure Cosmos DB 資料」。
從 [啟用 Azure Synapse Link] 索引標籤中，您可以從 [為此帳戶啟用 Azure Synapse Link] 區段中啟用帳戶上的 Synapse Link。如果您的帳戶已啟用 Synapse Link，則您看不到此索引標籤。此步驟是開始在您的容器上啟用 Synapse Link 的必要條件。

注意

啟用 Azure Synapse Link 會影響成本。如需詳細資料，請參閱 Azure Synapse Link 定價小節。
接著，從 [為您的容器啟用 Azure Synapse Link] 區段中，選擇啟用 Synapse Link 所需的容器。
- 如果您已在某些容器上啟用 Synapse Link，則會看到已選取容器名稱旁邊的核取方塊。您可以根據您想要在 Power BI 中視覺化的資料，選擇性地將其取消選取。
- 如果未啟用 Synapse Link，您可以在現有的容器上啟用此功能。
  
  如果正在任何容器上啟用 Synapse Link，則不會包括這些容器中的資料。您稍後應該回到此索引標籤，並在啟用容器時匯入資料。
根據您容器中的資料量，可能需要一段時間才能啟用 Synapse Link。若要深入了解，請參閱在現有容器上啟用 Synapse Link 文章。

您可以在入口網站中檢查進度，如下列畫面所示。 進度達到 100% 時，會為容器啟用 Synapse Link。
從 [選取工作區] 索引標籤中，選擇 [Azure Synapse Analytics] 工作區，然後選取 [下一步]。此步驟會針對稍早選取的容器，在 Synapse Analytics 中自動建立 T-SQL 檢視。如需將 Azure Cosmos DB 連線至 Power BI 時所需 T-SQL 檢視的詳細資訊，請參閱準備檢視文章。

注意

您的 Azure Cosmos DB 容器屬性將會在 T-SQL 檢視中以資料行表示，包括深層巢狀 JSON 資料。這是 BI 儀表板的快速入門。這些檢視將可在 Synapse 工作區/資料庫中使用；您也可以在 Synapse 工作區中使用這些完全相同的檢視，以進行資料探索、資料科學、資料工程等。請注意，進階案例可能需要更複雜的檢視或這些檢視的微調，以提升效能。如需詳細資訊，請參閱使用 Synapse 無伺服器 SQL 集區時，Synapse Link 的最佳做法一文。
您可以選擇現有工作區，或建立新的工作區。若要選取現有工作區，請提供 [訂用帳戶]、[工作區] 和 [資料庫] 詳細資料。 Azure 入口網站將會使用您的 Microsoft Entra 認證自動連線至您的 Synapse 工作區，並建立 T-SQL 檢視。請確定您具有此工作區的 [Synapse 管理員] 權限。
接下來，選取 [下載 .pbid] 以下載 Power BI 資料來源檔案。開啟下載的檔案。其包含所需的連線資訊，並且會開啟 Power BI 桌面。
您現在可以從 Power BI 桌面連線至 Azure Cosmos DB 資料。會顯示對應至每個容器中資料的 T-SQL 檢視清單。

例如，下列畫面顯示車隊資料。您可以載入此資料以進行進一步分析，或在載入前進行轉換。
您現在可以使用 Azure Cosmos DB 的分析資料來開始建置報告。只要將資料複寫至分析存放區 (通常會在幾分鐘內發生)，就會將資料的任何變更反映在報告中。

使用 Power BI 連接器來建置 BI 報告

注意

目前僅支援 Azure Cosmos DB for NoSQL 和 API for Gremlin 帳戶的 Azure Cosmos DB 與 Power BI 連接器連線。

執行 Power BI Desktop。
您可以 [取得資料]、檢視 [最近使用的來源]，或直接從歡迎畫面 [開啟其他報表]。選取右上角的 [X]，即可關閉畫面。 Power BI Desktop 的 [報告] 檢視隨即顯示。
選取 [首頁] 功能區，然後按一下 [取得資料]。此時應會出現 [取得資料] 視窗。
按一下 [Azure]、選取 [Azure Cosmos DB (搶鮮版 (Beta))]，然後按一下 [連線]。
在 [預覽版連接器] 頁面上，按一下 [繼續]。 [Azure Cosmos DB] 視窗隨即出現。
依照下列所示方式指定您要從中擷取資料的 Azure Cosmos DB 帳戶端點 URL，然後按一下 [確定]。若要使用您的帳戶，可以從 Azure 入口網站 [金鑰] 刀鋒視窗的 [URI] 方塊中擷取 URL。您可以視需要提供資料庫名稱、集合名稱，或使用導覽器來選取資料庫和集合，以識別資料的來源。
如果是第一次連接到此端點，系統會提示您提供帳戶金鑰。如果是您自己的帳戶，請從 Azure 入口網站 [唯讀金鑰] 刀鋒視窗的 [主要金鑰] 方塊中擷取金鑰。輸入適當的金鑰，然後按一下 [連接]。

建議您在建置報告時使用唯讀金鑰。這樣可避免不必要地將主要金鑰暴露於潛在的安全性風險下。您可以從 Azure 入口網站的 [金鑰] 刀鋒視窗取得唯讀金鑰。
順利連接帳戶後，會出現 [瀏覽器] 窗格。 [瀏覽器] 會顯示帳戶下的資料庫清單。
按一下並展開報告資料來源的資料庫。現在，選取要從中擷取資料的集合。

[預覽] 窗格會顯示 [記錄] 項目的清單。一份文件會顯示為 Power BI 中的 [記錄] 類型。同樣地，文件內的巢狀 JSON 區塊也是 [記錄] 。若要以資料行檢視屬性文件，請按一下具有 2 相反方向箭頭的灰色按鈕，該相反箭頭象徵展開資料列。該按鈕位於容器名稱右邊的相同預覽窗格中。
[Power BI Desktop 報告] 檢視可做為您開始建立報告以視覺化資料的起始點。您可以將欄位拖放到 [報告] 畫布上，以建立報告。
有兩種方式可以重新整理資料：臨機操作和排程。只要按一下 [立即重新整理] 即可重新整理資料。如需排程重新整理選項的詳細資訊，請參閱 Power BI 文件。

下一步

若要深入了解 Power BI，請參閱開始使用 Power BI。
若要深入了解 Azure Cosmos DB，請參閱 Azure Cosmos DB 文件登陸頁面。

共用方式為