Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /
표현식
Docs Home
/
개발
/
쿼리 언어
/
표현식
Docs Home
/
개발
/
쿼리 언어
/
표현식

$map (표현식 연산자)

정의

$map

배열의 각 항목에 표현식을 적용하고 결과가 적용된 배열을 반환합니다.

호환성

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

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

구문

$map 표현식의 구문은 다음과 같습니다.

{
   $map: {
      input: <expression>,
      as: <string>,
      arrayIndexAs: <string>,
      in: <expression>
   }
}
필드
사양

input

배열로 해석되는 표현식 입니다.

input 값이 null로 확인되거나 누락된 필드를 나타내는 경우 $map는 null을 반환합니다.

input이 배열과 null이 아닌 값으로 해석되면 파이프라인 오류가 발생합니다.

as

선택 사항. input 배열의 각 개별 요소를 나타내는 변수의 이름입니다. 이름을 지정하지 않으면 변수 이름은 기본적으로 this가 됩니다.

arrayIndexAs

선택 사항. 배열 에 있는 현재 요소의 인덱스 를 나타내는 집계 변수의 input 이름입니다. 첫 번째 배열 요소 인덱스 0 입니다.

표현식 에 변수 이름을 사용할 수 있습니다. 예시 들어 arrayIndexAs: "myIndex"을 지정하면 표현식 에 $$myIndex 이 사용됩니다. $$myIndex 는 input 배열 에 있는 현재 요소의 인덱스 반환합니다.

arrayIndexAs을(를) 생략하면 표현식 에 시스템 변수를 사용하여 현재 요소의 인덱스 반환할 수 있습니다.$$IDX

예제는 배열에 있는 각 항목의 인덱스에 액세스하기 및 를 $$IDX 사용하여 인덱스에 액세스하기 항목을 참조하세요.

버전 8.3에 추가 되었습니다.

in

input 배열의 각 요소에 적용되는 표현식입니다. 이 표현식은 as에 지정된 변수 이름을 사용하여 각 요소를 개별적으로 참조합니다.

표현식에 대한 자세한 내용은 표현식을 참조하세요 .

예시

배열의 각 요소에 추가

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

다음 집계 작업은 표현식 과 함께 $map $add 을(를) 사용하여 10 location.geo.coordinates 배열 의 각 요소에 을(를) 추가합니다.

db.theaters.aggregate( [
   {
      $match: {
         theaterId: { $in: [ 1000, 1003, 1008 ] }
      }
   },
   {
      $project: {
         _id: 0,
         theaterId: 1,
         adjustedCoordinates: {
            $map: {
               input: "$location.geo.coordinates",
               as: "coord",
               in: { $add: [ "$$coord", 10 ] }
            }
         }
      }
   },
   { $sort: { theaterId: 1 } }
] )
[
  { theaterId: 1000, adjustedCoordinates: [ -83.24565, 54.85466 ] },
  { theaterId: 1003, adjustedCoordinates: [ -66.512016, 48.29697 ] },
  { theaterId: 1008, adjustedCoordinates: [ -111.96328, 48.367649 ] }
]

각 배열 요소 잘라내기

다음 집계 작업은 $map truncate location.geo.coordinates ~ 를 배열 의 각 요소를 정수로 사용합니다.

db.theaters.aggregate( [
   {
      $match: {
         theaterId: { $in: [ 1000, 1003, 1008 ] }
      }
   },
   {
      $project: {
         _id: 0,
         theaterId: 1,
         integerCoordinates: {
            $map: {
               input: "$location.geo.coordinates",
               as: "coord",
               in: { $trunc: "$$coord" }
            }
         }
      }
   },
   { $sort: { theaterId: 1 } }
] )
[
  { theaterId: 1000, integerCoordinates: [ -93, 44 ] },
  { theaterId: 1003, integerCoordinates: [ -76, 38 ] },
  { theaterId: 1008, integerCoordinates: [ -121, 38 ] }
]

각 배열 요소에 산술 연산자 적용

다음 집계 작업은 단계를 사용하여 $addFields 새 필드 genreScores 추가합니다. 이 연산은 $map 를 사용하여 $multiply $add 배열 의 각 요소에 및 genres 를 적용 , 각 장르 이름의 문자 수를 기준으로 점수를 계산합니다.

db.movies.aggregate( [
  {
     $match: { runtime: { $gt: 1000 } }
  },
  {
     $addFields: {
        genreScores: {
           $map: {
              input: "$genres",
              as: "genre",
              in: {
                 $add: [
                    { $multiply: [ { $strLenCP: "$$genre" }, 2 ] },
                    1
                 ]
              }
           }
        }
     }
  },
  { $project: { _id: 0, title: 1, genres: 1, genreScores: 1 } },
  { $sort: { title: 1 } }
] )
[
  {
    genres: [ 'Documentary', 'History', 'Sport' ],
    title: 'Baseball',
    genreScores: [ 23, 15, 11 ]
  },
  {
    genres: [ 'Action', 'Adventure', 'Drama' ],
    title: 'Centennial',
    genreScores: [ 13, 19, 11 ]
  }
]

배열의 각 항목 인덱스에 액세스

movies 컬렉션 의 genres 필드 에는 각 영화에 대한 장르 이름 배열 이 포함되어 있습니다.

다음 예시 arrayIndexAs를 사용합니다. myIndex 변수는 genres 배열 에 있는 각 장르의 인덱스 가집니다. 이 예시 다음과 같은 필드가 있는 문서를 반환합니다.

  • 영화 제목입니다.

  • 장르 이름.

  • rank 필드 에 있는 genres 배열 의 장르 위치입니다.

  • isPrimary 배열 의 첫 번째 장르에 대해서는 true, 다른 장르에 대해서는 false 인 부울입니다.

db.movies.aggregate( [
   {
      $match: { runtime: { $gt: 1000 } }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         rankedGenres: {
            $map: {
               input: "$genres",
               as: "genre",
               arrayIndexAs: "myIndex",
               in: {
                  genre: "$$genre",
                  rank: { $add: [ "$$myIndex", 1 ] },
                  isPrimary: { $eq: [ "$$myIndex", 0 ] }
               }
            }
         }
      }
   },
   { $sort: { title: 1 } }
] )
[
  {
    title: 'Baseball',
    rankedGenres: [
      { genre: 'Documentary', rank: 1, isPrimary: true },
      { genre: 'History', rank: 2, isPrimary: false },
      { genre: 'Sport', rank: 3, isPrimary: false }
    ]
  },
  {
    title: 'Centennial',
    rankedGenres: [
      { genre: 'Action', rank: 1, isPrimary: true },
      { genre: 'Adventure', rank: 2, isPrimary: false },
      { genre: 'Drama', rank: 3, isPrimary: false }
    ]
  }
]

를 $$IDX 사용하여 인덱스에 액세스

$$IDX 변수는 배열 에 있는 현재 요소의 인덱스 input 를 반환합니다.$$IDX 표현식 arrayIndexAs 에서 필드 생략한 경우 를 사용할 수 있습니다.

다음 예시 배열의 각 항목 인덱스에 액세스하기의 이전 예시 와 동일한 문서를 반환하지만 대신 $$IDX 을 arrayIndexAs 사용합니다.

db.movies.aggregate( [
   {
      $match: { runtime: { $gt: 1000 } }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         rankedGenres: {
            $map: {
               input: "$genres",
               as: "genre",
               in: {
                  genre: "$$genre",
                  rank: { $add: [ "$$IDX", 1 ] },
                  isPrimary: { $eq: [ "$$IDX", 0 ] }
               }
            }
         }
      }
   },
   { $sort: { title: 1 } }
] )
[
  {
    title: 'Baseball',
    rankedGenres: [
      { genre: 'Documentary', rank: 1, isPrimary: true },
      { genre: 'History', rank: 2, isPrimary: false },
      { genre: 'Sport', rank: 3, isPrimary: false }
    ]
  },
  {
    title: 'Centennial',
    rankedGenres: [
      { genre: 'Action', rank: 1, isPrimary: true },
      { genre: 'Adventure', rank: 2, isPrimary: false },
      { genre: 'Drama', rank: 3, isPrimary: false }
    ]
  }
]

자세히 알아보기

이전 예시에서 사용된 표현식에 대해 자세히 알아보려면 다음을 참조하세요.

돌아가기

$ltrim

다음

$maxN-array-element

이 페이지의 내용