Azure Cosmos DB의 API for MongoDB를 사용하여 데이터 쿼리Query data by using Azure Cosmos DB's API for MongoDB

적용 대상: Azure Cosmos DB API for MongoDB

Azure Cosmos DB의 API for MongoDBMongoDB 쿼리를 지원합니다.The Azure Cosmos DB's API for MongoDB supports MongoDB queries.

이 문서에서 다루는 작업은 다음과 같습니다.This article covers the following tasks:

  • MongoDB 셸을 사용하여 Cosmos 데이터베이스에 저장된 데이터 쿼리Querying data stored in your Cosmos database using MongoDB shell

이 문서의 예제를 사용하여 시작하고 MongoDB 셸을 사용하여 Azure Cosmos DB 쿼리 비디오를 시청할 수 있습니다.You can get started by using the examples in this document and watch the Query Azure Cosmos DB with MongoDB shell video .

샘플 문서Sample document

이 문서의 쿼리에서는 다음 샘플 문서를 사용합니다.The queries in this article use the following sample document.

{
  "id": "WakefieldFamily",
  "parents": [
      { "familyName": "Wakefield", "givenName": "Robin" },
      { "familyName": "Miller", "givenName": "Ben" }
  ],
  "children": [
      {
        "familyName": "Merriam", 
        "givenName": "Jesse", 
        "gender": "female", "grade": 1,
        "pets": [
            { "givenName": "Goofy" },
            { "givenName": "Shadow" }
        ]
      },
      { 
        "familyName": "Miller", 
         "givenName": "Lisa", 
         "gender": "female", 
         "grade": 8 }
  ],
  "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
  "creationDate": 1431620462,
  "isRegistered": false
}

예제 쿼리 1Example query 1

위의 샘플 가족 문서를 고려해 볼 때 다음 쿼리에서는 ID 필드가 WakefieldFamily와 일치하는 문서를 반환합니다.Given the sample family document above, the following query returns the documents where the id field matches WakefieldFamily.

쿼리Query

db.families.find({ id: "WakefieldFamily"})

결과Results

{
    "_id": "ObjectId(\"58f65e1198f3a12c7090e68c\")",
    "id": "WakefieldFamily",
    "parents": [
      {
        "familyName": "Wakefield",
        "givenName": "Robin"
      },
      {
        "familyName": "Miller",
        "givenName": "Ben"
      }
    ],
    "children": [
      {
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
        ]
      },
      {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
      }
    ],
    "address": {
      "state": "NY",
      "county": "Manhattan",
      "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

예제 쿼리 2Example query 2

다음 쿼리에서는 가족의 모든 자식을 반환합니다.The next query returns all the children in the family.

쿼리Query

db.families.find( { id: "WakefieldFamily" }, { children: true } )

결과Results

{
    "_id": "ObjectId("58f65e1198f3a12c7090e68c")",
    "children": [
      {
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
        ]
      },
      {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
      }
    ]
}

예제 쿼리 3Example query 3

다음 쿼리는 등록된 모든 가족을 반환합니다.The next query returns all the families that are registered.

쿼리Query

db.families.find( { "isRegistered" : true })

결과Results

문서가 반환되지 않습니다.No document will be returned.

예제 쿼리 4Example query 4

다음 쿼리는 등록되지 않은 모든 가족을 반환합니다.The next query returns all the families that are not registered.

쿼리Query

db.families.find( { "isRegistered" : false })

결과Results

{
    "_id": ObjectId("58f65e1198f3a12c7090e68c"),
    "id": "WakefieldFamily",
    "parents": [{
        "familyName": "Wakefield",
        "givenName": "Robin"
    }, {
        "familyName": "Miller",
        "givenName": "Ben"
    }],
    "children": [{
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [{
            "givenName": "Goofy"
        }, {
            "givenName": "Shadow"
        }]
    }, {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
    }],
    "address": {
        "state": "NY",
        "county": "Manhattan",
        "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

예제 쿼리 5Example query 5

다음 쿼리는 등록되지 않았고 거주 지역(주)이 NY인 가족을 모두 반환합니다.The next query returns all the families that are not registered and state is NY.

쿼리Query

db.families.find( { "isRegistered" : false, "address.state" : "NY" })

결과Results

{
    "_id": ObjectId("58f65e1198f3a12c7090e68c"),
    "id": "WakefieldFamily",
    "parents": [{
        "familyName": "Wakefield",
        "givenName": "Robin"
    }, {
        "familyName": "Miller",
        "givenName": "Ben"
    }],
    "children": [{
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [{
            "givenName": "Goofy"
        }, {
            "givenName": "Shadow"
        }]
    }, {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
    }],
    "address": {
        "state": "NY",
        "county": "Manhattan",
        "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

예제 쿼리 6Example query 6

다음 쿼리에서는 자식(children)의 학년(grade)이 8인 모든 가족을 반환합니다.The next query returns all the families where children grades are 8.

쿼리Query

db.families.find( { children : { $elemMatch: { grade : 8 }} } )

결과Results

{
    "_id": ObjectId("58f65e1198f3a12c7090e68c"),
    "id": "WakefieldFamily",
    "parents": [{
        "familyName": "Wakefield",
        "givenName": "Robin"
    }, {
        "familyName": "Miller",
        "givenName": "Ben"
    }],
    "children": [{
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [{
            "givenName": "Goofy"
        }, {
            "givenName": "Shadow"
        }]
    }, {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
    }],
    "address": {
        "state": "NY",
        "county": "Manhattan",
        "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

예제 쿼리 7Example query 7

다음 쿼리에서는 children 배열의 크기가 3인 모든 가족을 반환합니다.The next query returns all the families where size of children array is 3.

쿼리Query

db.Family.find( {children: { $size:3} } )

결과Results

자식이 셋 이상인 가족이 없으므로 결과가 반환되지 않습니다.No results will be returned as there are no families with more than two children. 매개 변수가 2일 때만 이 쿼리가 성공하여 전체 문서를 반환합니다.Only when parameter is 2 this query will succeed and return the full document.

다음 단계Next steps

이 자습서에서는 다음을 수행했습니다.In this tutorial, you've done the following:

  • Cosmos DB의 API for MongoDB를 사용하여 쿼리하는 방법을 알아보았습니다.Learned how to query using Cosmos DB’s API for MongoDB

이제 전 세계로 데이터를 배포하는 방법을 알아보려면 다음 자습서로 진행할 수 있습니다.You can now proceed to the next tutorial to learn how to distribute your data globally.