문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

$push

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 행동
  • 수정자
  • 예제

정의

$push

$push 연산자는 지정된 값을 배열에 추가합니다.

호환성

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

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

구문

$push 연산자의 형식은 다음과 같습니다.

{ $push: { <field1>: <value1>, ... } }

포함된 문서나 배열에 <field> 기호를 지정하려면 점 표기법을사용하십시오.

행동

MongoDB 5.0부터 업데이트 연산자는 문자열 기반 이름이 있는 문서 필드를 사전순으로 처리합니다. 숫자 이름이 있는 필드는 숫자 순서대로 처리됩니다. 자세한 내용은 업데이트 운영자 동작을 참조하십시오.

업데이트할 문서에 필드가 없는 경우 $push 는 값을 요소로 하는 배열 필드를 추가합니다.

필드가 배열이 아닌 경우 작업이 실패합니다.

값이 배열인 경우 $push 는 전체 배열을 단일 요소로 추가합니다. 값의 각 요소를 개별적으로 추가하려면 $each 수정자를 $push 과 함께 사용합니다. 예제 는 여러 문서의 배열에 값 추가하기를 참조하세요. $push 에 사용할 수 있는 수정자 목록은 수정자를 참조하세요 .

MongoDB 5 부터 시작.0, mongod 는 빈 피연산자 표현식( { } )과 함께 $push 과 같은 업데이트 연산자를 사용할 때 더 이상 오류를 발생시키지 않습니다. 빈 업데이트는 변경 사항이 없으며 oplog 항목이 생성되지 않습니다(즉, 작업이 작동하지 않음을 의미합니다).

수정자

$push 연산자를 다음 수정자와 함께 사용할 수 있습니다.

수정자
설명
$each
배열 필드에 여러 값을 추가합니다.
$slice
배열 요소의 수를 제한합니다. $each 수정자를 사용해야 합니다.
$sort
배열의 요소를 정렬합니다. $each 수정자를 사용해야 합니다.
$position
배열에서 새 요소를 삽입할 위치를 지정합니다. $each 수정자를 사용해야 합니다. $position 수정자가 없으면 $push 는 배열의 끝에 요소를 추가합니다.

수정자와 함께 사용되는 경우 $push 연산자는 다음과 같은 형식을 갖습니다.

{ $push: { <field1>: { <modifier1>: <value1>, ... }, ... } }

수정자를 사용한 $push 작업의 처리는 수정자가 표시되는 순서에 관계없이 다음과 같은 순서로 발생합니다.

  1. 배열을 업데이트하여 올바른 위치에 요소를 추가합니다.

  2. 지정한 경우 정렬을 적용합니다.

  3. 지정한 경우 배열을 슬라이스합니다.

  4. 배열을 저장합니다.

예제

students 컬렉션을 생성합니다.

db.students.insertOne( { _id: 1, scores: [ 44, 78, 38, 80 ] } )

배열에 값 추가하기

다음 예제에서는 scores 배열에 89 을 추가합니다:

db.students.updateOne(
   { _id: 1 },
   { $push: { scores: 89 } }
)

출력 예시:

{ _id: 1, scores: [ 44, 78, 38, 80, 89 ] }

여러 문서의 배열에 값 추가

다음 문서를 students 컬렉션에 추가합니다:

db.students.insertMany( [
   { _id: 2, scores: [ 45, 78, 38, 80, 89 ] } ,
   { _id: 3, scores: [ 46, 78, 38, 80, 89 ] } ,
   { _id: 4, scores: [ 47, 78, 38, 80, 89 ] }
] )

다음 $push 작업은 각 문서의 scores 배열에 95 를 추가합니다.

db.students.updateMany(
   { },
   { $push: { scores: 95 } }
)

각 scores 배열에 95이(가) 포함되어 있는지 확인하려면 다음 작업을 실행합니다:

db.students.find()

이 연산은 다음과 같은 결과를 반환합니다.

[
   { _id: 1, scores: [ 44, 78, 38, 80, 89, 95 ] },
   { _id: 2, scores: [ 45, 78, 38, 80, 89, 95 ] },
   { _id: 3, scores: [ 46, 78, 38, 80, 89, 95 ] },
   { _id: 4, scores: [ 47, 78, 38, 80, 89, 95 ] }
]

배열에 여러 값 추가하기

$push $each 배열 필드에 여러 값을 추가하려면 수정자와 함께 을 사용합니다.

다음 예시에서는 name 필드가 joe 인 문서의 scores 배열에 각 [ 90, 92, 85 ] 요소를 추가합니다.

db.students.updateOne(
   { name: "joe" },
   { $push: { scores: { $each: [ 90, 92, 85 ] } } }
)

여러 수정자와 함께 $push 연산자 사용

다음 문서를 students 컬렉션에 추가합니다:

db.students.insertOne(
   {
      "_id" : 5,
      "quizzes" : [
         { "wk": 1, "score" : 10 },
         { "wk": 2, "score" : 8 },
         { "wk": 3, "score" : 5 },
         { "wk": 4, "score" : 6 }
      ]
   }
)

다음 $push 작업은 다음을 사용합니다.

  • quizzes 배열에 여러 문서를 추가하는 $each 수정자,

  • 수정된 quizzes 배열의 모든 요소를 score 필드를 기준으로 내림차순으로 정렬하는 $sort 수정자, 그리고

  • quizzes배열의 처음 3개의 정렬된 요소만 유지하기 위해 사용하는 $slice 수정자.

db.students.updateOne(
   { _id: 5 },
   {
     $push: {
       quizzes: {
          $each: [ { wk: 5, score: 8 }, { wk: 6, score: 7 }, { wk: 7, score: 6 } ],
          $sort: { score: -1 },
          $slice: 3
       }
     }
   }
)

작업 후에는 가장 높은 점수를 받은 세 개의 퀴즈만 배열에 표시됩니다:

{
  "_id" : 5,
  "quizzes" : [
     { "wk" : 1, "score" : 10 },
     { "wk" : 2, "score" : 8 },
     { "wk" : 5, "score" : 8 }
  ]
}

팁

다음도 참조하세요.

← $pull
$pullAll →

이 페이지의 내용