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

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

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

准备工作

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

• 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

  注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

  转到“项目选择器”

• 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

  注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

  转到“项目选择器”

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

  • 您的账号需要具备 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. 在下拉列表中，选择 WHERE、done、==、boolean 和 false。
3. 点击运行。结果会显示您创建的 Task 实体，因为其 done 值为 false。
4. 现在，将查询子句更改为 WHERE、done、==、boolean 和 true。点击 Run。结果不包含您创建的 Task 实体，因为其 done 值并非 true。

运行 GQL 查询

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

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

提示

GQL 查询编辑器支持种类的自动补全：当您需要键入种类名称时，可按 Ctrl+空格键查看可用种类的列表。列表中最多可显示 300 个按字母排序的种类。为了更好地匹配种类，请输入一个或多个字符。

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

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

清理

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

恭喜，您已经完成快速入门！

后续步骤

• 详细了解 Datastore 查询。
• 详细了解 Datastore 模式数据库。