如何在C#中为Firestore文档添加子集合？

嘿，别慌！刚接触Firestore和NoSQL确实会有点摸不着头脑，给指定文档添加子集合其实没有你想的那么复杂——甚至严格来说，Firestore里不需要主动“创建”子集合，只要你往某个父文档的子集合路径下添加第一个文档，子集合就会自动存在啦。我来一步步给你讲清楚怎么做：

第一步：确保你安装了Firestore的C# SDK #

首先得确保项目里已经装了官方的Firestore NuGet包，你可以在Package Manager Console里运行：

Install-Package Google.Cloud.Firestore

或者直接在Visual Studio的NuGet包管理器里搜索Google.Cloud.Firestore安装最新版本。

第二步：初始化Firestore客户端 #

先建立和Firestore的连接，需要用到你的GCP项目ID：

using Google.Cloud.Firestore;

// 初始化客户端（确保你的环境已经配置了GCP认证，比如本地用服务账号密钥）
FirestoreDb db = FirestoreDb.Create("你的GCP项目ID");

小贴士：本地开发的话，可以把服务账号密钥的路径放到环境变量GOOGLE_APPLICATION_CREDENTIALS里，或者在Create方法里指定密钥路径，本地调试先配置好认证就行。

第三步：获取父文档的引用 #

先定位到你要添加子集合的那个指定文档，比如假设你有一个users集合，里面有个ID为user_1001的文档，你要给它加一个orders子集合：

// 获取父文档的引用
DocumentReference parentDocRef = db.Collection("users").Document("user_1001");

第四步：往子集合里添加第一个文档 #

这一步就是关键了——只要你往子集合里写入第一个文档，Firestore就会自动创建这个子集合。这里给你两种常见的写法：

写法1：用Dictionary直接添加文档 #

适合简单的场景，不用定义实体类：

// 获取子集合的引用
CollectionReference ordersSubCollection = parentDocRef.Collection("orders");

// 准备要添加的订单数据
var orderData = new Dictionary<string, object>
{
    { "orderId", "ORD_20240501_001" },
    { "totalAmount", 99.99 },
    { "createdAt", Timestamp.FromDateTime(DateTime.UtcNow) }
};

// 添加文档到子集合（可以指定文档ID，也可以让Firestore自动生成）
await ordersSubCollection.AddAsync(orderData);

写法2：用实体类添加文档 #

如果你的数据结构比较固定，推荐用实体类，更规范：
首先定义一个Order类：

[FirestoreData]
public class Order
{
    [FirestoreProperty]
    public string OrderId { get; set; }
    
    [FirestoreProperty]
    public double TotalAmount { get; set; }
    
    [FirestoreProperty]
    public Timestamp CreatedAt { get; set; }
}

然后添加文档：

CollectionReference ordersSubCollection = parentDocRef.Collection("orders");

var newOrder = new Order
{
    OrderId = "ORD_20240501_002",
    TotalAmount = 149.99,
    CreatedAt = Timestamp.FromDateTime(DateTime.UtcNow)
};

await ordersSubCollection.AddAsync(newOrder);

新手必看的小提醒 #

• Firestore的控制台里，子集合不会直接显示在父文档的详情页里，你需要点击父文档右上角的“查看子集合”按钮才能看到，或者直接在左侧导航栏里通过路径找到它。
• 如果你想“创建一个空的子集合”，抱歉Firestore不支持——因为NoSQL里空集合是不存在的，必须有至少一个文档才会被系统记录。
• 记得检查你的Firestore安全规则，确保你的客户端有写入这个子集合的权限，不然会报错哦。

这样操作之后，你指定的父文档就拥有对应的子集合啦，是不是比你想的简单？

内容的提问来源于stack exchange，提问作者erejotA