快速入門導覽課程：建立並連線至資料庫

瞭解如何建立與 MongoDB 相容的 Firestore 資料庫，並使用 mongosh 工具連線至該資料庫。

事前準備

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Cloud Datastore Owner

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      前往「IAM」頁面
    2. 選取專案。
    3. 按一下「授予存取權」。

    4. 在「New principals」(新增主體) 欄位中，輸入您的使用者 ID。 這通常是 Google 帳戶的電子郵件地址。

    5. 在「Select a role」(選取角色) 清單中，選取角色。
    6. 如要授予其他角色，請按一下 「新增其他角色」，然後新增每個其他角色。
    7. 按一下 [Save]。
  5. 安裝 mongosh 工具

    6. 建立與 MongoDB 相容的 Firestore 資料庫，並擷取連線字串

    在 Google Cloud 控制台中，建立新的 Firestore Enterprise 版資料庫。如要使用與 MongoDB 相容的 Firestore，必須使用 Firestore Enterprise 版：

    1. 前往 Google Cloud 控制台的「Databases」頁面。

      前往「資料庫」

    2. 按一下「建立 Firestore 資料庫」。
    3. 輸入資料庫 ID。
    4. 選取 Enterprise 版本。
    5. 選取資料庫位置。

    6. 按一下 [Create Database] (建立資料庫)。

      資料庫完成初始化後，控制台會開啟資料庫的 Firestore Studio。

    7. 在「使用外部 MongoDB 工具連結至 Firestore」部分，複製連線字串。

      連線字串取決於資料庫的 UID (系統產生) 和資料庫位置：

      UID.LOCATION.firestore.goog

    建立 SCRAM 驗證的使用者

    在 Google Cloud 控制台中，建立新的資料庫使用者，並指派使用者身分與存取權管理權限。

    1. 前往 Google Cloud 控制台的「Databases」頁面。

      前往「資料庫」

    2. 從資料庫清單中選取資料庫。
    3. 按一下導覽選單中的「Auth」(驗證)。
    4. 點選「Add User」。
    5. 輸入使用者名稱。
    6. 為使用者選取 Identity and Access Management 角色。
    7. 按一下「建立」。資料庫會建立使用者，並顯示該使用者產生的密碼。複製並儲存這組密碼。您將無法在日後擷取這組密碼。

    使用 mongosh 連線

    使用連線字串、使用者名稱和密碼連線至資料庫，並在本機執行 mongosh，設定選項如下。

    mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'

    更改下列內容：

    • USERNAME：您建立的資料庫使用者名稱。
    • PASSWORD：為您建立的資料庫使用者產生的密碼。
    • CONNECTION_STRING：資料庫連線字串。
    • DATABASE_ID：資料庫 ID

    連線後，您就可以建立及讀取資料，例如：

    db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

    清除所用資源

    如要清除本頁面使用的資源，請刪除資料庫使用者和資料庫。

    刪除資料庫使用者

    刪除資料庫使用者，即可移除使用者和指派的身分與存取權管理權限。

    1. 前往 Google Cloud 控制台的「Databases」頁面。

      前往「資料庫」

    2. 從資料庫清單中選取資料庫。
    3. 按一下導覽選單中的「Auth」(驗證)。
    4. 在要刪除的使用者所屬的「動作」欄中，按一下「動作」。按一下「刪除使用者」。 系統會顯示對話方塊。
    5. 確認刪除並按一下「刪除」。
    6. 對話方塊會顯示 IAM 頁面的連結。按一下連結，刪除指派給資料庫使用者的權限。

    7. 找到包含要撤銷存取權主體的資料列。然後點選該列中的 「編輯主體」。

      您建立的資料庫使用者主體採用下列命名格式：

      principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
    8. 針對要撤銷的角色按一下「刪除」圖示 按鈕，然後按一下「儲存」。

    刪除資料庫

    如要刪除資料庫，請完成下列步驟：

    1. 前往 Google Cloud 控制台的「Databases」頁面。

      前往「資料庫」

    2. 找到要刪除的資料庫，然後按一下「動作」欄中的「查看更多」。按一下「刪除」。系統隨即會顯示對話方塊。

    3. 在「Delete database?」(要刪除資料庫嗎？) 對話方塊中，在文字欄位輸入資料庫 ID，確認要刪除。按一下「刪除」。控制台會通知您作業是否成功。

      如果作業失敗，請查看資料庫詳細資料，並確認刪除保護機制已停用。如要停用防刪除功能，請參閱「更新防刪除設定」。

    後續步驟