기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
$setOnInsert
Amazon DocumentDB의 $setOnInsert 연산자는 문서가 삽입되는 경우 필드의 값을 설정하는 데 사용되지만 문서가 업데이트되는 경우에는 영향을 주지 않습니다.
파라미터
-
field: 설정할 필드입니다.
-
value: 필드에 할당할 값입니다.
예제(MongoDB 쉘)
다음 예제에서는 Amazon DocumentDB에서 $setOnInsert 연산자의 사용을 보여줍니다. 문서가 아직 없는 경우 새 문서를 생성하지만 문서가 업데이트되는 경우에는 영향을 미치지 않습니다.
샘플 문서 생성
db.users.insertOne({
_id: 1,
name: "John Doe",
age: 30
})
쿼리 예제 1 - 기존 문서 업데이트
db.users.update(
{ _id: 1 },
{
$set: { age: 31 },
$setOnInsert: { createdAt: new Date() }
},
{ upsert: true }
)
출력 1
{
_id: 1,
name: "John Doe",
age: 31
}
출력은 문서가 업데이트되었지만 문서가 이미 존재했기 때문에 createdAt 필드가 추가되지 않았음을 보여줍니다. 연$setOnInsert산자는 새 문서를 삽입할 때만 적용됩니다.
쿼리 예제 2 - 새 문서 삽입(업서트)
db.users.update(
{ _id: 2 },
{
$set: { name: "Jane Smith", age: 25 },
$setOnInsert: { createdAt: new Date() }
},
{ upsert: true }
)
출력 2
{
_id: 2,
name: "Jane Smith",
age: 25,
createdAt: ISODate("2025-10-31T09:57:52.459Z")
}
}
코드 예제
$setOnInsert 명령을 사용하기 위한 코드 예제를 보려면 사용하려는 언어의 탭을 선택합니다.
- Node.js
-
const { MongoClient } = require('mongodb');
async function updateWithSetOnInsert() {
const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const users = db.collection('users');
await users.updateOne(
{ _id: 1 },
{
$set: { age: 31 },
$setOnInsert: { createdAt: new Date() }
},
{ upsert: true }
);
const updatedUser = await users.findOne({ _id: 1 });
console.log(updatedUser);
await client.close();
}
updateWithSetOnInsert();
- Python
-
from pymongo import MongoClient
def update_with_set_on_insert():
client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
users = db['users']
result = users.update_one(
{'_id': 1},
{
'$set': {'age': 31},
'$setOnInsert': {'createdAt': datetime.datetime.now()}
},
upsert=True
)
updated_user = users.find_one({'_id': 1})
print(updated_user)
client.close()
update_with_set_on_insert()
