Python实现Cloud Firestore Map新增键值对且保留原有数据

当前情况 #

• 基于Python开发Cloud Firestore数据库
• 当前使用更新代码：city_ref.update({"test": {"three": 200}})
• 已知目标数据字段及待添加数据的Map精确路径

预期目标 #

通过单次写入操作（无需先读取数据、追加后再更新），在保留Map现有内容的前提下完成数据新增。

现存问题 #

当前代码会直接覆盖整个test Map字段，导致原有数据丢失。

要实现保留Map原有数据的同时新增字段，需使用Firestore的点表示法指定Map内部的具体字段路径，以此实现部分更新，而非替换整个Map。

基础示例（新增单个字段） #

# 仅向test Map中新增three字段，不影响原有内容
city_ref.update({"test.three": 200})

批量新增示例（同时添加多个字段） #

# 一次性向test Map中新增three、four两个字段
city_ref.update({
    "test.three": 200,
    "test.four": 300
})

这种方式直接定位到Map内的子字段进行写入操作，属于Firestore原生的部分更新机制，无需提前读取整个Map数据，完全满足单次写入的需求。

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