在 Datastore 模式 Firestore 中存储和查询数据

本页面介绍如何使用 Google Cloud 控制台在 Datastore 模式 Firestore 中存储和查询数据。

准备工作

  • 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  • In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

    Go to project selector

  • 如果您不是项目所有者,则您的帐号需要以下权限才能完成本快速入门:

    • 您的账号需要具备 Datastore Owner 角色,该角色包含创建 Datastore 模式实例所需的 datastore.databases.create 权限。
    • Datastore 模式需要一个处于活跃状态的 App Engine 应用。如果项目没有应用,则本快速入门会为您创建一个应用。在这种情况下,您需要 appengine.applications.create 权限。项目所有者可以使用 IAM 自定义角色分配此权限。

创建数据库

  1. 如需创建新的数据库实例,请在 Google Cloud 控制台中打开“Datastore”部分:
    转到“Datastore”页面

  2. 选择数据库模式。

    创建新的 Firestore 数据库时,您可以选择原生模式或 Datastore 模式 Firestore。您不能在同一项目中同时使用这两种模式。

    从以下数据库选项中选择一项:

    • 原生模式 Firestore

      建议用于移动应用和 Web 应用。如需开始使用 Firestore,请继续参阅 Firestore 快速入门

    • Datastore 模式 Firestore

      建议用于具有后端服务器的应用架构。

    如需详细了解如何选择数据库模式以及逐个功能的比较情况,请参阅选择原生模式或 Datastore 模式

  3. 选择数据库位置。Datastore 模式支持多区域和单区域位置。

    多区域位置可以最大限度地提高可用性和耐用性。单区域位置可实现较低的写入延迟时间。如需详细了解位置类型,请参阅 Datastore 模式位置。该位置同时适用于 Google Cloud 项目的 Datastore 模式数据库和 App Engine 应用。

    点击创建数据库。数据库完成初始化后,Google Cloud 控制台会将您转到 Datastore 的“实体”页面。

存储数据

  1. 转到 Google Cloud 控制台中的 Datastore 的“实体”页面。

    转到“实体”页面

    您可以在此页面中存储、查询、更新和删除数据。

  2. 点击创建实体

  3. 创建实体页面上,使用 [default] 作为命名空间

  4. Kind 字段中输入 Task。将密钥标识符设置为默认值 Numeric ID (auto-generated)

  5. 属性下,使用添加属性按钮来添加下列属性:

    名称 类型 是否编入索引
    description 字符串 了解 Datastore。
    创建时间 日期和时间 (当天日期)
    完成 布尔值 False
    现在,您的创建页面应如下所示:

    设置了各种属性的实体创建窗口

  6. 点击创建。控制台会显示您刚刚创建的 Task 实体。

您已成功将数据存入您的数据库!

运行查询

Datastore 模式数据库支持按种类或 Google 查询语言 (GQL) 查询数据。以下说明将逐步介绍如何使用这两者来查询数据库。

运行种类查询

  1. 点击按种类查询
  2. 在种类下拉列表中,选择 Task

查询结果会显示您创建的 Task 实体。

接下来,添加一个查询子句,将结果限制为符合特定条件的实体:

  1. 点击添加查询子句
  2. 在下拉列表中,选择 WHEREdone==booleanfalse
  3. 点击运行。结果会显示您创建的 Task 实体,因为其 done 值为 false已应用过滤条件的种类查询
  4. 现在,将查询子句更改为 WHEREdone==booleantrue。点击 Run。结果不包含您创建的 Task 实体,因为其 done 值并非 true

运行 GQL 查询

  1. 点击按 GQL 查询
  2. 输入 SELECT * FROM Task 查询语句。请注意,Task 需区分大小写。
  3. 点击运行查询

查询结果会显示您创建的 Task 实体。

添加查询过滤条件,将结果限制为符合特定条件的实体:

  1. 运行查询,如 SELECT * FROM Task WHERE done=false。请注意,Taskdone 需区分大小写。查询结果会显示您创建的 Task 实体,因为其 done 值为 false已应用过滤条件的 GQL 查询
  2. 现在运行查询,如 SELECT * FROM Task WHERE done=true。查询结果不包含您创建的 Task 实体,因为其 done 值并非 true

清理

  1. 点击按种类查询,确保在种类下拉框中选择 Task
  2. 点击清除以移除所有查询子句。
  3. 选择您创建的 Task 实体。
  4. 点击删除,然后确认您要删除 Task 实体。根据浏览器窗口的大小,删除可能位于 更多操作菜单下。删除后,实体将从您的数据库中永久移除。

恭喜,您已经完成快速入门!

后续步骤