Новый CRUD API MongoDB Shell

На прошлой неделе мы выпустили последнюю версию MongoDB для разработки. Официальный анонс фокусируется на исправлении ошибок, но я гораздо более взволнованы о новом свойства: Монго оболочка включает в себя новый CRUD API! В дополнении к старому insert, updateи remove, оболочка поддерживает insertMany, replaceOneи целый ряд других новых методов.

Почему я забочусь об этом, и почему вы должны?

Драйверы MongoDB следующего поколения, выпущенные этой весной, включают новый API для операций CRUD , но оболочка изначально не следовала этому примеру. Мой читатель Ник Милон заметил, что это шаг в неверном направлении: драйверы теперь менее совместимы с оболочкой. Он отметил: «Разработчики чаще переключаются между драйвером и оболочкой, чем драйверами на разных языках программирования». Поэтому я предложил эту функцию , ее кодировал Кристиан Квалхейм, а Кей Ким обновляет руководство пользователя.

Приятно, когда предложение незнакомца настолько очевидно верно, что мы спешим его реализовать.

Оболочка теперь более совместима с драйверами, чем когда-либо прежде. Но помимо этого, новый API просто лучше. Например, старый insertметод может принимать один или несколько документов, и его возвращаемое значение не включает новые идентификаторы:

> // the old insert API
> db.test.insert({_id: 1})
WriteResult({ "nInserted" : 1 })
> db.test.insert([{_id: 2}, {_id: 3}, {_id: 4}])
BulkWriteResult({
    "writeErrors" : [ ],
    "writeConcernErrors" : [ ],
    "nInserted" : 3,
    "nUpserted" : 0,
    "nMatched" : 0,
    "nModified" : 0,
    "nRemoved" : 0,
    "upserted" : [ ]
})

> // the new CRUD API
> db.test2.insertOne({_id: 1})
{
    "acknowledged" : true,
    "insertedId" : 1
}
> db.test2.insertMany([{_id: 2}, {_id: 3}, {_id: 4}])
{ 
    "acknowledged" : true,
    "insertedIds" : [ 2, 3, 4 ]
}

> // the old update API
> db.test.update(
... {_id: 1},
... {$set: {x: 1}},
... true              /* upsert */,
... false             /* multi */
)
WriteResult({
    "nMatched" : 0,
    "nUpserted" : 1,
    "nModified" : 0,
    "_id" : 1
})

> // the new update API
> db.test2.updateOne(
... {_id: 1},
... {$set: {x: 1}},
... {upsert: true}
)
{
    "acknowledged" : true,
    "matchedCount" : 0,
    "modifiedCount" : 0,
    "upsertedId" : 1
}

> // the old replace API
> db.test.update(
... {_id: 1},
... {set: {x: 1}}  // OOPS!!
)
WriteResult({
    "nMatched" : 1,
    "nUpserted" : 0,
    "nModified" : 1
})
> // document was replaced
> db.test.findOne()
{ "_id" : 1, "set" : { "x" : 1 } }

> // the new update API catches mistakes
> db.test2.updateOne(
... {_id: 1},
... {set: {x: 1}}
)
Error: the update operation document must contain atomic operators
>
> // explicitly replace with "replaceOne"
> db.test2.replaceOne(
... {_id: 1},
... {x: 1}
)
{
    "acknowledged" : true,
    "matchedCount" : 1,
    "modifiedCount" : 1
}
> db.test2.findOne()
{ "_id" : 1, "x" : 1 }

> // the old delete API
> db.test.remove({})  // remove EVERYTHING!!

> // the new delete API
> db.test2.deleteOne({})
{ "acknowledged" : true, "deletedCount" : 1 }
> db.test2.deleteMany({})
{ "acknowledged" : true, "deletedCount" : 3 }

> // the old findAndModify
> db.test.findAndModify({
... query: {_id: 1},
... update: {$set: {x: 1}},
... new: true
... })
{ "_id" : 1, "x" : 1 }
> db.test.findAndModify({
... query: {_id: 1},
...  // REPLACE the document!
... update: {field: 'value'},
... new: false
... })
{ "_id" : 1, "x" : 1 }
> db.test.findAndModify({
... query: {_id: 1},
... remove: true
... })
{ "_id" : 1, "field" : "value" }

> // the new API
> db.test2.findOneAndUpdate(
... {_id: 1},
... {$set: {x: 1}},
... {returnNewDocument: true}
... )
{ "_id" : 1, "x" : 1 }
> db.test2.findOneAndReplace(
... {_id: 1},
... {field: 'value'},
... {returnNewDocument: false}
... )
{ "_id" : 1, "x" : 1 }
> db.test2.findOneAndDelete({_id: 1})
{ "_id" : 1, "field" : "value" }