RavenDB 3.5如何为缺少指定属性的文档新增字段并查询对应文档

1. 查询所有不包含指定属性的文档 #

RavenDB 3.5 原生支持基于字段存在性的查询，两种常用写法如下：

RQL 直接查询（适用于Studio查询） #

from 你的集合名称
where not exists(目标字段名)

示例：查询Users集合中没有LastLoginTime字段的所有文档：

from Users
where not exists(LastLoginTime)

C# 客户端查询 #

// 动态查询无需定义实体类
var result = session.Advanced.DocumentQuery<dynamic>("Users/AllDocuments")
    .WhereNotExists("LastLoginTime")
    .ToList();

如果已经定义了对应实体类，直接判断属性为null也可以实现相同效果：

var result = session.Query<User>().Where(u => u.LastLoginTime == null).ToList();

2. 批量为缺失属性的文档添加字段（补丁操作） #

RavenDB 3.5 支持服务端批量补丁操作，无需遍历拉取全量文档，执行效率极高，两种常用操作方式如下：

Studio 可视化操作 #

• 进入对应数据库的「补丁（Patch）」功能页
• 选择目标集合，填入如下补丁脚本，按需替换字段名和默认值：

// 仅当字段不存在时赋值
if(this.目标字段名 === undefined) {
    this.目标字段名 = 你的默认值; // 支持所有RavenDB支持的类型：null、数值、字符串、复杂对象等
}

• 先点击「测试补丁」验证修改逻辑是否符合预期，确认无误后执行即可。

代码批量执行补丁 #

store.DatabaseCommands.UpdateByIndex(
    // 替换为目标集合的全量索引名，默认格式为「集合名/AllDocuments」
    "Users/AllDocuments",
    // 筛选条件：仅处理缺失目标字段的文档
    new IndexQuery { Query = "where not exists(LastLoginTime)" },
    new ScriptedPatchRequest
    {
        // 补丁逻辑，替换为你的字段名和默认值
        Script = @"this.LastLoginTime = null;"
    },
    // 设为false确保索引无滞后，避免漏掉符合条件的文档
    allowStale: false
);

注意事项 #

• 执行补丁操作前建议先备份数据，避免误操作导致数据异常
• 如果默认值为复杂对象，直接在脚本中构造对应结构即可，示例：this.UserInfo = { Level: 1, Points: 0 };
• 文档量超过10万的场景建议分批执行补丁，避免长时间占用服务端资源。

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