You need to enable JavaScript to run this app. 如何在MongoKit文档中配置唯一索引实现字段及多键组合的唯一性约束
优惠活动
大模型
产品
解决方案
定价
更多

如何在MongoKit文档中配置唯一索引实现字段及多键组合的唯一性约束

完整实现方案

索引配置实现

规则1:player_id 非空时唯一

注意:普通sparse索引仅会排除「不存在player_id字段」的文档,你的文档默认player_id为''(字段存在、值为空),普通sparse会将空字符串纳入唯一校验,导致全局只能存在一个player_id为''的文档,完全不符合需求。此处需使用MongoDB的部分索引(Partial Index),显式过滤空值场景。

规则2:flashscore_name + player_id 组合唯一

可直接定义复合唯一索引,若需要「同一flashscore_name可对应多条player_id为空的文档」,可给该索引也加上空值过滤规则。
最终补全的文档类代码如下:

from mongokit import Document

class FlashscoreNameMap(Document):
    structure = {
        "flashscore_name": basestring,
        "translated_name": basestring,
        "player_id": basestring,
        "timestamp": float
    }
    default_values = {
        "translated_name": '',
        "player_id": ''
    }
    indexes = [
        # 规则1:仅对非空player_id建唯一索引,空字符串不参与唯一校验
        (
            [("player_id", 1)],
            {
                "unique": True,
                "partialFilterExpression": {"player_id": {"$ne": ""}},
                "name": "uniq_non_empty_player_id"
            }
        ),
        # 规则2:flashscore_name + player_id 组合唯一
        # 若需要空player_id不参与组合唯一,可在下方字典中添加 "partialFilterExpression": {"player_id": {"$ne": ""}}
        (
            [("flashscore_name", 1), ("player_id", 1)],
            {
                "unique": True,
                "name": "uniq_flashscore_player_combo"
            }
        )
    ]
    use_dot_notation = True

低版本兼容提示:如果使用的MongoDB版本低于3.2,不支持部分索引,可调整写入逻辑:当player_id为空字符串时,不写入该字段,此时普通的sparse=True + unique=True索引即可生效(仅对存在player_id字段的文档做唯一校验)。

重复数据自动更新逻辑

通过MongoDB的upsert(存在即更新,不存在即插入)操作实现重复时自动更新translated_name,示例代码:

import time
# 假设已完成MongoKit连接注册,获取对应集合实例
collection = connection.你的数据库名.FlashscoreNameMap

# 待写入的业务字段
flashscore_name = "Lionel Messi"
player_id = "messi_10"
new_translated_name = "利昂内尔·梅西"
current_timestamp = time.time()

# 匹配唯一规则执行upsert
collection.update_one(
    # 查询条件:命中任意唯一索引的重复规则
    {
        "$or": [
            {"player_id": player_id, "player_id": {"$ne": ""}},
            {"flashscore_name": flashscore_name, "player_id": player_id}
        ]
    },
    # 更新规则:命中重复时更新翻译名和时间,新插入时写入基础字段
    {
        "$set": {
            "translated_name": new_translated_name,
            "timestamp": current_timestamp
        },
        "$setOnInsert": {
            "flashscore_name": flashscore_name,
            "player_id": player_id
        }
    },
    upsert=True
)
  • 查询条件覆盖你定义的两个唯一索引规则,只要命中任意一条重复约束,都会进入更新分支。
  • 用$setOnInsert保证仅在新插入时才写入flashscore_name和player_id,更新时不会修改这两个唯一字段。

内容的提问来源于stack exchange,提问作者Saurav Pathak

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 07:36:03