快速入门

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

准备工作

  • 登录您的 Google 帐号。

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

  • 在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google 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. 属性下,使用添加属性按钮来添加下列属性:

    名称 类型 是否编入索引
    description 字符串 了解 Google Datastore 模式
    created 日期和时间 (当天日期)
    done 布尔值 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 实体。删除后,实体将从您的数据库中永久移除。

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

后续步骤