Share via

쿼리 코드 조각

  • 아티클

처음부터 무언가를 작성하는 것보다 이전 작업을 복제하고 수정하는 것이 종종 더 쉽습니다. 이는 특히 일반적인 JOIN 문이나 복잡한 CASE 식에 해당됩니다. 쿼리 목록이 늘어남에 따라 필요한 명령문이 포함된 쿼리를 기억하기 어려울 수 있습니다. 런타임에 사용자가 바꿀 수 있는 자리 표시자 텍스트가 있는 삽입 지점이 포함된 쿼리 조각을 만들 수도 있습니다.

쿼리 코드 조각은 자동 완성을 사용하여 공유하고 트리거할 수 있는 쿼리 세그먼트입니다. 다음을 위해 쿼리 코드 조각을 사용합니다.

  • 빈번한 JOIN 문
  • WITH 또는 CASE와 같은 복잡한 절.
  • 조건부 서식

코드 조각의 예는 다음과 같습니다.

--Simple snippet
WHERE fare_amount > 100

--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}

--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}

--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}

쿼리 코드 조각 만들기

다음 단계를 사용하여 다음 코드 조각 예제를 사용하여 코드 조각을 만듭니다.

  1. 작업 영역의 위쪽 표시줄에서 사용자 이름을 클릭하고 드롭다운에서 설정 선택합니다.

  2. 개발자 탭을 클릭합니다.

  3. SQL 쿼리 조각 옆에 있는 관리를 클릭합니다.

  4. 쿼리 코드 조각 만들기를 클릭합니다.

  5. 바꾸기 필드에 코드 조각 이름을 입력합니다. 코드 조각을 사용하는 쿼리를 작성할 때 이 이름을 사용합니다.

  6. 선택적으로 설명을 입력합니다.

  7. 코드 조각 필드에 코드 조각을 입력합니다.

  8. 만들기를 클릭합니다.

    쿼리 코드 조각

쿼리에서 쿼리 코드 조각 사용

다음은 이러한 쿼리 조각을 사용할 수 있는 간단한 쿼리의 예입니다.

--Simple query
SELECT * FROM samples.nyctaxi.trips

다음 단계를 사용하여 이 쿼리와 함께 쿼리 조각을 사용합니다.

  1. SQL 편집기를 엽니다.

  2. SQL 편집기 쿼리 창에 쿼리를 입력합니다.

  3. 코드 조각 이름의 처음 3자를 입력한 다음 자동 완성 창에서 코드 조각을 선택합니다. 조각을 눌러 Option + Space 창을 수동으로 열 수도 있습니다.

    코드 조각을 선택하는 쿼리

  4. 쿼리 코드 조각의 WHERE 절을 사용하여 쿼리를 실행합니다.

    쿼리에 사용된 코드 조각을 보여 주는 쿼리

쿼리 코드 조각에서 삽입 지점 작업

단일 달러 기호와 중괄호 ${}로 정수 탭 순서를 래핑하여 삽입 지점을 지정합니다. 콜론 :이 앞에 오는 텍스트 자리 표시자는 선택 사항이지만 코드 조각에 익숙하지 않은 사용자에게 유용합니다. 이전에 ${1:value} 만든 삽입 지점이 있는 쿼리 코드 조각에서 자리 표시자가 있는 삽입 지점이며 ${1:100} 런타임에 재정의할 수 있는 자리 표시자에 대한 기본값이 있는 삽입 지점입니다. Databricks SQL이 코드 조각을 렌더링하면 달러 기호 $ 와 중괄호 {} 가 제거되고 단어 value 또는 기본값 100 이 강조 표시되어 대체됩니다.

여러 삽입 지점이 있는 경우 텍스트 삽입 캐럿이 첫 번째 삽입 지점으로 이동하여 원하는 값을 묻는 메시지를 표시합니다. 누르면 Tab캐럿이 다음 값의 다음 삽입 지점으로 이동합니다. 다시 누르면 Tab 캐럿이 최종 삽입 지점에 도달할 때까지 다음 삽입 지점 줄로 이동합니다.

참고 항목

0 ${0} 의 삽입 지점은 항상 탭 순서의 마지막 지점입니다.

다음 단계를 사용하여 쿼리와 함께 삽입 지점 쿼리 조각을 사용합니다.

  1. SQL 편집기를 엽니다.

  2. SQL 편집기 쿼리 창에 쿼리를 입력합니다.

  3. 쿼리 코드 조각 이름의 처음 3자를 입력한 다음, 기본값이 없는 삽입 지점이 있는 쿼리 조각을 선택합니다.

    쿼리 조각이 쿼리에 추가되고 텍스트 삽입 캐럿이 삽입 지점으로 이동합니다.

    기본값이 없는 삽입 지점 쿼리 조각을 사용하여 쿼리

  4. 절의 WHERE 값을 입력합니다(예: 200.).

  5. 필요에 따라 쿼리 코드 조각의 절을 WHERE 사용하여 쿼리를 실행합니다.

  6. 이전 단계를 반복하지만 기본값을 사용하여 삽입 지점이 있는 쿼리 조각을 선택합니다.

    기본값이 포함된 삽입 지점 쿼리 조각을 사용하여 쿼리

  7. 이전 단계를 반복하지만 여러 삽입 지점이 있는 쿼리 조각을 선택합니다.

    여러 삽입 지점이 포함된 삽입 지점 쿼리 조각을 사용하여 쿼리

  8. 첫 번째 삽입 지점의 값을 입력하고, 탭을 다음 삽입 지점으로 이동하고, 값을 입력한 다음, 탭에서 최종 삽입 지점까지 탭하고 값을 입력합니다.