在 Datastore 模式的 Firestore 中儲存及查詢資料

在 Datastore 模式的 Firestore 中儲存及查詢資料

本頁說明如何在 Google Cloud 控制台中，透過 Datastore 模式的 Firestore 儲存及查詢資料。

事前準備

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

• 如果您並非專案擁有者，您的帳戶需要以下權限才能完成本快速入門導覽課程：

  • 您的帳戶需要 Datastore 擁有者角色，其中包含建立 Datastore 模式執行個體所需的 datastore.databases.create 權限。
  • Datastore 模式需要有可用的 App Engine 應用程式。 如果專案還沒有應用程式，本快速入門導覽課程會幫您建立一個。在此情況下，您需要 appengine.applications.create 權限。專案擁有者可透過身分與存取權管理 (IAM) 自訂角色指派這個權限。

建立資料庫

1. 如要建立新的資料庫執行個體，請開啟 Google Cloud 控制台中的 Datastore 部分：
   前往 Datastore 頁面

2. 選取資料庫模式。

   建立新的 Firestore 資料庫時，您可以選擇使用原生模式或 Datastore 模式的 Firestore。同一個專案中不能同時使用這兩種模式。

   選擇其中一個資料庫選項：

   • Firestore (原生模式)

     建議用於行動和網頁應用程式。如要開始使用 Firestore，請繼續參閱 Firestore 快速入門導覽課程。

   • Datastore 模式的 Firestore

     建議用於含有後端伺服器的應用程式架構。

   如需選擇資料庫模式和逐項比較各項功能的進一步說明，請參閱選擇原生模式和 Datastore 模式一文。

3. 選取資料庫位置。Datastore 模式支援多區域和單一區域位置。

   多區域位置可盡量提高可用性和耐久性。單一區域位置的寫入延遲時間較短。如要進一步瞭解位置類型，請參閱Datastore 模式位置。位置會同時套用到您 Google Cloud 專案的 Datastore 模式資料庫和 App Engine 應用程式。

   警告： 資料庫建立後，就無法變更位置。

   按一下「建立資料庫」。資料庫初始化完成後，Google Cloud 控制台會將您導向 Datastore 實體頁面。

儲存資料

1. 前往 Google Cloud 控制台中的「Datastore 實體」頁面。

   前往「Entities」(實體) 頁面

   本頁面可讓您儲存、查詢、更新及刪除資料。

2. 按下 [Create entity] (建立實體)。

3. 在「Create an entity」(建立實體) 頁面，於「Namespace」(命名空間) 項目選擇 [default]。

4. 在「Kind」欄位中輸入 Task。沿用「索引鍵 ID」的預設值 Numeric ID (auto-generated)，不需要更改。

5. 在「Properties」(屬性) 項目，使用「Add property」(新增屬性) 按鈕新增以下這些屬性：

   名稱	類型	值	已編入索引
   description	字串	瞭解 Datastore。
   已建立	日期與時間	(今天的日期)	✓
   done	布林值	否	✓

   您建立的頁面看起來應如下圖顯示：

   

6. 按一下「Create」(建立)。控制台會顯示您剛建立的 Task 實體。

您已將資料儲存到資料庫中！

執行查詢

Datastore 模式資料庫可支援依種類或依 Google Query Language (GQL) 查詢資料。以下操作說明將逐步介紹如何使用這兩種方法查詢資料庫。

執行種類查詢

1. 按一下 [Query by kind] (種類查詢) 按鈕。
2. 選取「Task」做為種類。

查詢結果將顯示出您建立的 Task 實體。

接著新增查詢子句，將結果限制在符合特定條件的實體：

1. 按一下「新增查詢子句」。
2. 在下拉式選單中，選取 WHERE、done、==、「boolean」和「false」。
3. 按一下「執行」。由於該 done 的值為 false，查詢結果將顯示出您建立的 Task 實體。
4. 現在將查詢子句變更為 WHERE、done、==、boolean 和 true。按一下「執行」。由於其 done 的值並非 true，該查詢結果將不會包含您建立的 Task 實體。

執行 GQL 查詢

1. 按一下 [Query by GQL] (依照 GQL 查詢)。
2. 輸入 SELECT * FROM Task 做為查詢。請注意，Task 須區分大小寫。
3. 點選「執行查詢」

查詢結果將顯示出您建立的 Task 實體。

提示

GQL 查詢編輯器支援針對種類的自動即時查詢：如您需要輸入一個種類名稱，請按 Ctrl + Space 查看可用種類的列表。列表中最多可顯示 300 個按字母順序排序的種類。如要得到更精確的種類查詢結果，請輸入一個或多個字元。

新增查詢篩選條件，將結果限制為符合特定條件的實體：

1. 執行查詢，例如 SELECT * FROM Task WHERE done=false。請注意，Task 和 done 須區分大小寫。由於該 done 的值為 false，查詢結果將顯示出您建立的 Task 實體。
2. 現在請執行查詢，例如 SELECT * FROM Task WHERE done=true。由於其 done 的值並非 true，該查詢結果將不會包含您建立的 Task 實體。

清除所用資源

1. 按一下「依種類查詢」，確認已選取 Task 種類。
2. 按一下「清除」即可移除所有查詢子句。
3. 選取您建立的 Task 實體。
4. 按一下「Delete」(刪除)，然後確認要刪除 Task 實體。 視瀏覽器視窗大小而定，「刪除」可能位於「更多動作」 選單中。刪除後，實體就會從資料庫中永久移除。

大功告成，您已經完成本快速入門導覽課程！

後續步驟

• 進一步瞭解 Datastore 查詢。
• 進一步瞭解 Datastore 模式資料庫。