MongoDB 문서에서 배열 항목 조회하기
MongoDB 문서 내부에 저장된 배열(array)의 특정 항목을 조회하려면 점(.) 표기법(dot notation)을 사용하면 됩니다. 점 표기법은 배열 필드 이름과 그 안의 하위 필드를 마침표로 연결하여 중첩된 데이터에 접근할 수 있게 해주는 MongoDB의 기본 문법입니다.
이번 글에서는 실제 예제를 통해 점 표기법으로 배열 항목을 조회하는 방법을 단계별로 살펴보겠습니다.
1단계: 샘플 컬렉션 생성
먼저 학생 정보가 담긴 배열을 포함한 문서로 컬렉션을 생성해 보겠습니다. insertOne() 메서드를 사용합니다.
> db.demo29.insertOne({"StudentDetails":[{"StudentName":"Chris","StudentMarks":58},{"StudentName":"Bob","StudentMarks":69}]});
{
"acknowledged" : true,
"insertedId" : ObjectId("5e15fcc08f2315c2efc48e6e")
}
> db.demo29.insertOne({"StudentDetails":[{"StudentName":"David","StudentMarks":97},{"StudentName":"Carol","StudentMarks":96}]});
{
"acknowledged" : true,
"insertedId" : ObjectId("5e15fcd38f2315c2efc48e6f")
}위 쿼리에서는 demo29라는 컬렉션에 두 개의 문서를 삽입했습니다. 각 문서는 StudentDetails라는 배열 필드를 가지고 있으며, 배열 안에는 학생 이름(StudentName)과 점수(StudentMarks)로 구성된 객체들이 들어 있습니다.
2단계: 전체 문서 확인하기
find() 메서드와 pretty() 메서드를 함께 사용하면 컬렉션의 모든 문서를 보기 좋게 출력할 수 있습니다.
> db.demo29.find().pretty();
실행 결과는 다음과 같습니다.
{
"_id" : ObjectId("5e15fcc08f2315c2efc48e6e"),
"StudentDetails" : [
{
"StudentName" : "Chris",
"StudentMarks" : 58
},
{
"StudentName" : "Bob",
"StudentMarks" : 69
}
]
}
{
"_id" : ObjectId("5e15fcd38f2315c2efc48e6f"),
"StudentDetails" : [
{
"StudentName" : "David",
"StudentMarks" : 97
},
{
"StudentName" : "Carol",
"StudentMarks" : 96
}
]
}3단계: 점 표기법으로 배열 내 특정 항목 조회하기
이제 본격적으로 점 표기법을 사용하여 배열 안의 특정 값을 조건으로 검색해 보겠습니다. 아래 쿼리는 StudentDetails 배열 내 객체의 StudentName 값이 "David"인 문서를 찾습니다.
> db.demo29.find({"StudentDetails.StudentName":"David"});실행 결과는 다음과 같습니다.
{ "_id" : ObjectId("5e15fcd38f2315c2efc48e6f"), "StudentDetails" : [ { "StudentName" : "David", "StudentMarks" : 97 }, { "StudentName" : "Carol", "StudentMarks" : 96 } ] }결과 분석 및 핵심 정리
쿼리 결과를 보면 StudentName이 "David"인 항목을 포함한 두 번째 문서만 반환된 것을 확인할 수 있습니다. 여기서 주목할 점은 MongoDB가 조건과 일치하는 문서 전체를 반환한다는 것입니다. 즉, 같은 배열에 속한 "Carol"의 데이터도 함께 출력됩니다.
배열 내 일치하는 요소만 추출하고 싶다면 $elemMatch 연산자나 집계 파이프라인의 $filter, $unwind 등을 추가로 활용하면 됩니다.
- 점 표기법:
"필드명.하위필드명"형태로 배열 내 객체의 값에 접근 - find() 조건: 배열 내 어떤 요소든 조건과 일치하면 해당 문서 반환
- 반환 단위: 기본적으로 문서 전체가 반환되며, 특정 요소만 원할 경우 추가 연산자 필요
점 표기법은 MongoDB에서 중첩된 데이터를 다루는 가장 기본적이면서도 강력한 방법이므로, 반드시 숙지해 두시기 바랍니다.