Mongodb字段更新操作符$currentDate

学习mongodb,体会mongodb的每一个使用细节,欢迎阅读威赞的文章。这是威赞发布的第54篇mongodb技术文章,欢迎浏览本专栏威赞发布的其他文章。

本文基于Mongodb的官方文档,整理了Mongodb字段更新操作符$currentDate的定义,语法,行为和操作用例,以供参考。

定义

Mongodb支持使用操作符$currentDate更新字段为当前时间。默认更新成Date类型的时间。但也支持将字段更新成为timestamp. 当字段不存在时,向更新的文档中添加字段并更新成当前时间。

语法

数据库操作人员在UPDATE语句中,通过下面的语法将字段更新成当前时间

复制代码
{$currentDate: {<field1>: <typeSpecification1>, ...}}

其中<typeSpecification>可以使用下面中的任意一种形式:

  • 使用布尔类型的true,将指定的字段设置为当前时间。
  • 指定当前时间类型的文档,{type: "timestamp"}或{type: "date"}.其中$type类型中指定的字符串是大小写敏感的,并且只接受小写类型的字符串。

当指定的字段名称是嵌入式文档或位于数组当中时,需要使用点操作符('.')

行为

从mongodb5.0开始,更新操作的顺序按照文档字段名的字母表顺序执行。带有数字名称的字段,按照数字顺序更新。

如下面的更新语句中, 字段"a.2"在"a.10"前更新。因为数字2排列在数字10前。

复制代码
{$set: { "a.2": <new value>, "a.10": <new value>}}

使用currentDate更新字段时 ,获取到的时间是currentDate的执行时间。

如果字段不存在 ,$currentDate向文档中添加该字段。

mongodb 5.0版本以后,向$currentDate传入空表达式({ })时,mongodb不再抛出错误。空表达式不会修改字段值 ,也不会在oplog中,添加新的操作记录。

应用举例

创建一个customers集合并插入一条数据。

复制代码
db.customers.insertOne({
    _id: 1, status: "a", lastModified: ISODate("2013-10-02T01:11:18.965Z")
})

构建一条数据更新语句,要求添加cancellation文档字段,包含字段date和reason。其中,date字段是脚本执行时间。 修改字段status的值为"D"。同时将lastModified更新为脚本执行时间。

复制代码
db.customers.updateOne(
    {_id: 1},
    {
        $currentDate: {
            lastModified: true,
            "cancellation.date":{ $type: "timestamp"}
        },
        $set:  {
            "cancellation.reason": "user request",
            status: "D"
        }
    }
)

查看更新结果

复制代码
db.customers.find()
{
	"_id" : 1,
	"status" : "D",
	"lastModified" : ISODate("2024-04-01T15:57:28.663+08:00"),
	"cancellation" : {
		"date" : Timestamp(1711957959, 1),
		"reason" : "user request"
	}
}

自mongodb 4.2版本开始,也支持使用聚合操作来更新数据。其中$$CLUSTER_TIME只在复制集和分片集中使用。$$NOW和$$CLUSTER_TIME在聚合管道中返回相同的时间戳。

复制代码
db.customers.updateOne(
    { _id: 1 },
    [
        {$set: {lastModified: "$$NOW", cancellation:  {date: "$$CLUSTER_TIME", reason: "user request"}, status: "D"}}        
    ]
)
相关推荐
云动雨颤12 分钟前
Spring Boot配置优化:Tomcat+数据库+缓存+日志,全场景教程
数据库·spring boot·tomcat
RestCloud27 分钟前
Kafka实时数据管道:ETL在流式处理中的应用
数据库·kafka·api
寻星探路2 小时前
数据库造神计划第九天---增删改查(CRUD)(5)
数据库
Alan521592 小时前
🚀 阿里云 ECS + MySQL 环境搭建全流程(用于个人博客系统开发)
数据库·程序员
Huhbbjs2 小时前
SQL 核心概念与实践总结
开发语言·数据库·sql
wuyunhang1234562 小时前
Redis---集群模式
数据库·redis·缓存
sensenlin912 小时前
Mybatis中SQL全大写或全小写影响执行性能吗
数据库·sql·mybatis
最笨的羊羊3 小时前
Debezium日常分享系列之:MongoDB 新文档状态提取
mongodb·debezium日常分享系列·新文档状态提取
IAtlantiscsdn3 小时前
Redis Stack扩展功能
java·数据库·redis