AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

$ 설정하다 (집계 단계)

참고

명확화

다음 페이지는 $set 집계 단계에 관한 것입니다. 업데이트 연산자 $set에 대해서는 $set(을)를 참조하세요.

$set

문서에 새 필드를 추가합니다. $set은(는) 입력 문서의 모든 기존 필드와 새 필드가 포함된 문서를 출력합니다.

$set 단계는 $addFields의 별칭입니다.

두 단계 모두 입력 문서의 모든 기존 필드를 명시적으로 지정하고 새 필드를 추가하는 $project 단계와 동일합니다.

다음 환경에서 호스팅되는 배포에 $set 사용할 수 있습니다.

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

$set 의 형식은 다음과 같습니다.

{ $set: { <newField>: <expression>, ... } }

추가할 각 필드의 이름을 설정하고 해당 값을 집계 표현식 또는 빈 객체에 설정합니다.

중요

새 필드 이름이 기존 필드 이름( _id 포함)과 일치하면 $set 해당 필드의 값을 지정된 표현식으로 덮어씁니다.

  • $set 기존 문서에 새 필드를 추가합니다. 집계 연산에 $set 단계를 1개 이상 포함시킬 수 있습니다.

  • $set을(를) 내장된 객체와 함께 사용할 수 있습니다. 집계 표현식이나 빈 객체에 값을 설정할 수 있습니다. 예를 들어 다음과 같은 중첩 객체가 허용됩니다:

    {$set: { a: { b: { } } } }

    내장된 문서(배열의 문서 포함)에 필드를 추가하려면 점 표기법을 사용합니다. 예시를 참조하세요.

  • $set을(를) 사용하여 기존 배열 필드에 요소를 추가하려면 $concatArrays을(를) 사용하세요. 예시를 참조하세요.

이 페이지의 예시는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.

다음 작업은 두 개의 $set 단계를 사용하여 출력 문서에 세 개의 새 필드를 포함합니다.

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { imdbScoreScaled: { $multiply: [ "$imdb.rating", 10 ] }, runtimeHours: { $floor: { $divide: [ "$runtime", 60 ] } } } }, { $set: { totalScore: { $add: [ "$imdbScoreScaled", "$runtimeHours" ] } } }] )
[ { _id: ..., title: 'Baseball', runtime: 1140, imdbScoreScaled: 91, runtimeHours: 19, totalScore: 110 }, { _id: ..., title: 'Centennial', runtime: 1256, imdbScoreScaled: 85, runtimeHours: 20, totalScore: 105 }]...
첫 번째 단계 ($set):
첫 번째 $set 단계는 두 개의 필드를 추가합니다. imdbScoreScaled은 IMDB 평점에 10를 곱하고, runtimeHours은 런타임을 60로 나누고 가장 가까운 정수로 내림합니다.
두 번째 단계 ($set):
두 번째 $set 단계는 totalScore을(를) 추가하며, 이는 이전 단계에서 계산된 imdbScoreScaled와(과) runtimeHours을(를) 합산합니다.

점 표기법을 사용하여 내장된 문서에 새 필드를 추가할 수 있습니다.

다음 집계 작업은 내장된 문서 imdb에 새 필드 normalizedRating 를 추가합니다.

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { "imdb.normalizedRating": { $multiply: [ "$imdb.rating", 10 ] } } }] )
[ { _id: ..., title: 'Baseball', imdb: { '...': '...', normalizedRating: 91 } }, { _id: ..., title: 'Centennial', imdb: { '...': '...', normalizedRating: 85 } }]...

다음 $set 작업은 rated 필드를 덮어씁니다.

db.movies.aggregate( [ { $match: { title: "Baseball" } }, { $set: { rated: "UNRATED" } }] )
[ { _id: ..., title: 'Baseball', rated: 'UNRATED' }]...

한 필드를 다른 필드로 바꿀 수 있습니다. 다음 작업은 _id을(를) title 필드 값으로 바꾼 다음 title을(를) string "movie"(으)로 설정합니다.

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { _id: "$title", title: "movie" } }] )
[ { _id: 'Baseball', title: 'movie' }, { _id: 'Centennial', title: 'movie' }]...

기존 배열 필드에 요소를 추가하려면, $concatArrays을 $set과 함께 사용합니다. 다음 작업은 현재 genres 배열과 [ "Classic" ]을 연결하는 새 배열로 genres 필드를 대체합니다:

db.movies.aggregate( [ { $match: { title: "Baseball" } }, { $set: { genres: { $concatArrays: [ "$genres", [ "Classic" ] ] } } }] )
[ { _id: ..., title: 'Baseball', genres: [ 'Documentary', 'History', 'Sport', 'Classic' ] }]...

다음 집계 작업은 영화 제목과 개본 연도를 연결하는 새 필드 titleWithYear 를 각 문서에 추가합니다.

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { titleWithYear: { $concat: [ "$title", " (", { $toString: "$year" }, ")" ] } } }] )
[ { _id: ..., title: 'Baseball', titleWithYear: 'Baseball (1994)' }, { _id: ..., title: 'Centennial', titleWithYear: 'Centennial (1978)' }]...

관련 단계는 $addFields를 참조하세요.

이 페이지 평가하기