共用方式為

快速入門：使用 Azure 入口網站建立 Azure DocumentDB 叢集

在這個快速入門中，你會建立一個新的 Azure DocumentDB 叢集。 這個叢集包含所有典型的 MongoDB 資源：資料庫、集合和文件。 叢集提供獨特的端點，讓各種工具與驅動程式連接 Azure DocumentDB 並執行日常操作。

先決條件

  • Azure 訂用帳戶

    • 如果您沒有 Azure 訂用帳戶，請建立 免費帳戶

建立叢集

要開始，你首先需要建立一個 Azure DocumentDB 叢集，作為儲存和管理 NoSQL 資料的基礎。

  1. 登入 Azure 入口網站 （https://portal.azure.com）。

  2. 從 Azure 入口網站功能表或 [首頁] 頁面，選取 [建立資源]。

  3. 在 新頁面 搜尋並選擇 Azure DocumentDB。

    搜尋 Azure DocumentDB 的截圖。

  4. 在「建立 Azure DocumentDB 叢集」頁面及「基礎」區塊中，選擇叢集層級區塊中的「配置」選項。

    顯示「配置叢集」選項的截圖。

  5. 在 縮放 頁面中，設定這些選項，然後選擇 儲存 ，將你的變更永久化到叢集層級。

    價值觀
    叢集層 M30 tier, 2 vCore, 8-GiB RAM
    每個分區的儲存體 128 GiB

    新 Azure DocumentDB 叢集的運算與儲存設定選項截圖。

  6. 回到 基礎 部分，設定以下選項：

    價值觀
    Subscription 選取您的 Azure 訂用帳戶
    資源群組 建立新的資源群組，或選取現有的資源群組
    叢集名稱 提供全域唯一名稱
    地點 為您的訂用帳戶選取支援的 Azure 區域
    MongoDB 版本 選取 8.0
    系統管理員使用者名稱 建立使用者名稱以以使用者管理員身份存取叢集
    密碼 使用與使用者名稱相關的獨特密碼

    顯示叢集參數的截圖。

    小提示

    記錄你用來輸入 使用者名稱 和 密碼的數值。 這些數值會在本指南後面使用。 關於有效數值的更多資訊，請參見 叢集限制。

  7. 請選取「下一步：網路」。

  8. 在網路標籤的防火牆規則區塊中，設定以下選項：

    價值觀
    連線方法 Public access
    允許從 Azure 內的服務和資源對此叢集進行公開存取 Enabled

  9. 為你目前的客戶端裝置新增防火牆規則，透過選擇 + 新增目前的客戶端 IP 位址來授權存取叢集。

    網路設定的截圖。

    小提示

    在許多公司環境中，開發人員機器 IP 位址會因為 VPN 或其他公司網路設定而遭到隱藏。 在這種情況下，你可以透過新增一個包含 0.0.0.0 - 255.255.255.255 的 IP 位址範圍至防火牆規則中，來暫時允許所有 IP 位址的存取。 此防火牆規則僅暫時用於連線測試與開發。

  10. 選擇 檢閱 + 創建。

  11. 檢閱您提供的設定，然後選取 建立。 建立叢集需要幾分鐘的時間。 等待資源部署完成。

  12. 最後，選擇 「前往資源 」以導航至入口網站中的 Azure DocumentDB 叢集。

螢幕擷取畫面顯示 [移至資源] 選項。

取得叢集認證

取得你用來連接叢集的憑證。

  1. 在叢集頁面，選擇資源選單中的 連線字串 選項。

  2. 在 Connection 字串 區塊，複製或記錄 Connection 字串 欄位的值。

有張顯示連線字串選項的截圖。

這很重要

入口網站中的連接字串不包含密碼值。 您必須將 <password> 佔位符替換為建立叢集時輸入的憑證，或以互動方式輸入密碼。

從快速入門使用 MongoDB 殼層連線

若要直接使用 MongoDB Shell 連接 Azure DocumentDB，請使用 Azure 入口網站資源頁面上的快速啟動體驗。

  1. 在叢集資源頁面中，從導覽功能表中選取 [ 快速入門 （預覽版）] 。

  2. 接著，選擇 Open MongoDB shell。

  3. 等待 MongoDB Shell 環境啟動。

  4. 環境準備就緒後，輸入 Y 以接受通知。

    備註

    如果您在接受通知之後，使用 MongoDB Shell 連線時遇到問題，請確定 Azure Cloud Shell 可以存取您的叢集。

  5. 現在，輸入您的密碼以將叢集連線至 Cloud Shell。

執行測試查詢

執行一系列測試命令和查詢，確認您已成功連線至叢集。

  1. 請執行 connectionStatus 命令以檢查您的連線狀態。

    db.runCommand({connectionStatus: 1})

    {
  ...
  ok: 1
}

  2. 列出叢集中的資料庫。

    show dbs

  3. 切換至特定資料庫。 請將 <database-name> 預留位置替換為您叢集中的任何資料庫名稱。

    use <database-name>

    小提示

    例如，如果資料庫名稱是 inventory，則指令會是 use inventory。

  4. 列出資料庫內的集合。

    show collections

  5. 尋找特定集合中的前五個項目。 將<collection-name>占位符替換為叢集中任何集合的名稱。

    db.<collection-name>.find().limit(5)

    小提示

    例如，如果集合名稱是 equipment，則指令會是 db.equipment.find().limit(5)。

清理資源

完成 Azure DocumentDB 叢集後，你可以刪除你建立的 Azure 資源，避免額外收費。

  1. 在 Azure 入口網站的搜尋列中，搜尋並選取 [資源群組]。

    截圖顯示搜尋資源群組的選項。

  2. 在清單中，選取您在此快速入門中使用的資源群組。

    顯示資源群組的截圖。

  3. 在 [資源群組] 頁面中，選取 [刪除資源群組]。

  4. 在刪除確認對話方塊中，輸入資源群組的名稱，以確認您要將其刪除。 最後，選取 [刪除] 以永久刪除資源群組。

    截圖顯示刪除資源群組確認按鈕。

相關內容

  • Last updated on