快速入門導覽課程

本頁面說明如何在 Cloud Firestore (Datastore 模式) 中使用 Google Cloud Platform 主控台儲存和查詢資料。

事前準備

  • 登入您的 Google 帳戶。

    如果您沒有帳戶,請申請新帳戶

  • 選取或建立 Google Cloud Platform 專案。

    前往「Manage resources」(管理資源) 頁面

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

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

建立資料庫

如要建立新的資料庫執行個體,請開啟 Google Cloud Platform 主控台中的 Cloud Datastore 部分:
前往 Cloud Datastore 頁面

Cloud Firestore:原生模式或 Datastore 模式

當您建立新的 Cloud Firestore 資料庫時,可以選擇使用原生模式或 Datastore 模式的 Cloud Firestore。

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

  • Cloud Firestore (原生模式)

    Cloud Firestore (原生模式) 適用於行動和網頁應用程式。如要開始使用 Cloud Firestore,請繼續參閱 Cloud Firestore 快速入門導覽課程

  • Cloud Firestore (Datastore 模式)

    Cloud Firestore (Datastore 模式) 適用於新的伺服器專案。選擇 Cloud Firestore (Datastore 模式) 可一邊維持 Datastore 模式的系統行為,一邊使用改良後的 Cloud Firestore 儲存層。

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

儲存資料

  1. 前往 Google Cloud Platform 主控台的「Datastore Entities page」(Datastore 實體) 頁面。
    前往 Datastore 實體頁面
    本頁面可讓您儲存、查詢、更新及刪除資料。
  2. 按下 [Create entity] (建立實體)
  3. 如果您看到以下畫面,您需要先選取一個地點。(如果您沒有看到此頁面,請跳過進行下一個動作)

    Screenshot of the Select a location page

    位置會同時套用到您 Google Cloud Platform 專案的 Datastore 模式資料庫和 App Engine 應用程式。
    如要儲存位置,請選擇其中一個位置值並點選 [Next] (下一步)

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

  5. 在「Kind」(種類) 項目輸入 Task

  6. 在「Properties」(屬性) 項目,使用「Add property」(新增屬性) 按鈕新增以下這些屬性:

    姓名 類型 已編入索引
    description 字串 瞭解 Google Datastore 模式
    created (建立時間) 日期與時間 (今天的日期)
    done 布林值
    您建立的頁面看起來應如下圖所示:

    Screenshot of the entity creation window with properties set

  7. 按一下 [Create] (建立),控制台將會顯示出您剛建立的 Task 實體。

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

執行查詢

Datastore 模式資料庫可支援依種類或依 Google Query Language (GQL) 查詢資料,以下將逐步說明兩種查詢方式的步驟。

執行種類查詢

  1. 按一下 [Query by kind] (種類查詢) 按鈕
  2. 在「kind」(種類) 選擇 Task

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

接著為您的查詢結果新增查詢篩選條件,以滿足特定條件。

  1. 按一下 [Filter entities] (篩選實體) 按鈕。
  2. 在下拉式選單選擇 done[is a boolean] (為布林值)、[that is false] (是 false)。
  3. 按一下 [Apply filters] (套用篩選器)。由於該 done 的值為 false,查詢結果將顯示出您建立的 Task 實體。 Screenshot of a kind query with a filter applied
  4. 現在嘗試在選擇了 done[is a boolean] (為布林值)、[that is false] (是 false) 的狀態下執行查詢。由於其 done 的值並非 true,該查詢結果將不會不包含您建立的 Task 實體。

執行 GQL 查詢

  1. 按一下 [Query by GQL] (依照 GQL 查詢)
  2. 輸入 SELECT * FROM Task 執行查詢。請注意,Task 需區分大小寫。
  3. 按一下 [Run query] (執行查詢)

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

您需要再度為您的查詢結果增加查詢篩選條件,以滿足特定條件。

  1. 執行查詢 SQL 如 SELECT * FROM Task WHERE done=false。請注意 Taskdone 都需要區分大小寫。由於其 done 的值為 false,該查詢結果將會包含您建立的 Task 實體。 Screenshot of a GQL query with a filter applied
  2. 執行查詢 SQL,例如 SELECT * FROM Task WHERE done=true。由於其 done 的值並非 true,該查詢結果將不會包含您建立的 Task 實體。

清除

  1. 按一下 [Query by kind] (依種類查詢) 按鈕,確認已選擇 Task 種類。
  2. 按一下 [Clear filters] (清除篩選條件)
  3. 選擇您所建立的 Task 實體。
  4. 按一下 [Delete] (刪除),並確認您確實要刪除 Task 實體。刪除後,實體就會從資料庫中永久移除。

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

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Datastore 說明文件