Firestore 读写集合

Firestore是一个云端数据库，它为您提供了一个可以跨平台管理数据的简单方法。Firestore是一个文档式数据库，它使用集合和文档来存储数据。

本文将介绍如何使用Firestore API来读写集合。

建立Firestore实例

要使用Firestore API，必须从Firebase控制台中下载并安装Firebase Admin SDK。安装后，创建一个Firestore实例:

import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

cred = credentials.Certificate("path/to/serviceAccountKey.json")
firebase_admin.initialize_app(cred)

db = firestore.client()

这将为您创建一个Firestore客户端对象，您可以使用它来与Firestore交互。

创建集合

在Firestore中，集合是文档的容器。要创建集合，您需要提供一个集合的名称。例如，以下代码将创建一个名为“users”的集合：

db.collection("users")

向集合中写入数据

向Firestore集合中添加数据，需要创建一个文档并为其提供数据。以下代码向“users”集合中添加名为“Ada”的新文档：

doc_ref = db.collection("users").document("Ada")
doc_ref.set({
    "first_name": "Ada",
    "last_name": "Lovelace",
    "born": 1815
})

从集合中读取数据

要从集合中获取数据，必须使用Query对象。以下示例检索所有用户的名称和出生年份：

users_ref = db.collection('users')
docs = users_ref.stream()

for doc in docs:
    print(f'{doc.id} => {doc.to_dict()}')

更新集合中的文档

要更新集合中的文档，需要获取对该文档的引用，并使用update方法更新该文档。以下代码将更新名为“Ada”的文档，将其出生年份更改为1817：

doc_ref = db.collection("users").document("Ada")
doc_ref.update({
    "born": 1817
})

删除集合中的文档

以下代码将从“users”集合中删除名为“Ada”的文档：

db.collection("users").document("Ada").delete()

总结

本文介绍了如何使用Firestore API来读写集合。您可以使用上述方法来创建集合、向文档中添加数据，检索数据、更新和删除文档。通过深入了解Firestore API，您可以利用这个功能强大的数据库实现您的应用程序要求的各种功能。