MongoDB Atlas SQL 介面
注意
下列連接器文章是由 MongoDB 提供，此連接器的擁有者，以及 Microsoft Power Query 連線 or 認證計劃的成員。 如果您有關於本文內容或想要看到本文變更的問題，請流覽 MongoDB 網站並使用該處的支援通道。
摘要
| 項目 | 說明 |
|---|---|
| 發行狀態 | Beta |
| 產品 | Power BI （語意模型） Power BI （數據流） 網狀架構 （資料流 Gen2） |
| 支援的驗證類型 | 資料庫 （使用者名稱/密碼） |
必要條件
若要使用 MongoDB Atlas SQL 連接器，您必須設定 Atlas 同盟資料庫 。
取得同盟資料庫實例的連線資訊
- 流覽至您的同盟資料庫實例。 在 Atlas 中，從左側導覽面板中選取 [資料同盟 ]。
- 選取 [連線]，以開啟同盟資料庫實例連線模式。
- 使用 Atlas SQL 介面選取 連線。
- 選取 [Power BI 連線 or]。
- 複製您的同盟資料庫名稱和 MongoDB URI。 您將在稍後的步驟中用到它們。
注意
如果部分或所有數據都來自 Atlas 叢集，您必須使用該叢集使用 MongoDB 5.0 版或更新版本，才能利用 Atlas SQL。
我們也建議您先安裝 MongoDB Atlas SQL ODBC Driver，再使用 MongoDB Atlas SQL 連接器。
支援的功能
- Import
使用 Power Query Desktop 的 Atlas SQL 介面，連線 至 MongoDB Atlas 同盟資料庫
若要使用 Atlas SQL 介面進行連線：
從 Power BI Desktop 的 [首頁] 功能區選取 [取得數據]。
從左側的類別選取 [資料庫]，選取 [MongoDB Atlas SQL]，然後選取 [連線]。
如果您第一次連線到 MongoDB Atlas SQL 連接器，則會顯示第三方通知。 如果您不想再次顯示此訊息，請選取 [不要再使用此連接器 警告我]。
選取繼續。
在出現的 [MongoDB Atlas SQL] 視窗中，填入下列值：
- MongoDB URI。 必要。 使用必要條件中取得的 MongoDB URI。 請確定它不包含您的使用者名稱和密碼。 包含用戶名稱和/或密碼的 URI 遭到拒絕。
- 您的同盟 資料庫 名稱。 必要
使用必要條件中取得的同盟資料庫名稱。
選取 [確定]。
輸入您的 Atlas MongoDB 資料庫存取使用者名稱和密碼，然後選取 [連線]。
注意
輸入特定 Atlas 同盟資料庫的使用者名稱和密碼之後，Power BI Desktop 會在後續的連線嘗試中使用這些相同的認證。 您可以移至 [檔案>選項] 和 [>資料源設定] 來修改這些認證。
在 [導覽器] 中，選取一或多個要匯入和使用於 Power BI Desktop 的專案。 然後選取 [載入] 以載入 Power BI Desktop 中的數據表，或選取 [轉換數據] 以開啟 Power Query 編輯器，您可以在其中篩選和精簡您想要使用的數據集，然後將該精簡數據集載入 Power BI Desktop。
使用 Power Query Online 的 Atlas SQL 介面，連線 至 MongoDB Atlas 同盟資料庫
若要使用 Atlas SQL 介面進行連線：
從 Power Query - 選擇數據源頁面，選取 [MongoDB Atlas SQL]。
在 [連線 ion 設定] 頁面上，填入下列值：
- MongoDB URI。 必要。 使用必要條件中取得的 MongoDB URI。 請確定它不包含您的使用者名稱和密碼。 包含用戶名稱和/或密碼的 URI 遭到拒絕。
- 您的同盟 資料庫 名稱。 必要
使用必要條件中取得的同盟資料庫名稱。 - 輸入 連線 名稱。
- 選擇數據閘道。
- 輸入您的 Atlas MongoDB 資料庫存取使用者名稱和密碼，然後選取 [ 下一步]。
在 [ 導覽器 ] 畫面中，選取您需要的數據，然後選取 [ 轉換數據]。 此選取項目會開啟 Power Query 編輯器，以便篩選並精簡要使用的數據集。
疑難排解
無法成功建立連線時，會顯示一般錯誤訊息 The driver returned invalid (or failed to return) SQL_DRIVER_ODBC_VER: 03.80 。 從檢查您的認證開始，而且您沒有存取同盟資料庫的網路問題。
下一步
您可能也會發現下列資訊很有用：