將 MongoDB 應用程式 連線 至 Azure Cosmos DB

適用於: MongoDB

了解如何使用 MongoDB 連接字串,將 MongoDB 應用程式連線至 Azure Cosmos DB。 您可以使用 Azure Cosmos DB 資料庫作為 MongoDB 應用程式的資料存放區。

本教學課程提供兩種方式來擷取連接字串資訊︰

必要條件

需要兩個專案

使用快速入門取得 MongoDB 連接字串

執行以下步驟:

  1. 在網際網路瀏覽器中,登入 Azure 入口網站

  2. 在 [Azure Cosmos DB] 窗格中,選取 API。

  3. 在帳戶窗格的左窗格中,選取 [快速入門]

  4. 選擇您的平台 (.NETNode.jsMongoDB 殼層JavaPython)。 如果您沒有看到您的驅動程式或工具被列出,別擔心,我們會持續加入更多連線程式碼片段。 歡迎留言發表您希望新增的內容。 若要了解如何製作您自己的連線,請閱讀取得帳戶的連接字串資訊

  5. 將程式碼片段複製和貼上您的 MongoDB 應用程式。

取得要自定義的 MongoDB 連接字串

執行以下步驟:

  1. 在網際網路瀏覽器中,登入 Azure 入口網站

  2. 在 [Azure Cosmos DB] 窗格中,選取 API。

  3. 在帳戶窗格的左窗格中,選取 [連接字串]

  4. [連接字串] 窗格隨即開啟。 其中包含使用 MongoDB 適用的驅動程式連線至帳戶所需的所有資訊,包括預先建構的連接字串。

    連接字串需求

    重要

    Azure Cosmos DB 有嚴格的安全性需求和標準。 Azure Cosmos DB 帳戶需要透過 TLS 進行驗證和安全通訊。

    Azure Cosmos DB 支援標準 MongoDB 連接字串 URI 格式,另有幾項特定需求︰Azure Cosmos DB 帳戶需要透過 TLS 進行驗證和安全通訊。 連接字串格式為:

    mongodb://username:password@host:port/[database]?ssl=true

    此字串的值如下:

    • 使用者名稱 (必要):Azure Cosmos DB 帳戶名稱。
    • 密碼 (必要):Azure Cosmos DB 帳戶密碼。
    • 主機 (必要):Azure Cosmos DB 帳戶的 FQDN。
    • 連接埠 (必要):10255。
    • 資料庫 (選用):連線所使用的資料庫。 如果未提供資料庫,則預設資料庫是 "test"。
    • ssl=true (必要)。

    例如,請考慮 [連接字串] 窗格中顯示的帳戶。 有效的連接字串為:

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    驅動程式需求

    所有支援有線通訊協定 3.4 版或更新版本的驅動程式都支援 Azure Cosmos DB for MongoDB。

    • 用戶端驅動程式必須支援服務名稱識別 (SNI) TLS 延伸模組和/或 appName 連接字串 選項。
    • 如果提供 appName 參數,則找到的值必須加進 Azure 入口網站中的連接字串值。