Document
使用控制台管理 Firestore

使用控制台管理 Firestore

使用控制台管理 Firestore 您可以通过在 Google Cloud 控制台: 查看数据 您可以在 Google Cloud 控制台中查看所有 Firestore 数据。在 Firestore 数据查看器中,点击文档或集合可以打开该项目中嵌套的数据。 在 Google Cloud

Related articles

20 Easy Mushroom Drawing Ideas Ichimoku Cloud Indicator San Diego’s Best Hookah Lounge [Updated 2024] Best free VPN for Capcut in India: Unblock & Edit Freely Rainbow Clouds: Formation, Causes, and How to Observe Them

使用控制台管理 Firestore

您可以通过在
Google Cloud 控制台:

查看数据

您可以在 Google Cloud 控制台中查看所有 Firestore 数据。在 Firestore 数据查看器中,点击文档或集合可以打开该项目中嵌套的数据。

  1. 在 Google Cloud 控制台中,转到数据库页面。

    前往“数据库”

  2. 从数据库列表中选择所需的数据库。

  3. 在导航菜单中,点击 Firestore Studio。

打开特定路径

如需打开特定路径下的文档或集合,请使用修改路径按钮 create

使用控制台管理 Firestore

祖先文档不存在

即使某个文档的一个或多个祖先文档不存在,该文档也可能存在。例如,即使祖先文档 /mycoll/mydoc 不存在,/mycoll/mydoc/mysubcoll/mysubdoc 路径下的文档也可能存在。Firestore 数据查看器按如下方式显示不存在的祖先文档:

  • 在集合的文档列表中,不存在的祖先文档的文档 ID 显示为斜体。
  • 在不存在的祖先文档的信息面板中,数据查看器指出文档不存在。

使用控制台管理 Firestore

警告:即使不存在的祖先文档显示在控制台中,它们也不会显示在查询和快照中。您必须创建该文档才能将其包含在查询结果中。

过滤数据

您可以根据字段值和 ==!->>=<<=innot-inarray-containsarray-contains-any 条件过滤集合中的文档。例如,您可以仅显示
其中,字段 firstname 的值等于 Sam。要应用集合过滤条件,请执行以下操作:

  1. 点击集合 ID 旁边的过滤器按钮 filter_list

    使用控制台管理 Firestore

  2. 从添加过滤条件菜单中,选择文档字段、过滤条件和排序顺序。

    使用控制台管理 Firestore

  3. 点击应用。

要移除集合过滤条件,请打开同一菜单,然后点击清除过滤条件。

查询数据

您可以在 Firestore Studio 页面的查询构建器标签页中查询文档。

  1. 在 Google Cloud 控制台中,转到数据库页面。

    前往“数据库”

  2. 从数据库列表中选择所需的数据库。

  3. 在导航菜单中,点击 Firestore Studio。

  4. 点击查询构建器标签页。

  5. 选择查询范围。

    选择集合可对单个集合进行查询。在文本字段中,输入集合的路径。

    选择集合组可对具有相同 ID 的所有集合进行查询。在集合组字段中,输入集合组的 ID。

    相应表会自动显示包含在指定集合或集合组中的文档。

  6. 点击添加到查询以过滤返回的文档集。默认情况下,查询构建器会添加一个 WHERE 子句。您可以使用下拉菜单和文本字段修改此子句,也可以更改为使用其他某个可用子句。如需继续构建更为复杂的查询,请点击添加到查询。

    如需移除某个查询子句,请点击该子句的移除按钮 delete。如需移除所有查询子句,请点击清除。

    注意 :查询必须符合 Firestore 的要求和限制
    用于查询。否则,查询会失败,并且相应页面会返回一个错误,说明查询失败的原因。

  7. 点击运行以从数据库中检索结果。

    使用控制台管理 Firestore

提示:您运行的查询会存储在浏览器历史记录中。在会话期间,您可以在浏览器中向前和向后移动,以访问近期的查询。您可以为想要经常访问的查询添加书签,
以便与他人分享。

有关查询的要求和限制

使用查询构建器时,请注意以下有关查询的要求和限制。

  • 所有查询都必须有一个或多个索引支持。如果数据库未找到任何支持查询的索引,则会返回错误,其中包含可用于构建所需索引的链接。

    使用控制台管理 Firestore

  • ORDER BY 子句必须与 WHERE 子句中的字段匹配,并且顺序相同。默认情况下,结果按文档 ID 排序。如果您按不包含等式 (==) 的任何其他字段进行过滤,请为该字段添加 ORDER BY 子句。

    使用控制台管理 Firestore

  • 范围类(<<=>>=)以及不等式类(!=not-in)的查询子句必须全部针对同一字段进行过滤。

如需了解其他限制,请参阅查询限制。

管理数据

在 Firestore 中,您可以将数据存储在文档中,并将文档整理成集合。在开始添加数据之前,请详细了解 Firestore 数据模型。

您可以通过 Firebase 控制台添加、修改和删除文档与集合。如需通过 GCP 控制台管理数据,请前往 Firestore Studio 页面:

  1. 在 Google Cloud 控制台中,转到数据库页面。

    前往“数据库”

  2. 从数据库列表中选择所需的数据库。

  3. 在导航菜单中,点击 Firestore Studio。

注意: 在控制台中执行的读取、写入和删除操作都会计入
Firestore 用量。

添加数据

  1. 点击开始收集合。
  2. 输入集合 ID。输入文档 ID。Firestore 会生成文档 ID,但您可以覆盖特定的文档 ID。
    在文档中为数据添加字段。
  3. 点击保存。您的新集合和文档即会显示在数据查看器中。
  4. 要向集合添加更多文档,请点击添加文档。

修改数据

  1. 点击某个集合以查看其文档,然后点击某个文档以查看其字段和子集合。
  2. 点击某个字段以修改其值。要向所选文档添加字段或子集合,请点击添加字段或开始集合。

删除数据

您可以从数据查看器中删除文档或集合。

注意 :在某些情况下,删除大量文档可能会导致
导致数据查看器加载缓慢或返回超时错误。这适用于通过数据查看器和其他位置执行的删除操作。

如需删除某个集合,请执行以下操作:

  1. 选择要删除的集合。
  2. 点击文档列顶部的菜单图标,然后点击删除集合。

要删除文档,请执行以下操作:

  1. 选择要删除的文档。
  2. 点击文档详细信息列顶部的菜单图标。选择删除文档或删除文档字段。

删除文档会删除该文档中的所有嵌套数据,包括所有子集合。

删除文档的字段不会删除其子集合。虽然文档是空的,但文档仍然存在,并且可以显示在查询结果中。

如需删除某个文档中的特定字段,请执行以下操作:

  1. 选择该文档以查看其字段。
  2. 点击要删除的字段旁边的删除图标。

管理 Firestore 安全规则

您可以查看自己的 Firestore 安全规则
Google Cloud 控制台要修改或删除您的规则集,请启用 Firebase 并使用 Firebase CLI 或 Firebase 控制台。

启用 Firebase

要修改 Firestore 安全规则,您必须为您的 Google Cloud 项目启用 Firebase。如果未启用 Firebase,您可以通过安全规则页面启用 Firebase:

使用控制台管理 Firestore

“Firestore 安全规则”功能与 Firebase 身份验证和 Firebase SDK(网页版、Android、Apple 平台)紧密集成。如需详细了解 Firebase 和 Firestore,请参阅 Firebase 使用入门。

查看安全规则

如需在 Google Cloud 控制台中查看 Firestore 安全规则,请转到
安全规则页面:

  1. 在 Google Cloud 控制台中,转到数据库页面。

    前往“数据库”

  2. 从数据库列表中选择所需的数据库。

  3. 在导航菜单中,点击安全规则

使用控制台管理 Firestore

修改安全规则

要修改或删除 Firestore 安全规则,请使用 Firebase CLI 或 Firebase 控制台。在 Firebase 控制台中,转到 Firestore 部分中的规则标签页。详细了解如何设置和自定义规则。

管理索引

如需通过 Firebase 控制台为您的查询创建新索引以及管理现有的索引,请转到 Firestore 部分的索引标签页。详细了解如何管理索引。