適用於: MongoDB
了解如何使用 MongoDB 連接字串,將 MongoDB 應用程式連線至 Azure Cosmos DB。 您可以使用 Azure Cosmos DB 資料庫作為 MongoDB 應用程式的資料存放區。
本教學課程提供兩種方式來擷取連接字串資訊︰
必要條件
需要兩個專案
Azure 帳戶。 如果您沒有 Azure 帳戶,可以立即建立一個免費的 Azure 帳戶。
Azure Cosmos DB 帳戶。 如需相關指示,請參閱快速入門:適用於 Node.js 的 Azure Cosmos DB for MongoDB 驅動程式。
使用快速入門取得 MongoDB 連接字串
執行以下步驟:
在網際網路瀏覽器中,登入 Azure 入口網站。
在 [Azure Cosmos DB] 窗格中,選取 API。
在帳戶窗格的左窗格中,選取 [快速入門]。
選擇您的平台 (.NET、Node.js、MongoDB 殼層、Java、Python)。 如果您沒有看到您的驅動程式或工具被列出,別擔心,我們會持續加入更多連線程式碼片段。 歡迎留言發表您希望新增的內容。 若要了解如何製作您自己的連線,請閱讀取得帳戶的連接字串資訊。
將程式碼片段複製和貼上您的 MongoDB 應用程式。
取得要自定義的 MongoDB 連接字串
執行以下步驟:
在網際網路瀏覽器中,登入 Azure 入口網站。
在 [Azure Cosmos DB] 窗格中,選取 API。
在帳戶窗格的左窗格中,選取 [連接字串]。
[連接字串] 窗格隨即開啟。 其中包含使用 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 入口網站中的連接字串值。