다음을 통해 공유

쿼리 코드 조각

이전 작업을 복제하고 처음부터 작성하는 것보다 수정하는 것이 더 쉬운 경우가 많습니다. 이는 일반적인 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}

쿼리 코드 조각 만들기

SQL, Notebook 또는 파일 편집기에서 쿼리 조각을 만들 수 있습니다. 아래 단계를 수행하세요.

  1. SQL 편집기에서 Kebab 메뉴 아이콘 을 클릭합니다. 케밥 메뉴.

    새 SQL 편집기에서 Kebab 메뉴 아이콘을 클릭합니다. 케밥 메뉴에서 보기를 클릭합니다.

    전자 필기장 또는 파일 편집기에서 보기를 클릭합니다.

  2. 질의 스니펫을 클릭합니다.

  3. 쿼리 조각 만들기을 클릭합니다.

  4. 교체 필드에 스니펫 이름을 입력합니다. 코드 조각을 사용하는 쿼리를 작성할 때 이 이름을 사용합니다.

  5. (선택 사항) 설명을 입력합니다.

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

  7. 만들기클릭합니다.

    쿼리 조각

쿼리 코드 조각 사용

쿼리 조각은 모든 SQL 쿼리를 사용할 수 있습니다. SQL 편집기, Notebook SQL 셀, SQL 파일 및 AI/BI 대시보드 쿼리에서 쿼리 조각에 액세스할 수 있습니다.

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

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

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

  1. SQL 편집기열기.

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

  3. 쿼리 조각의 이름을 입력한 다음 자동 완성 창에서 선택합니다.

    SQL 편집기에서 창을 Control+Space 수동으로 열고 코드 조각을 선택할 수도 있습니다.

    쿼리 코드 조각 선택

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

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

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

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

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

메모

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

다음 단계를 따라 삽입 지점 쿼리 조각을 쿼리와 함께 사용하십시오.

  1. SQL 편집기열기.

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

  3. 쿼리 코드 조각 이름의 처음 세 글자를 입력한 다음 기본값 없이 삽입 포인터가 있는 쿼리 조각을 선택합니다.

    쿼리 조각이 쿼리에 추가되면 삽입 커서가 삽입 지점으로 이동합니다.

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

  4. WHERE같은 200 절의 값을 입력합니다.

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

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

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

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

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

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