Atlas SQL 언어 참조

데이터 유형

Atlas SQL 데이터 유형은 BSON types 의 집합입니다. . 이러한 모든 유형은 Atlas SQL에서 쿼리할 수 있습니다. 그것들은 다음과 같습니다:

• string (STRING)

• 문서(DOCUMENT)

• 배열(ARRAY)

• BinData(BINDATA)

• ObjectId (OBJECTID)

• 부울 (BOOL)

• 날짜(TIMESTAMP)

• Null (NULL)

• 정규식 (REGEX)

• 32비트 정수 (INT)

• 더블 (DOUBLE)

• 긴 (LONG)

• 타임스탬프(BSON_TIMESTAMP)

• 10진수(DECIMAL)

• MinKey(MINKEY)

• MaxKey (MAXKEY)

• DBPointer(DBPOINTER)

• 기호(SYMBOL)

• 범위가 있는 JavaScript(JAVASCRIPTWITHSCOPE)

• JavaScript(JAVASCRIPT)

Atlas SQL 의 각 유형에는 이름(위의 괄호 안)이 있으며, 이는 필요한 경우(예: CAST 과 같은 표현식 에서) 유형을 참조하는 데 사용할 수 있는 키워드입니다.

유형 변환

명시적 유형 변환은 CAST 함수 또는 :: 연산자를 통해 표현됩니다. 숫자 유형은 모두 상호 비교할 수 있습니다. Atlas SQL을 사용하면 피연산자를 동일한 숫자 유형으로 캐스팅하지 않고도 다양한 숫자 유형 간의 연산을 수행할 수 있습니다.

Schemas

Atlas SQL 은 스키마 를 사용하여 MongoDB의 유연한 문서 값을 유형으로 변환합니다. Atlas SQL 스키마 는 컴파일 타임에 참인 것으로 알려진 표현식 또는 컬렉션 에 대한 팩트의 컬렉션 입니다.

예를 들어, Atlas SQL 스키마는 표현식이 부울 또는 하위 필드가 있는 문서이거나 표현식이 길이가 1인 배열 또는 양의 정수라고 명시할 수 있습니다.

정적 유형 제약 조건이 충족되지 않으면 쿼리가 컴파일되지 않습니다.

SELECT

SELECT 모든 Atlas SQL 쿼리를 시작합니다. Atlas SQL에서는 SELECT VALUE 과 SELECT VALUES 을 서로 바꿔가며 사용할 수 있습니다.

Atlas SQL 에는 중첩된 SELECT 문에 별칭이 있어야 합니다.

SELECT foo FROM (SELECT bar FROM baz) as subSelect

SELECT * FROM table WHERE period_start_utc >= CAST('2023-01-01T00:00:00.000Z' AS TIMESTAMP)

FROM

FROM 모든 Atlas SQL 쿼리 에서 평가되는 첫 번째 절입니다.

FROM 컬렉션 (SELECT * FROM foo), 배열 (SELECT * FROM [{'a': 1}]), 조인 (SELECT * FROM a JOIN b), 파생 테이블 (SELECT * FROM (SELECT a FROM foo) d), FLATTEN 및 UNwind를 포함한 다양한 소스에서 데이터를 가져올 수 있습니다.

위치

WHERE 절은 수신 데이터에 대한 필터입니다. 표현식은 정적으로 BOOL 또는 NULL 유형이어야 하며 MISSING 로 평가될 수 있습니다.

그룹 기준

GROUP BY 데이터를 그룹화하고 집계하는 수단을 제공합니다.

FLATTEN 또는 UNwind 를 사용하여 평면화된 필드 에 GROUP BY 을(를) 사용하는 경우 별칭이 필요합니다.

SELECT customerAge, COUNT(*) FROM Sales GROUP BY customer.age AS customerAge

보유

HAVING 절은 WHERE 절과 동일한 방식으로 작동하지만 GROUP BY 절 이후에 작동합니다. WHERE 절과 마찬가지로 HAVING 절은 정적으로 BOOL 또는 NULL 유형이어야 하며 MISSING 로 평가될 수 있는 표현식을 사용합니다. GROUP BY 에 정의된 별칭을 참조할 수 있으며 애그리게이션 함수가 있는 표현식을 포함할 수 있습니다. GROUP BY 에 정의된 별칭만 HAVING 절에 사용할 수 있습니다.

주문 기준

ORDER BY 절은 하나 이상의 정렬 키로 결과 설정하다 을 정렬하는 방법을 제공합니다. 각 정렬 키는 열 참조이거나 선택 표현식 목록에서 위치별로 SELECT 표현식 을 참조하는 정수 리터럴일 수 있습니다. 열 참조인 정렬 키는 복합 식별자일 수 있습니다. 이러한 복합 식별자는 데이터 소스 이름으로 한정하거나 문서 하위 필드를 참조할 수 있습니다.

Atlas SQL은 MISSING NULL NULL 를 보다 먼저 정렬하고, 를 다른 모든 값보다 먼저 정렬합니다. ORDER BY 절에서는 정렬 키 표현식에서 사용 가능한 모든 값이 > (보다 큼) 및 < (보다 작음) 연산자를 통해 비교 가능하도록 정적으로 검증될 수 있도록 요구합니다.

LIMIT 및 OFFSET

LIMIT 및 OFFSET 절을 사용하면 사용자가 쿼리에서 반환된 행 중 일부만 검색할 수 있습니다. LIMIT 숫자가 제공되면 해당 수 이상의 행이 반환되지 않습니다. OFFSET 숫자가 제공되면 행을 반환하기 전에 해당 수의 행을 건너뜁니다.

LIMIT 및 OFFSET 숫자는 모두 양의 정수여야 합니다. 없이 LIMIT 또는 를 사용하면 OFFSET ORDER BY 동일한 결과가 보장되지 않습니다.

LIMIT 및 OFFSET 이 모두 설정되면 OFFSET 행을 건너뛰고 나머지 결과를 반환하며, 이 결과에는 LIMIT 숫자 행이 포함되어야 합니다.

LIMIT i, j LIMIT i OFFSET j 의 짧은 형식입니다.

LIMIT 및 OFFSET 을(를) 하위 쿼리에 사용할 수 있습니다.

식별자

Atlas SQL의 식별자는 데이터베이스, 테이블 및 열을 참조합니다. Atlas SQL 식별자는 null 문자 \x00 을(를) 제외한 모든 UTF-8 문자를 지원합니다.

Atlas SQL에서는 다른 시맨틱 의미를 가진 문자와의 충돌을 피하기 위해 일부 식별자가 제한됩니다. 식별자에 이러한 문자가 포함되려면 로 구분 되어야 합니다. 예를 들어, 식별자가 숫자로 시작하거나 예약된 키워드와 충돌하는 경우 식별자를 구분해야 합니다(예: "10cent"). 식별자는 구분 여부에 관계없이 대소문자를 구분합니다.

Aliases

식별자는 Atlas SQL의 모든 별칭에 사용됩니다. 대부분의 경우 Atlas SQL은 동일한 절에서 별칭이 두 번 이상 사용되면 오류를 반환합니다. 단, 별칭은 UNION ALL 의 양쪽에서 반복될 수 있습니다. 이는 자동으로 생성된 별칭에도 적용됩니다.

키워드

Atlas SQL 키워드(예: SELECT, FROM, JOIN 등)는 구분되지 않은 식별자로 사용할 수 없습니다.

리터럴

Atlas SQL은 부울, null, 숫자 및 문자열에 대한 리터럴을 지원합니다. 문자열은 작은따옴표로 묶습니다. string 리터럴에 작은따옴표 문자를 포함하려면 두 배로 늘리세요('o''clock').

리터럴 정수는 32비트 부호 있는 정수 범위 내에 있는 경우 INT 로 입력되고, 그렇지 않은 경우 LONG 로 입력됩니다. 리터럴 부동 점 숫자 또는 과학 표기법 숫자의 유형은 DOUBLE 입니다.

Atlas SQL은 모든 유형에 대해 리터럴을 지원하지 않습니다. 예를 들어 OBJECTID, BSON_DATE 및 DECIMAL 에는 리터럴 구문이 없습니다. 이러한 유형의 경우 CAST 연산자를 사용하여 해당 유형의 string 또는 숫자 표현에서 해당 유형으로 가져와서 의사 리터럴 값을 얻을 수 있습니다. 일부 유형에는 관련 CAST 호출의 별칭을 지정하는 "생성자" 함수가 있을 수도 있습니다.

괄호로 묶인 표현식

괄호 안의 표현식은 괄호로 그룹화된 표현식입니다. 중위 연산자가 있는 경우, 연산 순서를 구분하기 위해 괄호(또는 유사한 메커니즘)가 필요할 수 있습니다. Atlas SQL에는 + 및 :: 과 같은 여러 중위 연산자가 있습니다. 예를 들어 1 + 2 * 3 의 값은 7 이고 (1 + 2) * 3 의 값은 9 입니다.

연산자

Atlas SQL은 다음과 같은 기본 연산자를 지원합니다.

• +

• -

• *

• /

• ||

• <

• <=

• !=

• ==

• >

• >=

• BETWEEN

• AND

• OR

• NOT

하위 쿼리 표현식

하위 쿼리는 쿼리 내의 SQL 쿼리입니다. 표현식을 사용할 수 있는 모든 곳에서 하위 쿼리를 사용할 수 있습니다.

Atlas SQL은 스칼라 하위 쿼리와 테이블 하위 쿼리를 지원합니다. 스칼라 하위 쿼리는 0개 또는 1개의 행과 1개의 열이 있는 결과 집합을 반환합니다. 리터럴 또는 단일 열 값이 유효한 대부분의 위치에서 사용할 수 있습니다. 테이블 하위 쿼리는 0개 이상의 행과 하나 이상의 열을 반환합니다.

문서 및 필드 액세스 표현식

문서는 JSON 객체와 유사한 구문으로 표현할 수 있습니다. 키는 문자열이어야 하며 값은 지원되는 모든 유형 을 가질 수 있습니다. 문서 필드에 액세스 하기 위해 Atlas SQL 은 '점' 표기법과 '대괄호' 표기법의 두 가지 옵션을 지원합니다.

점 표기법은 MongoDB 애그리게이션의 필드 액세스와 유사합니다. 예를 들어 doc 문서에 f 필드가 포함된 경우 doc.f 표현식을 사용하여 해당 필드의 값에 액세스합니다. 대괄호 표기법은 필드 이름 주위에 대괄호([ 및 ])를 사용하여 해당 이름의 필드에 액세스합니다. 예를 들어 이전에 설명한 것과 동일한 문서를 가정해 보겠습니다. doc["f"] 을(를) 사용하여 해당 필드의 값에 액세스합니다.

Null 및 누락

BSON은 NULL 과 MISSING 을(를) 구분합니다. NULL 의 경우 리터럴 값이 NULL 인 필드가 있는 반면 MISSING 의 경우 필드가 없어졌습니다.