쿼리

하나 이상의 테이블에서 결과 집합을 검색합니다.

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime

구문

[ common_table_expression ]
  subquery
  [ set_operator ]
  [ ORDER BY clause | { [ DISTRIBUTE BY clause ] [ SORT BY clause ] } | CLUSTER BY clause ]
  [ WINDOW clause ]
  [ LIMIT clause  ]
  [ OFFSET clause ]
  [ { |> piped_operation } [ ...] ]

subquery
{ subselect |
  VALUES clause |
  ( query ) |
  TABLE [ table_name | view_name ] |
  FROM table_reference [, ...] }

매개 변수

  • 공통 테이블 식

    CTE(공통 테이블 식)는 반복되는 계산을 방지하거나 복잡한 중첩 쿼리의 가독성을 개선하기 위해 주 쿼리 블록 내에서 여러 번 다시 사용할 수 있는 하나 이상의 명명된 쿼리입니다.

  • 하위 쿼리

    중간 결과 집합을 생성하는 여러 구문 중 하나입니다.

    • 하위 선택

      SELECT FROM WHERE 패턴으로 구성된 하위 쿼리입니다.

    • VALUES

      임시 인라인 테이블을 지정하였습니다.

    • (query)

      집합 연산자 또는 공통 테이블 식을 포함할 수 있는 쿼리의 중첩된 호출입니다.

    • TABLE

      전체 테이블 또는 뷰를 반환합니다.

      • table_name

        반환할 테이블을 식별합니다.

      • view_name

        반환할 뷰를 식별합니다.

      테이블 또는 뷰를 찾을 수 없는 경우 Azure Databricks TABLE_OR_VIEW_NOT_FOUND 오류가 발생합니다.

    • 에서

      적용 대상: ✔ Databricks SQL ✔ Databricks Runtime 16.2 이상

      모든 테이블 참조의 교차 조인을 반환합니다. 이 절은 일반적으로 SQL 파이프라인의 루트로 사용됩니다.

      • 테이블_참조

        SELECT의 입력 소스입니다. 이 입력 참조는 참조 전에 STREAM 키워드를 사용하여 스트리밍 참조로 전환할 수 있습니다.

    SELECT의 입력 소스입니다. 이 입력 참조는 참조 전에 STREAM 키워드를 사용하여 스트리밍 참조로 전환할 수 있습니다.

  • 세트 연산자

    UNION, EXCEPT, INTERSECT 연산자를 사용하여 하위 쿼리를 결합하는 구문입니다.

  • ORDER BY

    쿼리의 전체 결과 집합의 행 순서 지정입니다. 출력 행은 파티션 전체에서 정렬됩니다. 이 매개 변수는 SORT BY, CLUSTER BY, DISTRIBUTE BY와 양립할 수 없으며 함께 지정할 수 없습니다.

  • DISTRIBUTE BY

    결과 행이 다시 분할되는 식 집합입니다. 이 매개 변수는 ORDER BY 및 CLUSTER BY와 양립할 수 없으며 함께 지정할 수 없습니다.

  • SORT BY

    각 파티션 내에서 행이 정렬되는 순서입니다. 이 매개 변수는 ORDER BY 및 CLUSTER BY와 양립할 수 없으며 함께 지정할 수 없습니다.

  • CLUSTER BY

    행을 다시 분할하고 정렬하는 데 사용되는 식 집합입니다. 이 절을 사용하면 DISTRIBUTE BY와 SORT BY를 사용한 것과 효과가 있습니다.

  • LIMIT

    문 또는 하위 쿼리에서 반환할 수 있는 최대 행 수입니다. 이 절은 대부분 ORDER BY와 함께 사용하여 결정적 결과를 생성합니다.

  • OFFSET

    적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 11.3 LTS 이상

    명령문 또는 하위 쿼리에서 반환한 여러 행을 건너뜁니다. 이 절은 LIMIT부터 페이지까지의 결과 집합과 결합하여 사용되며, 결정적인 결과를 생성하기 위해 ORDER BY에도 사용됩니다.

    참고 항목

    LIMIT 및 OFFSET을 사용하여 결과 집합을 페이지로 나누는 경우, 건너뛴 행들 또한 처리됩니다. 이러한 행은 결과 집합에서 표시되지 않습니다. 리소스 사용량이 많은 쿼리에는 이 기술을 사용한 페이지 매김을 사용하지 않는 것이 좋습니다.

  • WINDOW

    여러 정의합니다.

  • |> 파이프_연산

    적용 대상: ✔ Databricks SQL ✔ Databricks Runtime 16.2 이상

    하위 쿼리 및 다른 이전 절의 결과 집합에서 수행할 파이프라인된 작업을 지정합니다.

일반적인 오류 조건

  • 에 마지막으로 업데이트됨