upsertOne
fun upsertOne(options: UpdateOptions<Document>.() -> Unit = {}, filter: FilterQuery<Document>.() -> Unit = {}, update: UpsertQuery<Document>.() -> Unit)(source)
Updates a single document that matches filter according to update.
If multiple documents match filter, only the first one found is updated.
If no documents match filter, a new one is created.
Example
class User(
val name: String,
val age: Int,
)
collection.bulkWrite {
upsertOne(
filter = { User::name eq "Patrick" },
update = {
User::age set 15
}
)
}Content copied to clipboard
If a document exists that has the name of "Patrick", its age is set to 15. If none exist, a document with name "Patrick" and age 15 is created.
External resources
See also
Always create a new document.
Do nothing if no matching documents are found.