위치 지정 및 필터링된 위치 지정 업데이트
학습자는 $ 위치 지정 연산자와 $[identifier] 필터링된 위치 지정 연산자를 사용해 일치하는 배열 요소를 제자리에서 업데이트합니다.
위치 지정 및 필터링된 위치 지정 업데이트은(는) CoddyKit의 무료 MongoDB Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MongoDB Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MongoDB Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.
Updating Elements Inside Arrays
While $push and $pull add and remove array elements, sometimes you need to modify an existing element in place—change a field inside a sub-document that is already in the array. MongoDB provides two positional operators for this: the $ positional operator for updating the first matching element, and the $[identifier] filtered positional operator for updating all matching elements.
The $ Positional Operator
The $ positional operator acts as a placeholder for the index of the first array element that matched the query filter. You use it in the update's field path like 'arrayField.$.subField', and MongoDB replaces $ with the index of the matched element. The query filter must include a condition on the array field so MongoDB knows which element to target.
// Update the grade of the first matching scores element
db.students.updateOne(
{
_id: studentId,
'scores.subject': 'math' // match condition identifies which element
},
{
$set: { 'scores.$.grade': 'A+' } // $ = index of matched element
}
);
// Only the FIRST element where subject='math' is updatedLimitations of the $ Operator
The $ positional operator has two important limitations: it only updates the first matching element (not all matching elements), and it cannot be used with updateMany() to safely update specific array elements across multiple documents (it updates the first match per document). For updating all matching elements or multiple documents, you need the filtered positional operator.
// Document: { scores: [{ subject: 'math', pass: false }, { subject: 'math', pass: false }] }
// $ only updates the FIRST math element
db.students.updateOne(
{ _id: id, 'scores.subject': 'math' },
{ $set: { 'scores.$.pass': true } }
);
// Result: [{ subject: 'math', pass: TRUE }, { subject: 'math', pass: FALSE }]
// Second element unchanged!The $[] All Positional Operator
The $[] (all positional) operator updates all elements in an array without needing a filter condition. It acts as a placeholder for every element in the array. Use it when you want to apply the same update to every element of an array field—for example, resetting all flags in a status array or incrementing every score by a bonus amount.
// Give every score a +5 bonus
db.students.updateOne(
{ _id: studentId },
{ $inc: { 'scores.$[].value': 5 } } // applies to ALL elements
);
// Set pass=true for every element in the array
db.students.updateMany(
{},
{ $set: { 'scores.$[].reviewed': true } } // updates across all documents
);The $[identifier] Filtered Positional Operator
The $[identifier] filtered positional operator updates all array elements that match a condition specified in an arrayFilters option. The identifier is a placeholder name you choose (like elem or score), and the arrayFilters option defines which elements the placeholder should target. This gives you precise control over which elements get updated.
// Update ALL math scores (not just the first)
db.students.updateOne(
{ _id: studentId },
{
$set: { 'scores.$[elem].grade': 'A' } // 'elem' is the identifier
},
{
arrayFilters: [{ 'elem.subject': 'math' }] // filter for 'elem'
}
);
// All elements where subject='math' get grade='A'Complex arrayFilters Conditions
The arrayFilters conditions support all standard MongoDB query operators: $gt, $lt, $in, $and, and more. You can define multiple identifiers for nested array updates by using multiple filter objects in the array. Each identifier must be a unique alphanumeric name starting with a lowercase letter.
// Fail all scores below 60 for a student
db.students.updateOne(
{ _id: studentId },
{ $set: { 'scores.$[lowScore].pass': false } },
{ arrayFilters: [{ 'lowScore.value': { $lt: 60 } }] }
);
// Update scores that are math AND below 70
db.students.updateOne(
{ _id: studentId },
{ $set: { 'scores.$[elem].needsHelp': true } },
{
arrayFilters: [{
'elem.subject': 'math',
'elem.value': { $lt: 70 }
}]
}
);Filtered Positional With updateMany
Unlike the $ operator, $[identifier] works safely with updateMany() to apply filtered array updates across all documents in a collection. This makes it extremely powerful for bulk operations like price adjustments on specific product categories embedded in order line items, or applying a discount to certain invoice entries across all users.
// Apply 10% discount to all 'sale' items across ALL orders
db.orders.updateMany(
{}, // all documents
{ $mul: { 'lineItems.$[item].price': 0.9 } },
{ arrayFilters: [{ 'item.category': 'sale' }] }
);
// Mark all pending tasks as 'overdue' if dueDate has passed
db.projects.updateMany(
{},
{ $set: { 'tasks.$[t].status': 'overdue' } },
{ arrayFilters: [{ 't.status': 'pending', 't.dueDate': { $lt: new Date() } }] }
);Nested Array Updates With Multiple Identifiers
For arrays nested inside arrays, you can use multiple identifiers in arrayFilters to target elements at different nesting levels. This is an advanced pattern—each identifier applies to a different depth in the nesting. Be mindful that deeply nested array updates are complex and may indicate a schema that could be restructured for clarity.
// Document: { courses: [{ name: 'Math', lessons: [{ id: 1, done: false }] }] }
// Mark a specific lesson as done inside a specific course
db.students.updateOne(
{ _id: studentId },
{ $set: { 'courses.$[course].lessons.$[lesson].done': true } },
{
arrayFilters: [
{ 'course.name': 'Math' }, // outer array filter
{ 'lesson.id': 1 } // inner array filter
]
}
);Updating by Index With Dot Notation
When you know the exact numeric index of the element you want to update, you can use dot notation directly: 'array.2.field' updates the third element (0-indexed). This is the most direct approach when the position is known at write time. It's commonly used for fixed-position arrays where each index has a defined meaning.
// Update the third element (index 2) directly
db.results.updateOne(
{ _id: testId },
{ $set: { 'answers.2.correct': true } } // update answer at index 2
);
// Set a specific round's score in a game
db.games.updateOne(
{ _id: gameId },
{ $set: { 'rounds.0.score': 150 } } // update round 1 (index 0)
);Combining Positional Operators With Other Updates
Positional operators can be combined with any update operator—$set, $inc, $unset, $push—to perform complex in-place array element modifications in a single atomic operation. For example, incrementing a nested field inside a matching array element while also updating a document-level timestamp.
// Increment attempt count for a specific question in a quiz
db.quizzes.updateOne(
{ _id: quizId, 'questions.id': 'q1' },
{
$inc: { 'questions.$.attemptCount': 1 },
$set: { 'questions.$.lastAttempted': new Date(), updatedAt: new Date() }
}
);
// All changes are atomicWhen to Redesign vs Use Positional Operators
Positional updates are powerful, but complex nested positional patterns can be a sign that your schema needs rethinking. Consider restructuring when: you need to query and update elements from multiple nested arrays frequently; you find yourself writing long dot-notation paths; or your application logic must determine exact element indices at runtime. Often, moving nested data to a separate collection with references is simpler and more maintainable.
// Schema smells that suggest restructuring:
// 'courses.$[c].lessons.$[l].quizzes.$[q].answers.$.correct'
// -> 5 levels of nesting is too complex
// Alternative: separate collections with references
// answers collection: { _id, quizId, lessonId, questionIndex, correct }Quick Check
Test your understanding of positional and filtered positional update operators.
Lesson Recap
In this lesson you learned: $ updates the first matched array element identified by the query filter, $[] updates all array elements unconditionally, and $[identifier] with arrayFilters updates all elements matching a condition. Next up we explore the aggregation pipeline—MongoDB's powerful server-side data transformation engine.
자주 묻는 질문
“위치 지정 및 필터링된 위치 지정 업데이트” 강의는 무료인가요?
네 — “위치 지정 및 필터링된 위치 지정 업데이트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MongoDB Academy 강의 전체를 잠금 해제할 수 있습니다. MongoDB Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“위치 지정 및 필터링된 위치 지정 업데이트”에서 뭘 배우나요?
학습자는 $ 위치 지정 연산자와 $[identifier] 필터링된 위치 지정 연산자를 사용해 일치하는 배열 요소를 제자리에서 업데이트합니다. 브라우저에서 직접 실행하는 실습 코드로 MongoDB Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MongoDB Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MongoDB Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“위치 지정 및 필터링된 위치 지정 업데이트” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MongoDB Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MongoDB Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 배열 쿼리하기: $all, $size, 요소 일치
- $elemMatch: 배열 하위 문서 일치시키기
- 배열 업데이트하기: $push, $pull, $pop, $addToSet
- 위치 지정 및 필터링된 위치 지정 업데이트