자습서: Azure Cosmos DB for NoSQL의 데이터 쿼리

아티클
08/15/2024

적용 대상: NoSQL

Azure Cosmos DB for NoSQL은 기본 제공 쿼리 구문을 사용하는 문서 쿼리를 지원합니다. 이 문서에서는 샘플 문서 및 두 가지 샘플 SQL 쿼리와 결과를 제공합니다.

이 문서에서 다루는 작업은 다음과 같습니다.

기본 제공 쿼리 구문을 사용하여 NoSQL 데이터 쿼리

필수 조건

이 자습서에서는 Azure Cosmos DB 계정, 데이터베이스 및 컨테이너를 사용한다고 가정합니다.

이러한 리소스가 없나요? 이 빠른 시작: Azure Portal에서 Azure Cosmos DB 계정, 데이터베이스, 컨테이너 및 항목 만들기를 완료합니다.

Azure Portal에서 Azure Cosmos DB Explorer를 사용하여 쿼리를 실행할 수 있습니다. REST API 또는 다양한 SDK를 사용하여 쿼리를 실행할 수도 있습니다.

쿼리에 대한 자세한 내용은 쿼리 시작을 참조 하세요.

샘플 문서

이 문서의 쿼리에서는 다음 샘플 문서를 사용합니다.

{
  "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
}

모든 필드를 선택하고 필터 적용

샘플 가족 문서를 고려해 볼 때 다음 쿼리에서는 ID 필드가 WakefieldFamily와 일치하는 문서를 반환합니다. SELECT * 문이므로 쿼리 결과는 완전한 JSON 문서입니다.

쿼리:

SELECT * 
FROM Families f 
WHERE f.id = "WakefieldFamily"

결과:

{
  "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
}

자식 컬렉션 필드의 제품 간 선택

다음 쿼리에서는 ID가 WakefieldFamily와 일치하는 가족의 지정된 모든 자식 이름을 반환합니다.

쿼리:

SELECT c.givenName 
FROM Families f 
JOIN c IN f.children 
WHERE f.id = 'WakefieldFamily'

결과:

[
  {
    "givenName": "Jesse"
  },
  {
    "givenName": "Lisa"
  }
]

다음 단계

이 자습서에서는 다음 작업을 수행했습니다.

기본 제공 쿼리 구문을 사용하여 쿼리하는 방법을 알아보았습니다.

이제 전 세계로 데이터를 배포하는 방법을 알아보려면 다음 자습서로 진행할 수 있습니다.

전 세계로 데이터 배포

다음을 통해 공유