如何在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
相关产品推荐
相关产品推荐

