연 $setOnInsert 산자는 upsert 연산으로 인해 새 문서가 삽입되는 경우에만 필드 값을 설정하는 데 사용됩니다. 문서가 이미 있고 업데이트 중인 경우 연산자는 $setOnInsert 아무런 영향을 주지 않습니다. 이 연산자는 새 문서를 만들 때만 적용해야 하는 기본값 또는 초기화 데이터를 설정하는 데 특히 유용합니다.
문법
{
$setOnInsert: {
<field1>: <value1>,
<field2>: <value2>,
...
}
}
매개 변수
| 매개 변수 | Description |
|---|---|
field |
삽입에만 설정할 필드의 이름입니다. 최상위 필드이거나 중첩된 필드에 점 표기법을 사용할 수 있습니다. |
value |
새 문서를 삽입할 때만 필드에 할당할 값입니다. 유효한 BSON 유형일 수 있습니다. |
예시
스토어 컬렉션에서 이 샘플 문서를 고려합니다.
{
"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
"name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
"location": {
"lat": -89.2384,
"lon": -46.4012
},
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 20
}
},
"sales": {
"totalSales": 75670,
"salesByCategory": [
{
"categoryName": "Wine Accessories",
"totalSales": 34440
},
{
"categoryName": "Bitters",
"totalSales": 39496
},
{
"categoryName": "Rum",
"totalSales": 1734
}
]
},
"promotionEvents": [
{
"eventName": "Unbeatable Bargain Bash",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 6,
"Day": 23
},
"endDate": {
"Year": 2024,
"Month": 7,
"Day": 2
}
},
"discounts": [
{
"categoryName": "Whiskey",
"discountPercentage": 7
},
{
"categoryName": "Bitters",
"discountPercentage": 15
},
{
"categoryName": "Brandy",
"discountPercentage": 8
},
{
"categoryName": "Sports Drinks",
"discountPercentage": 22
},
{
"categoryName": "Vodka",
"discountPercentage": 19
}
]
},
{
"eventName": "Steal of a Deal Days",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
},
"endDate": {
"Year": 2024,
"Month": 9,
"Day": 29
}
},
"discounts": [
{
"categoryName": "Organic Wine",
"discountPercentage": 19
},
{
"categoryName": "White Wine",
"discountPercentage": 20
},
{
"categoryName": "Sparkling Wine",
"discountPercentage": 19
},
{
"categoryName": "Whiskey",
"discountPercentage": 17
},
{
"categoryName": "Vodka",
"discountPercentage": 23
}
]
}
]
}
예제 1: 기본 $setOnInsert 사용
저장소 레코드를 만들거나 업데이트하지만 새 저장소를 만들 때 특정 초기화 필드만 설정하려면
db.stores.updateOne(
{ "_id": "new-store-001" },
{
$set: {
"name": "Trey Research Electronics - Downtown",
"sales.totalSales": 0
},
$setOnInsert: {
"createdDate": new Date(),
"status": "new",
"staff.totalStaff.fullTime": 0,
"staff.totalStaff.partTime": 0,
"version": 1
}
},
{ upsert: true }
)
이 작업은 다음 결과를 반환합니다.
{
acknowledged: true,
insertedId: 'new-store-001',
matchedCount: 0,
modifiedCount: Long("0"),
upsertedCount: 1
}
문서가 _id: "new-store-001" 없으므로 이 작업은 다음과 같은 새 문서를 만듭니다.
{
"_id": "new-store-001",
"name": "Trey Research Electronics - Downtown",
"sales": {
"totalSales": 0
},
"createdDate": ISODate("2025-06-05T10:30:00.000Z"),
"status": "new",
"staff": {
"totalStaff": {
"fullTime": 0,
"partTime": 0
}
},
"version": 1
}
예제 2: 기존 문서를 사용하여 $setOnInsert
이제 동일한 문서를 다른 값으로 다시 업서트해 보겠습니다.
db.stores.updateOne(
{ "_id": "new-store-001" },
{
$set: {
"name": "Trey Research Electronics - Downtown Branch",
"sales.totalSales": 5000
},
$setOnInsert: {
"createdDate": new Date(),
"status": "updated",
"staff.totalStaff.fullTime": 10,
"staff.totalStaff.partTime": 5,
"version": 2
}
},
{ upsert: true }
)
문서가 이미 있으므로 작업만 $set 적용되고 $setOnInsert 무시됩니다.
{
"_id": "new-store-001",
"name": "Trey Research Electronics - Downtown Branch",
"sales": {
"totalSales": 5000
},
"createdDate": ISODate("2025-06-05T10:30:00.000Z"),
"status": "new",
"staff": {
"totalStaff": {
"fullTime": 0,
"partTime": 0
}
},
"version": 1
}
예제 3: 중첩된 개체가 있는 복합 $setOnInsert
복잡한 중첩 구조를 초기화하는 데 사용할 $setOnInsert 수 있습니다.
db.stores.updateOne(
{ "name": "Adatum Gaming Paradise - Mall Location" },
{
$set: {
"location.lat": 35.6762,
"location.lon": 139.6503
},
$setOnInsert: {
"_id": "gaming-store-mall-001",
"createdDate": new Date(),
"status": "active",
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 12
},
"manager": "Alex Johnson",
"departments": ["gaming", "accessories", "repairs"]
},
"sales": {
"totalSales": 0,
"salesByCategory": []
},
"operatingHours": {
"weekdays": "10:00-22:00",
"weekends": "09:00-23:00"
},
"metadata": {
"version": 1,
"source": "store-management-system"
}
}
},
{ upsert: true }
)
예제 4: 배열에 $setOnInsert 사용
배열 및 복잡한 데이터 구조를 초기화할 수 있습니다.
db.stores.updateOne(
{ "address.city": "New Tech City" },
{
$set: {
"name": "Future Electronics Hub",
"sales.totalSales": 25000
},
$setOnInsert: {
"_id": "future-electronics-001",
"establishedDate": new Date(),
"categories": ["electronics", "gadgets", "smart-home"],
"promotionEvents": [],
"ratings": {
average: 0,
count: 0,
reviews: []
},
"inventory": {
lastUpdated: new Date(),
totalItems: 0,
lowStockAlerts: []
}
}
},
{ upsert: true }
)
중요합니다
연산자는 $setOnInsert upsert 작업({ upsert: true }) 중에만 적용됩니다.
문서가 있는 $setOnInsert 경우 필드는 완전히 무시됩니다.
$setOnInsert 는 일반적으로 단일 작업에서 업데이트 및 삽입 시나리오를 모두 처리하는 데 사용됩니다 $set .
등과 같은 $setOnInsert$inc다른 업데이트 연산자를 결합 $push 할 수 있습니다.
이 $setOnInsert 연산자는 생성 타임스탬프, 기본값 및 초기화 데이터를 설정하는 데 적합합니다.