使用核心操作添加和查询数据

本页介绍的用于添加和查询数据的核心操作,与 Firestore 标准版中提供的操作相同。如果您熟悉 Firestore 标准版,则可以采用相同的方式在 Firestore 企业版中添加和查询数据。

我们诚邀您试用流水线操作,但在体验此预览版时,请注意以下有关核心操作的信息:

  • 在预览期间,您将使用核心添加操作来填充数据。
  • 您可以像在标准版中一样,使用核心操作来获得实时和离线支持。流水线查询尚不具备实时和离线功能。

使用核心操作向 Firestore 添加数据

核心操作支持添加和查询数据。流水线操作仅用于查询数据。因此,在预览体验期间,您将使用核心操作来填充支持流水线的新数据库。

简单回顾一下核心操作,写入数据主要有两种方法:set()add()。了解二者之间的区别,是有效管理文档的关键。

您可以从以下角度来理解这些操作:

  • set():当您想自行指定文档 ID 时,请使用此操作。如果具有该 ID 的文档已存在,set() 将完全覆盖该文档,除非您使用合并选项。如果该文档不存在,set() 将会创建它。
  • add():当您希望 Firestore 为新文档自动生成唯一 ID 时,请使用此方法。当您向集合中添加文档,且没有可用的自然标识符时,此方法非常有用。

如需获取有关添加和更新文档(包括如何处理嵌套对象、数组和服务器时间戳)的全面指南,请参阅向 Cloud Firestore 添加数据的官方文档。

使用核心操作从 Firestore 读取数据

使用核心操作从 Firestore 检索数据的方式,与在 Firestore 标准版中完全相同,均支持实时更新和离线功能。

您可以通过以下几种方式检索数据:

  • 单次获取文档:最简单的读取数据方法是,一次性提取某个文档或查询结果。
  • 监听实时更新:您可以为文档或查询设置监听器,以便在数据发生变化时实时接收更新。
  • 来源选项:对于具有离线功能的应用,您可以指定是从服务器还是本地缓存检索数据,也可以让 SDK 自行决定。

如需详细了解如何执行简单查询和复合查询、对数据进行排序和限制以及使用自定义对象,请参阅使用 Cloud Firestore 获取数据的详细文档。