快速入门

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

准备工作

  • 登录您的 Google 帐号。

    如果您还没有 Google 帐号,请注册新帐号

  • 在 Cloud Console 的项目选择器页面上,选择或创建 Cloud 项目。

    转到项目选择器页面

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

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

创建数据库

如需创建新的数据库实例,请在 Google Cloud Console 中打开 Datastore 部分:
转到 Datastore 页面

Firestore:原生模式或 Datastore 模式

创建新的 Firestore 数据库时,您可以视需要使用原生模式 Firestore 或 Datastore 模式 Firestore。

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

  • 原生模式 Firestore

    为移动应用和 Web 应用使用原生模式 Firestore。如需开始使用 Firestore,请继续参阅 Firestore 快速入门

  • Datastore 模式 Firestore

    为新的服务器项目使用 Datastore 模式 Firestore。借助 Datastore 模式 Firestore,您可以使用 Firestore 经过改进的存储层,同时保留 Datastore 模式的系统行为。

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

存储数据

  1. 转到 Google Cloud Console 中的“Datastore 实体”页面。
    转到“Datastore 实体”页面
    您可通过此页面存储、查询、更新和删除数据。
  2. 点击创建实体
  3. 如果您看到以下页面,则需要选择一个位置(如果您未看到此页面,请转到下一步)。

    “选择位置”页面屏幕截图

    该位置同时适用于 Google Cloud 项目的 Datastore 模式数据库和 App Engine 应用。
    如需保存位置,请选择其中一个位置值,然后点击下一步

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

  5. 种类中输入 Task

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

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

    设置了属性的实体创建窗口的屏幕截图

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

您刚才已将数据存储在您的数据库中!

运行查询

Datastore 模式数据库支持按种类或通过 Google 查询语言 (GQL) 查询数据;以下说明将提供这两种操作的分步介绍。

运行种类查询

  1. 点击按种类查询
  2. 选择 Task 作为种类。

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

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

  1. 点击过滤实体
  2. 在下拉列表中,选择 done是一个布尔值值为 false
  3. 点击应用过滤条件。结果会显示您创建的 Task 实体,因为其 done 值为 false应用了过滤条件的种类查询的屏幕截图
  4. 现在尝试查询 done是一个布尔值值为 true。结果不包含您创建的 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 实体。删除后,实体将从数据库中永久移除。

大功告成,您已经完成快速入门!

后续步骤