在 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 模式数据库。