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

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

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

准备工作

• Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

  Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

  Go to project selector

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

  Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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 数据库时，您可以选择使用原生模式 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. 在类型字段中输入 Task。将键标识符设置为默认值 Numeric ID (auto-generated)。

5. 在属性下，使用添加属性按钮来添加下列属性：

   名称	类型	值	是否编入索引
   description	字符串	了解 Datastore。
   已创建	日期和时间	（当天日期）	✓
   done	布尔值	False	✓

   您的创建页面现在应如下所示：

   

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

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

运行查询

Datastore 模式数据库支持按种类或通过 Google 查询语言 (GQL) 查询数据。以下说明将引导您结合使用这两种方法来查询数据库。

运行种类查询

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

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

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

1. 点击添加查询子句。
2. 在下拉列表中，依次选择 WHERE、done、==、布尔值和 false。
3. 点击运行。查询结果会显示您创建的 Task 实体，因为其 done 值为 false。
4. 现在，将查询子句更改为 WHERE、done、==、布尔值和 true。点击运行。结果不包含您创建的 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 模式数据库。