Atlas SQL 문을 사용한 쿼리

SELECT 문

SELECT * FROM sessions;

Atlas SQL이 Sessions 컬렉션의 모든 문서를 반환합니다.

LIMIT 문

SELECT * FROM users LIMIT 2;

Atlas SQL이 Users 컬렉션에서 두 개의 문서를 반환합니다.

WHERE 문

SELECT * FROM users WHERE name = 'Jon Snow';

Atlas SQL은 사용자의 name이 Jon Snow인 Users 컬렉션에서 문서를 반환합니다.

FLATTEN

FLATTEN 반구조화된 데이터(JSON의 이름-값 쌍)를 별도의 열로 평탄화합니다. 필드 이름은 해당 필드의 모든 값을 행에 담는 열 이름이 됩니다.

중첩된 문서를 평면화하는 구문은 FROM 절에서 데이터 원본 및 옵션과 함께 사용할 수 있는 FLATTEN 함수입니다.

SELECT *
FROM FLATTEN(<data source>
 WITH DEPTH => <integer>,
 SEPARATOR => <string>
)

평면화 예시

예시 시나리오에서 customerInfo 컬렉션에는 다음과 같이 구성된 문서가 포함되어 있습니다.

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  }
}

SELECT * FROM customerInfo 쿼리를 실행하면 Atlas SQL은 다음과 같은 최상위 필드가 있는 문서를 반환합니다.

SELECT * FROM FLATTEN(customerInfo) 쿼리를 실행하면 Atlas SQL은 다음과 같은 최상위 필드가 있는 문서를 반환합니다.

FLATTEN을 사용하면 원본 문서의 각 평면화된 필드가 결과 집합의 최상위 필드가 됩니다. 중첩 필드는 상위 필드 이름과 연결되며 기본 구분 기호인 _로 구분됩니다.

Unwind

UNWIND 입력 데이터 소스에서 배열 필드를 분해하여 해당 배열의 각 항목에 대해 하나의 행을 출력합니다. 언와인드에 대해 자세히 알아보려면 $unwind 애그리게이션 단계 문서를 참조하세요.

배열 필드를 푸는 구문은 FROM 절에서 데이터 소스 및 옵션과 함께 사용할 수 있는 UNWIND 함수입니다.

SELECT *
FROM UNWIND(<data source>
 WITH PATH => <array_path>,
 INDEX => <identifier>,
 OUTER => <bool>
)

풀기(unwind) 예시

예시 시나리오에서 customerInfo 컬렉션에는 다음과 같이 구성된 문서가 포함되어 있습니다.

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

SELECT * FROM customerInfo 쿼리를 실행하면 Atlas SQL은 다음과 같은 최상위 필드가 있는 문서를 반환합니다.

SELECT * FROM UNWIND(customerInfo WITH PATH => visits, INDEX => idx) 쿼리를 실행하면 Atlas SQL은 다음과 같은 최상위 필드가 있는 문서를 반환합니다.

UNWIND를 PATH => visits와 함께 사용하면 각 visits 객체가 테이블 행이 됩니다.

FLATTEN 및 UNwind 결합 예시

다음 예시는 FLATTEN 및 UNWIND 함수를 결합한 것입니다.

예시 시나리오에서 customerInfo 컬렉션에는 다음과 같이 구성된 문서가 포함되어 있습니다.

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

SELECT * FROM customerInfo 쿼리를 실행하면 Atlas SQL은 다음과 같은 최상위 필드가 있는 문서를 반환합니다.

Select * from FLATTEN(UNWIND(customerInfo WITH PATH => visits, INDEX => idx)) 쿼리를 실행하면 Atlas SQL은 다음과 같은 최상위 필드가 있는 문서를 반환합니다.

FLATTEN 함수와 UNWIND 함수를 모두 사용하면 visits 배열 이 풀린 다음 결과 문서 가 평면화됩니다.