使用 Firebase 控制台时,您可以对 Cloud Firestore 执行以下操作:
- 查看、添加、修改和删除数据。
- 创建和更新 Cloud Firestore 安全规则。
- 管理索引。
- 监控用量。
查看数据
您可以在 Firebase 控制台中查看所有 Cloud Firestore 数据。在 Cloud Firestore 数据标签页中,点击文档或集合可以打开该项中嵌套的数据。
打开特定路径
如需打开特定路径下的文档或集合,请使用修改路径按钮
:过滤集合中的文档
如需过滤集合中列出的文档,请使用过滤列表按钮
。祖先文档不存在
即使某个文档的一个或多个祖先文档不存在,该文档也可能存在。例如,即使祖先文档 /mycoll/mydoc
不存在,/mycoll/mydoc/mysubcoll/mysubdoc
路径下的文档也可能存在。Cloud Firestore 数据查看器按如下方式显示不存在的祖先文档:
- 在集合的文档列表中,不存在的祖先文档的文档 ID 显示为斜体。
- 在不存在的祖先文档的信息面板中,数据查看器指出文档不存在。
查询数据
您可以在“Cloud Firestore 数据”页面的查询构建器标签页中查询文档。
点击查询构建器标签页。
选择查询范围。
选择集合可对单个集合进行查询。在文本字段中,输入集合的路径。
选择集合组可对具有相同 ID 的所有集合进行查询。在集合组字段中,输入集合组的 ID。
相应表会自动显示包含在指定集合或集合组中的文档。
点击添加到查询以过滤返回的文档集。默认情况下,查询构建器会添加一个
WHERE
子句。您可以使用下拉菜单和文本字段修改此子句,也可以更改为使用其他某个可用子句。如需继续构建更为复杂的查询,请点击添加到查询。如需移除某个查询子句,请点击该子句的移除按钮
。如需移除所有查询子句,请点击清除。点击运行以从数据库中检索结果。
有关查询的要求和限制
使用查询构建器时,请注意以下有关查询的要求和限制。
所有查询都必须有一个或多个索引支持。如果数据库未找到任何支持查询的索引,则会返回错误,其中包含可用于构建所需索引的链接。
ORDER BY
子句必须与WHERE
子句中的字段匹配,并且顺序相同。默认情况下,结果按文档 ID 排序。如果您按不包含等式 (==
) 的任何其他字段进行过滤,请为该字段添加ORDER BY
子句。范围类(
<
、<=
、>
、>=
)以及不等式类(!=
、not-in
)的查询子句必须全部针对同一字段进行过滤。
如需了解其他限制,请参阅查询限制。
管理数据
在 Cloud Firestore 中,您可以将数据存储在文档中,并将文档整理成集合。在开始添加数据之前,请详细了解 Cloud Firestore 数据模型。
您可以通过 Firebase 控制台添加、修改和删除文档与集合。如需管理数据,请打开 Cloud Firestore 部分中的数据标签页:
添加数据
- 点击添加集合,然后输入您的集合名称并点击下一步。
- 输入特定文档 ID 或点击自动生成的 ID,然后为您文档中的数据添加字段。
- 点击保存。您的新集合和文档即会显示在数据查看器中。
- 如需向集合添加更多文档,请点击添加文档。
修改数据
- 点击某个集合以查看其文档,然后点击某个文档以查看其字段和子集合。
- 点击某个字段以修改其值。如需向所选文档添加字段或子集合,请点击添加字段或添加集合。
删除数据
如需删除某个集合,请执行以下操作:
- 选择要删除的集合。
- 点击文档列顶部的菜单图标,然后点击删除集合。
如需删除某个文档或其所有字段,请执行以下操作:
- 选择要删除的文档。
- 点击文档详细信息列顶部的菜单图标。选择删除文档或删除文档字段。
删除文档会删除该文档中的所有嵌套数据,包括所有子集合。但是,删除文档的字段则不会删除其子集合。
如需删除某个文档中的特定字段,请执行以下操作:
- 选择该文档以查看其字段。
- 点击要删除的字段旁边的删除图标。
管理 Cloud Firestore 安全规则
如需在 Firebase 控制台中添加、修改和删除 Cloud Firestore 安全规则,请前往 Cloud Firestore部分中的规则标签页。详细了解如何设置和自定义规则。
管理索引
如需通过 Firebase 控制台为查询创建新索引以及管理现有索引,请前往 Cloud Firestore 部分中的索引标签页。详细了解如何管理索引。
监控用量
如需监控 Cloud Firestore 用量,请打开 Firebase 控制台中的 Cloud Firestore 用量标签页。您可以使用信息中心测量您在不同时间段的用量。