使用 Firestore Studio（标准版）

使用 Firestore Studio（标准版）

您可以通过在Google Cloud 控制台中执行以下操作来管理 Firestore 标准版：

• 查看、查询、添加、修改和删除数据。
• 管理索引。
• 管理安全规则。

查看数据

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

1. 在 Google Cloud 控制台中，前往数据库页面。

   前往“数据库”

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

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

打开特定路径

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

配置面板设置

您可以在 Firestore Studio 中配置数据查看器的偏好设置。这些偏好设置只会影响您的控制台视图，不会更改数据库元数据。

如需配置面板设置，请执行以下操作：

1. 在数据查看器工具栏中，点击面板设置图标 。

2. 在项目面板设置面板中，配置以下选项：

   • 显示不存在的父级文档：切换是否在文档列表中显示不存在的父级文档。此设置默认为启用状态。
   • 已启用实时更新：切换是否在文档发生更改时接收实时更新。此设置默认为启用状态。停用实时更新有助于减少读取操作，从而降低费用。

3. 点击保存。

注意： 面板设置适用于项目中的所有数据库。仅在启用实时更新时，数据查看器才支持过滤数据。

父文档不存在

即使某个文档的一个或多个父文档不存在，该文档也可能存在。例如，即使父文档 /mycoll/mydoc 不存在，/mycoll/mydoc/mysubcoll/mysubdoc 路径下的文档也可能存在。

默认情况下，Firestore 标准版数据查看器按如下方式显示不存在的父文档：

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

如需从集合文档列表中隐藏不存在的父文档，请在面板设置中停用显示不存在的父级文档。

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

过滤数据

您可以根据字段值和 ==、!-、>、>=、<、<=、in、not-in、array-contains、array-contains-any 条件过滤集合中的文档。例如，您可以仅显示字段 firstname 的值等于 Sam 的文档。

注意： 仅当在面板设置中选择启用实时更新时，数据查看器才支持过滤数据。

要应用集合过滤条件，请执行以下操作：

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

   

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

   

3. 点击应用。

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

查询数据

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

1. 在 Google Cloud 控制台中，前往数据库页面。

   前往“数据库”

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

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

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

5. 选择查询范围。

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

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

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

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

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

   注意： 查询必须符合 Firestore 标准版有关查询的要求和限制。否则，查询会失败，并且相应页面会返回一个错误，说明查询失败的原因。

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

   

提示： 您运行的查询会存储在浏览器历史记录中。在会话期间，您可以在浏览器中前进和后退，以访问最近的查询。您可以为经常需要访问或要与他人分享的查询添加书签。

有关查询的要求和限制

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

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

  

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

  

• 范围类（<、<=、>、>=）以及不等式类（!=、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 安全规则

您可以直接在 Google Cloud 控制台中管理和部署 Firestore 安全规则。在标准版和企业版中，规则编辑器均适用于原生模式下的 Firestore。

使用 Google Cloud 控制台

注意 ： Google Cloud 控制台不支持将 Firestore 安全规则部署到 (default) 数据库。如需管理 (default) 数据库的规则，请使用 Firebase 控制台或 Firebase CLI。

所需权限

如需在 Google Cloud 控制台中管理和部署安全规则，您需要拥有以下 IAM 权限：

• firebaserules.releases.create
• firebaserules.releases.delete
• firebaserules.releases.update
• firebaserules.rulesets.create
• firebaserules.rulesets.delete
• firebaserules.rulesets.list
• firebaserules.rulesets.test（使用规则模拟器时需要）

如需在 Google Cloud 控制台中部署规则，请执行以下操作：

1. 在 Google Cloud 控制台中，前往数据库页面。

   前往“数据库”

2. 点击要管理的数据库的 ID。

3. 在导航菜单中，点击安全。

4. 点击 Firestore 规则标签页。

5. 在规则编辑器中，查看您的规则。如需修改，请点击新建规则集或克隆规则集，然后修改规则。

6. 点击发布以部署更改。

您还可以在时间轴中查看之前的规则集，并克隆或恢复这些规则集。

使用规则模拟器测试规则

您可以先针对模拟请求测试安全规则草稿，然后再部署这些规则。

如需在 Google Cloud 控制台中测试规则，请执行以下操作：

1. 在 Google Cloud 控制台中，前往数据库页面。

   前往“数据库”

2. 点击要测试的数据库的 ID。

3. 在导航菜单中，点击安全。

4. 点击 Firestore 规则标签页，然后点击模拟器标签页。

5. 选择模拟类型（get、create、update 或 delete）。

6. 输入目标文档的位置。

7. （可选）配置模拟文档数据或身份验证参数。

8. 点击运行，以在规则编辑器中查看评估结果和突出显示的行。

启用 Firebase

如需使用 Firebase 控制台或 Firebase CLI 修改 (default) 数据库的 Firestore 安全规则，您必须为Google Cloud 项目启用 Firebase。如果未启用 Firebase，您可以通过 Google Cloud 控制台中的安全页面启用 Firebase：

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

管理索引

如需通过 Firebase 控制台为您的查询创建新索引以及管理现有的索引，请依次前往数据库和存储 > Firestore > 索引标签页。 详细了解如何管理索引。