unwind (집계 단계)

정의

$unwind: 입력 문서에서 배열 필드를 분해해 각 요소에 대한 문서를 출력합니다. 각 출력 문서는 배열 필드의 값이 요소로 대체된 입력 문서입니다.

호환성

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

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

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

필드 경로 피연산자 또는 문서 피연산자를 전달하여 배열 필드를 해제합니다.

필드 경로 피연산자

$unwind에 배열 필드 경로를 전달할 수 있습니다. 이 구문을 사용할 때 $unwind은(는) 필드 값이 null이거나 누락되었거나 빈 배열인 경우 문서를 출력하지 않습니다.

{ $unwind: <field path> }

필드 경로를 지정할 때 필드 이름 앞에 달러 기호 $를 붙이고 따옴표로 묶습니다.

옵션이 있는 문서 피연산자

$unwind에 문서를 전달하여 옵션을 지정할 수 있습니다.

{  $unwind:    {      path: <field path>,      includeArrayIndex: <string>,      preserveNullAndEmptyArrays: <boolean>    }}

필드	유형	설명
경로	문자열	배열 필드의 필드 경로입니다. 필드 경로를 지정하려면 필드 이름 앞에 달러 기호 `$`를 붙이고 따옴표로 묶습니다.
includeArrayIndex	문자열	선택 사항. 요소의 배열 인덱스를 저장할 새 필드의 이름입니다. 이름은 달러 기호 `$`로 시작할 수 없습니다.
preserveNullAndEmptyArrays	부울	선택 사항. `true`, `path` 이 누락되었거나 빈 배열 인 경우 `$unwind` 는 출력 문서 에서 출력 필드 생략합니다. 값이 `null`인 경우 필드 `null`로 유지됩니다. `false`, `path` 이 null이거나 누락되었거나 빈 배열 인 경우 `$unwind` 는 문서 출력하지 않습니다. 기본값은 `false`입니다.

동작

Non-Array Field Path(비배열 필드 경로)

path 의 값이 배열 로 해석되지 않으면 $unwind 은 다음과 같이 동작합니다.

값이 누락되지 않았거나 null이 아니며 빈 배열 아닌 경우 $unwind 는 값을 있는 그대로 사용하여 단일 문서 출력합니다.
includeArrayIndex 를 지정하면 배열 입력의 경우 인덱스 가 0, 비배열 입력의 경우 null 가 됩니다. 목록의 뒷부분에 있는 문서의 인덱스 가 0보다 큽니다.
값이 누락되었거나 null이거나 빈 배열 인 경우 $unwind 은 preserveNullAndEmptyArrays 옵션 뒤에 옵니다. includeArrayIndex 가 지정되고 문서 보존되는 경우 인덱스 는 null입니다.

누락된 필드

입력 문서에 존재하지 않는 필드의 경로를 지정하거나 필드가 빈 배열인 경우 $unwind은 기본적으로 입력 문서를 무시하고 해당 입력 문서에 대한 문서를 출력하지 않습니다.

배열 필드가 누락되었거나, 널 또는 빈 배열이 있는 문서를 출력하려면 preserveNullAndEmptyArrays 옵션을 사용합니다.

예시

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

배열 Unwind

다음 집계는 $unwind 단계를 사용하여 Inception 영화 문서의 genres 배열에 있는 각 요소에 대한 문서를 출력합니다.

db.movies.aggregate( [  { $match: { title: "Inception" } },  { $project: { _id: 0, title: 1, genres: 1 } },  { $unwind: "$genres" }] )

[  {    genres: 'Action',    title: 'Inception'  },  {    genres: 'Mystery',    title: 'Inception'  },  {    genres: 'Sci-Fi',    title: 'Inception'  }]

각 출력 문서는 이제 원래 genres 배열의 단일 요소를 보유하는 genres 필드의 값을 제외하고 입력 문서와 동일합니다.

누락되었거나 배열이 아닌 값

다음 집계는 4개의 영화 문서와 함께 $unwind 단계를 사용합니다. 문서 중 2개("La porta del cielo" 및 "Neecha Nagar")에는 genres 필드가 없습니다.

db.movies.aggregate( [  {    $match: {      title: {        $in: [          "Inception",          "Brave",          "La porta del cielo",          "Neecha Nagar"        ]      }    }  },  { $project: { _id: 0, title: 1, genres: 1 } },  { $unwind: { path: "$genres" } }] )

[  {    genres: 'Animation',    title: 'Brave'  },  {    genres: 'Adventure',    title: 'Brave'  },  {    genres: 'Comedy',    title: 'Brave'  },  {    genres: 'Action',    title: 'Inception'  },  {    genres: 'Mystery',    title: 'Inception'  },  {    genres: 'Sci-Fi',    title: 'Inception'  }]

"Brave" 및 "Inception" 문서에서 genres는 채워진 배열입니다. $unwind은 각 요소에 대한 문서를 반환합니다.
"La porta del cielo" 및 "Neecha Nagar" 문서에는 genres 필드가 없으므로 $unwind은(는) 해당 문서에 대해 아무것도 반환하지 않습니다.

참고

{ path: <FIELD> } 구문은 선택 사항입니다. 다음 $unwind 작업은 동일합니다.

db.<COLLECTION>.aggregate(  [ { $unwind: "<FIELD>" } ])

db.<COLLECTION>.aggregate(  [ { $unwind: { path: "<FIELD>" } } ])

preserveNullAndEmptyArrays 및 includeArrayIndex

preserveNullAndEmptyArrays 및 includeArrayIndex 예시에서는 sample_mflix.movies 컬렉션의 문서를 사용합니다.

preserveNullAndEmptyArrays

다음 $unwind 작업은 preserveNullAndEmptyArrays 옵션을 사용하여 genres 필드가 누락된 문서를 포함합니다.

db.movies.aggregate( [  {    $match: {      title: {        $in: [          "Inception",          "Brave",          "La porta del cielo",          "Neecha Nagar"        ]      }    }  },  { $project: { _id: 0, title: 1, genres: 1 } },  {    $unwind: {      path: "$genres",      preserveNullAndEmptyArrays: true    }  }] )

[  {    title: 'La porta del cielo'  },  {    title: 'Neecha Nagar'  },  {    genres: 'Animation',    title: 'Brave'  },  {    genres: 'Adventure',    title: 'Brave'  },  {    genres: 'Comedy',    title: 'Brave'  },  {    genres: 'Action',    title: 'Inception'  },  {    genres: 'Mystery',    title: 'Inception'  },  {    genres: 'Sci-Fi',    title: 'Inception'  }]

includeArrayIndex

다음 $unwind 작업은 includeArrayIndex 옵션을 사용하여 출력에 배열 인덱스를 포함합니다.

db.movies.aggregate( [  { $match: { title: "Inception" } },  { $project: { _id: 0, title: 1, genres: 1 } },  {    $unwind: {      path: "$genres",      includeArrayIndex: "genreIndex"    }  }] )

[  {    genres: 'Action',    title: 'Inception',    genreIndex: Long('0')  },  {    genres: 'Mystery',    title: 'Inception',    genreIndex: Long('1')  },  {    genres: 'Sci-Fi',    title: 'Inception',    genreIndex: Long('2')  }]

Unwound 값으로 그룹화

다음 파이프라인은 genres 배열을 풀고 결과 문서를 장르별로 그룹화하여 각 장르의 영화 수를 계산합니다.

db.movies.aggregate( [  // First Stage  {    $match: {      title: {        $in: [          "The Dark Knight",          "Inception",          "Interstellar",          "Brave"        ]      }    }  },  // Second Stage  { $project: { _id: 0, title: 1, genres: 1 } },  // Third Stage  { $unwind: "$genres" },  // Fourth Stage  {    $group: {      _id: "$genres",      movieCount: { $sum: 1 }    }  },  // Fifth Stage  { $sort: { movieCount: -1 } }] )

[  {    _id: 'Adventure',    movieCount: 2  },  {    _id: 'Action',    movieCount: 2  },  {    _id: 'Drama',    movieCount: 2  },  {    _id: 'Sci-Fi',    movieCount: 2  },  {    _id: 'Crime',    movieCount: 1  },  {    _id: 'Animation',    movieCount: 1  },  {    _id: 'Comedy',    movieCount: 1  },  {    _id: 'Mystery',    movieCount: 1  }]

다중 배열 필드 언운드

단일 파이프라인에서 $unwind을(를) 여러 번 적용하여 여러 배열 필드가 포함된 문서를 확장할 수 있습니다. 다음 작업은 genres 배열을 언와인드한 다음 cast 배열을 언와인드하여 모든 장르-배우 조합에 대한 플랫 문서를 생성한 다음, 장르별로 그룹화하여 각 장르의 총 출연 횟수를 계산합니다.

db.movies.aggregate( [  // First Stage  {    $match: {      title: {        $in: [ "Inception", "The Dark Knight", "Interstellar" ]      }    }  },  // Second Stage  { $project: { _id: 0, title: 1, genres: 1, cast: 1 } },  // Third Stage  { $unwind: "$genres" },  // Fourth Stage  { $unwind: "$cast" },  // Fifth Stage  {    $group: {      _id: "$genres",      castAppearances: { $sum: 1 }    }  }] )

[  {    _id: 'Adventure',    castAppearances: 4  },  {    _id: 'Crime',    castAppearances: 4  },  {    _id: 'Action',    castAppearances: 8  },  {    _id: 'Drama',    castAppearances: 8  },  {    _id: 'Mystery',    castAppearances: 4  },  {    _id: 'Sci-Fi',    castAppearances: 8  }]

이 페이지의 C# 예제에서는 Atlas 샘플 데이터 세트의 sample_mflix 데이터베이스 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB .NET/ C# 드라이버 문서에서 시작하기 를 참조하세요.

다음 Movie 클래스는 sample_mflix.movies 컬렉션의 문서를 모델링합니다.

public class Movie{    public ObjectId Id { get; set; }
    public int Runtime { get; set; }        public string Title { get; set; }
    public string Rated { get; set; }
    public List<string> Genres { get; set; }
    public string Plot { get; set; }        public ImdbData Imdb { get; set; }
    public int Year { get; set; }
    public int Index { get; set; }        public string[] Comments { get; set; }       [BsonElement("lastupdated")]    public DateTime LastUpdated { get; set; }}

참고

Pascal Case를 위한 ConventionPack

이 페이지의 C# 클래스는 속성 이름에 파스칼 표기법을 사용하지만, MongoDB 컬렉션의 필드 이름은 카멜 표기법을 사용합니다. 이 차이를 해결하기 위해 애플리케이션이 시작될 때 다음 코드를 사용하여 ConventionPack을 등록할 수 있습니다.

var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };ConventionRegistry.Register("CamelCase", camelCaseConvention, type => true);

MongoDB .NET/ C# 운전자 사용하여 $unwind 집계 파이프라인 에 단계를 추가하려면 PipelineDefinition 객체 에서 Unwind() 메서드를 호출합니다.

다음 예시 각 입력 Movie 문서 의 Genres 필드 반복하는 파이프라인 단계를 만듭니다. Genres 필드 의 각 값에 대해 스테이지에서는 새 Movie 문서 만들고 해당 Genres 필드 입력 문서 의 Genres 값으로 채웁니다.

var pipeline = new EmptyPipelineDefinition<Movie>()    .Unwind(m => m.Genres);

AggregateUnwindOptions 객체를 사용하여 Unwind() 메서드의 동작을 사용자 지정할 수 있습니다.

다음 예시 이전 예시 와 동일한 작업을 수행하지만 다음 옵션도 포함되어 있습니다.

PreserveNullAndEmptyArrays Genres 필드 에 빈 배열 포함된 문서가 출력에 포함되도록 합니다.
IncludeArrayIndex 옵션은 각 출력 문서 에 Index 라는 새 필드 추가합니다. 이 필드 의 값은 입력 문서의 Genres 배열 에 있는 Genres 필드 값의 배열 인덱스 입니다.

var pipeline = new EmptyPipelineDefinition<Movie>()    .Unwind(m => m.Genres,        new AggregateUnwindOptions<Movie>()        {            PreserveNullAndEmptyArrays = true,            IncludeArrayIndex = new ExpressionFieldDefinition<Movie, int>(               m => m.Index)        });

이 페이지의 Node.js 예제에서는 Atlas 샘플 데이터 세트의 sample_mflix 데이터베이스 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB Node.js 운전자 설명서에서 시작하기 를 참조하세요.

MongoDB Node.js 운전자 사용하여 집계 파이프라인 에 $unwind 단계를 추가하려면 파이프라인 객체 에서 $unwind 연산자 사용합니다.

다음 예시 각 입력 movie 문서 의 genres 필드 반복하는 파이프라인 단계를 만듭니다. genres 필드 의 각 값에 대해 스테이지에서는 새 movie 문서 만들고 해당 genres 필드 입력 문서 의 genres 값으로 채웁니다. 그런 다음 이 예시 에서는 집계 파이프라인 실행합니다.

const pipeline = [{ $unwind: "$genres" }];
const cursor = collection.aggregate(pipeline);return cursor;

$unwind 메서드의 동작을 사용자 지정할 수 있습니다. 다음 예시 이전 예시 와 동일한 작업을 수행하지만 다음 옵션도 포함되어 있습니다.

preserveNullAndEmptyArrays genres 필드 에 빈 배열 포함된 문서가 출력에 포함되도록 합니다.
includeArrayIndex 각 출력 문서 에 index 이라는 새 필드 추가합니다. 이 필드 에는 입력 문서의 genres 필드 에 있는 genres 값의 배열 인덱스 포함되어 있습니다.

const pipeline = [  {    $unwind: {      path: "$genres",      preserveNullAndEmptyArrays: true,      includeArrayIndex: "index"    }  }];
const cursor = collection.aggregate(pipeline);return cursor;

자세히 알아보기

관련 단계 및 표현식은 $group, $sum, $sort 및 $multiply을(를) 참조하세요.

전체 예시는 배열 및 그룹 데이터 풀기 튜토리얼을 참조하세요.

돌아가기

$unset

$vectorSearch