새 SQL 편집기에서 쿼리 작성 및 데이터 탐색

Databricks UI에는 쿼리를 작성하고, 동료와 공동 작업하고, 사용 가능한 데이터를 찾아보고, 시각화를 만드는 데 사용할 수 있는 SQL 편집기가 포함되어 있습니다. 이 페이지에서는 SQL 편집기를 사용하여 쿼리를 작성, 실행, 관리 및 공유하는 방법을 설명합니다.

이 문서에서는 새 SQL 편집기를 사용하는 방법을 설명합니다. 레거시 SQL 편집기를 사용하는 방법에 대한 자세한 내용은 레거시 SQL 편집기에서 쿼리 작성 및 데이터 탐색을 참조하세요.

SQL 편집기 열기

Azure Databricks UI에서 SQL 편집기를 열려면 사이드바에서 SQL Editor IconSQL 편집기를 클릭합니다.

SQL 편집기가 마지막으로 열린 쿼리로 열립니다. 쿼리가 없거나 모든 쿼리가 명시적으로 닫힌 경우 SQL 편집기 방문 페이지가 열립니다.

새 SQL 편집기 켜기

카탈로그 및 스키마 드롭다운 선택기의 오른쪽에 있는 새 SQL 편집기 토글을 사용하여 새 편집기를 켜십시오. 좁은 디스플레이에서는 카탈로그 및 스키마 선택기의 오른쪽에 있는 케밥 메뉴 을 클릭하여 Kebab menu icon.새 SQL 편집기 토글을 찾을 수 있습니다.

소유한 쿼리에 대해 새 편집기를 사용하도록 설정합니다.

• 새 SQL 편집기: 끄기를 클릭합니다. 새 SQL 편집기 팝오버 메뉴가 열립니다.
  • 모든 쿼리에 적용 확인 체크 박스가 기본적으로 선택되어 있습니다. 소유한 모든 쿼리에 대해 편집기를 사용하도록 설정하려면 이 설정을 유지합니다.
  • 활성 쿼리에 대해서만 새 편집기를 사용하도록 설정하려면 모든 쿼리에 적용 확인 체크 박스의 선택을 취소 합니다.
• 새 SQL 편집기 토글을 켠 상태로 설정하십시오.

새 SQL 편집기를 모든 쿼리에 사용할 수 없습니다. 다음 중 어느 것이라도 true이면 쿼리에 대한 새 SQL 편집기로 전환할 수 없습니다.

• 쿼리를 소유하지 않습니다.
• 쿼리에는 지원되지 않는 쿼리 기반 드롭다운 목록이 포함됩니다. 쿼리 매개변수 작업을 참조하세요.

새 SQL 편집기를 켜면 쿼리가 새 UI에서 다시 열립니다. 쿼리를 실행할 때까지 결과 집합은 비어 있습니다.

오리엔테이션

이 섹션에서는 UI의 주요 차이점을 강조하고 사용 가능한 기능을 찾고 사용하는 방법을 설명합니다.

1. 작업 영역 파일 시스템에 액세스: SQL 편집기에서 직접 작업 영역 개체에 액세스하고 구성할 수 있습니다.
2. 통합 Databricks 도우미: 도우미와 채팅하여 쿼리를 작성, 구체화 또는 이해하는 데 도움을 줍니다. 사이드 창에서 도우미가 생성한 코드를 실행합니다.
3. 코드 섹션 축소: 코드 블록 왼쪽의 축소 화살표를 클릭하여 코드 섹션을 선택적으로 숨기고 확장합니다. 이렇게 하면 큰 파일을 더 쉽게 처리할 수 있습니다.
4. 명령 팔레트 열기: 명령 팔레트에는 일반적인 작업, 바로 가기 키, 사용자 지정 테마 및 필요한 항목을 빠르게 찾을 수 있는 링크가 포함됩니다. 열면 검색 창을 사용하여 특정 도구 및 바로 가기를 찾습니다.
5. 코드에 대한 설명: 공동 작업을 향상시키기 위해 코드에 주석을 추가합니다.
6. 버전 기록 검토: 쿼리의 최근 변경 내용을 검토합니다.

컴퓨팅에 연결

쿼리를 실행하려면 실행 중인 SQL Warehouse에 대한 CAN USE 권한이 있어야 합니다. 편집기 위쪽의 드롭다운을 사용하여 사용 가능한 옵션을 확인할 수 있습니다. 목록을 필터링하려면 텍스트 상자에 텍스트를 입력합니다.

쿼리를 처음 만들면 사용 가능한 SQL 웨어하우스 목록이 사전순으로 표시됩니다. 마지막으로 사용한 SQL Warehouse는 다음에 쿼리를 만들 때 선택됩니다.

SQL Warehouse 옆의 아이콘은 다음과 같은 상태를 나타냅니다.

• 실행
• 시작
• 중지

선택한 SQL Warehouse는 쿼리를 실행할 때 자동으로 다시 시작됩니다. SQL Warehouse를 시작하는 다른 방법을 알아보려면 SQL Warehouse 시작을 참조하세요.

자산 찾아보기 및 도움말 보기

SQL 편집기에서 왼쪽 창을 사용하여 작업 영역 파일을 찾아보고, 데이터 개체를 보고, Databricks Assitant에서 도움을 받을 수 있습니다.

작업 영역 파일 찾아보기

을 클릭하여 작업 영역 사용자 폴더를 엽니다. UI의 이 부분에서 액세스할 수 있는 모든 작업 영역 파일을 탐색할 수 있습니다.

데이터 개체 찾아보기

메타데이터 읽기 권한이 있는 경우 SQL 편집기에서 스키마 브라우저에 사용 가능한 데이터베이스와 테이블이 표시됩니다. 카탈로그 탐색기에서 데이터 개체를 찾아볼 수도 있습니다.

활성 컴퓨팅 없이 카탈로그 탐색기에서 Unity 카탈로그 관리 데이터베이스 개체를 탐색할 수 있습니다. Unity 카탈로그가 제어하지 않는 hive_metastore 및 기타 카탈로그의 데이터를 탐색하려면 적절한 권한으로 컴퓨팅에 연결해야 합니다. Azure Databricks를 사용한 데이터 거버넌스를 참조하세요.

스키마 브라우저 위쪽에서 을 클릭하여 스키마를 새로 고칩니다. 검색 창에 입력하여 이름으로 자산을 필터링할 수 있습니다. 을 클릭합니다. 필터 아이콘을 선택하여 형식별로 개체를 필터링합니다.

브라우저에서 개체의 이름을 클릭하여 개체에 대한 자세한 내용을 확인합니다. 예를 들어 스키마 이름을 클릭하여 해당 스키마의 테이블을 표시합니다. 테이블 이름을 클릭하여 해당 테이블의 열을 표시합니다.

Databricks Assistant에서 도움말 보기

길잡이 아이콘을 클릭하면 Databricks Assistant가 있는 채팅 창이 열립니다. 제안된 질문을 클릭하거나 사용자 고유의 질문을 입력하여 Databricks Assistant와 상호 작용합니다.

쿼리 만들기

텍스트를 입력하여 SQL 편집기에서 쿼리를 만들 수 있습니다. 스키마 브라우저에서 요소를 삽입하여 카탈로그 및 테이블을 참조할 수 있습니다.

1. SQL 편집기에서 쿼리를 입력합니다.

   SQL 편집기에서는 자동 완성을 지원합니다. 입력할 때 자동 완성에서 완성을 추천합니다. 예를 들어 커서 위치에서 유효한 완성이 열인 경우 자동 완성은 열 이름을 제안합니다. 자동 완성은 select * from table_name as t where t.를 입력하면 t이 table_name의 별칭임을 인식하고, table_name 내부의 열을 제안합니다. 자동 완성을 사용하여 쿼리 조각을 참조할 수도 있습니다.

   

2. (선택 사항) 편집이 끝나면 저장을 클릭합니다. 기본적으로 쿼리는 사용자 홈 폴더에 저장됩니다. 쿼리를 다른 위치에 저장하려면 대상 폴더를 선택하고 이동을 클릭합니다.

쿼리 데이터 원본

쿼리 자체에서 정규화된 테이블 이름을 사용하거나 쿼리의 테이블 이름과 함께 드롭다운 선택기에서 카탈로그와 스키마의 조합을 선택하여 쿼리 원본을 식별할 수 있습니다. 쿼리의 완전히 지정된 테이블 이름은 SQL 편집기의 카탈로그 및 스키마 선택기에 우선합니다. 테이블 또는 열 이름에 공백이 포함된 경우 SQL 쿼리에서 해당 식별자를 백틱으로 래핑합니다.

다음 예제에서는 카탈로그에 저장할 수 있는 다양한 테이블과 유사한 개체를 쿼리하는 방법을 보여 줍니다.

표준 테이블 또는 뷰 쿼리

다음 예제에서는 카탈로그에서 테이블을 쿼리합니다 samples .

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

메트릭 보기를 쿼리합니다.

다음 예제에서는 샘플 카탈로그의 테이블을 원본으로 사용하는 메트릭 뷰를 쿼리합니다. 나열된 세 가지 측정값을 평가하고 Order Month 및 Order Status로 집계합니다. 을 기준으로 Order Month정렬된 결과를 반환합니다. 작업 영역에서 유사한 메트릭 보기를 만들려면 메트릭 보기 만들기를 참조하세요.

모든 측정 평가는 MEASURE 함수로 래핑되어야 합니다. 집계 함수 measure 참조하세요.

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

Databricks Assistant를 사용하여 쿼리 최적화

을 클릭합니다. 쿼리를 작성할 때 인라인 도움말 및 제안을 가져오는 편집기 오른쪽의 도우미 아이콘입니다. /optimize 슬래시 명령은 어시스턴트에게 쿼리를 평가하고 최적화 작업을 요구합니다. 자세한 내용은 Python, PySpark 및 SQL 코드 최적화를 참조하세요.

여러 쿼리 탭 편집

기본적으로 SQL 편집기에서는 탭을 사용하므로 여러 쿼리를 동시에 열고 편집할 수 있습니다. 새 탭을 열려면 클릭하고 +새 쿼리 만들기 또는 기존 쿼리 열기를 선택합니다. 기존 쿼리 열기를 클릭하여 쿼리 목록을 확인합니다. For you 탭은 사용에 기반한 큐레이팅된 suggestions 목록을 제공해요. 모든 탭을 사용하여 액세스할 수 있는 쿼리를 찾습니다.

단일 쿼리 또는 복합 쿼리를 실행하세요

단일 편집기 탭에 다중 문 쿼리를 작성할 수 있습니다. 단일 탭에서 여러 쿼리 문을 사용하려면 각 문을 세미콜론(;)으로 종료합니다.

단일 쿼리를 실행하려면 다음을 수행합니다.

1. SQL 웨어하우스를 선택합니다.
2. SQL 편집기에서 쿼리를 강조 표시합니다(쿼리 창에 여러 개의 쿼리가 있는 경우).
3. Ctrl/Cmd + Enter 키를 누르거나 실행(1000)을 클릭하여 결과 창에 결과를 표로 표시합니다.

쿼리 종료

쿼리가 실행되는 동안 쿼리를 종료하려면 [취소]를 클릭합니다. 관리자는 실행 중인 쿼리 종료를 확인하여 다른 사용자가 시작한 실행 중인 쿼리를 중지할 수 있습니다.

쿼리 공유

새 SQL 편집기에서는 다음 두 부분으로 사용 권한을 처리합니다.

대화형 실행: 새 SQL 편집기에서 쿼리는 항상 뷰어 자격 증명을 사용하여 실행됩니다. 쿼리 결과는 쿼리에 액세스할 수 있는 모든 사용자가 액세스할 수 있습니다. CAN EDIT 권한 이상이 있는 사용자는 공유 쿼리 초안을 수정할 수 있습니다. 또한 저장되지 않은 편집은 CAN VIEW 권한 이상이 있는 모든 사용자에게 표시됩니다. 쿼리를 실행하려면 연결된 Warehouse에 대한 CAN USE 권한이 사용자에게 있어야 합니다.

자격 증명 설정: 레거시 경고, 워크플로 및 레거시 대시보드에 대한 권한 설정은 레거시 SQL 편집기와 동일합니다. 기본 설정에 따라 소유자 또는 뷰어의 자격 증명을 사용하여 이러한 자산을 실행할 수 있습니다.

소유자 권한으로 실행 및 뷰어 권한으로 실행 자격 증명 설정에 대해 알아보려면 쿼리 권한 구성을 참조하세요. 쿼리 개체에 대한 액세스를 관리하는 방법을 알아보려면 쿼리 ACL을 참조하세요.

실시간으로 쿼리 공동 작업

쿼리를 공유한 후 공동 편집을 통해 쿼리를 공동 작성하거나 디버그할 수 있습니다. 또한 편집자는 개별 코드 줄에 주석을 달고 질문을 하거나 제안을 추가할 수 있습니다.

소스 제어 쿼리

Databricks SQL 쿼리 파일(확장명: )은Databricks Git 폴더에서 지원됩니다. Git 폴더를 사용하여 쿼리 파일을 소스 제어하고 동일한 Git 리포지토리에 액세스하는 Git 폴더와 다른 작업 영역에서 공유할 수 있습니다. Databricks Git 폴더에서 쿼리를 커밋하거나 복제한 후 새 SQL 편집기를 옵트아웃하도록 선택한 경우 예기치 않은 동작을 방지하기 위해 해당 Git 폴더를 삭제하고 다시 표시합니다.

쿼리 저장

새 SQL 편집기에서 쿼리 콘텐츠는 지속적으로 자동 저장됩니다. 저장 단추는 초안 쿼리 콘텐츠를 레거시 대시보드, 워크플로 또는 레거시 경고와 같은 관련 자산에 적용해야 하는지 여부를 제어합니다. 쿼리가 소유자 권한으로 실행 자격 증명으로 공유되는 경우 쿼리 소유자만 저장 버튼을 사용하여 변경 사항을 전파할 수 있습니다. 자격 증명이 뷰어로 실행으로 설정된 경우 적어도 CAN MANAGE 권한이 있는 사용자는 쿼리를 저장할 수 있습니다.

쿼리 결과 보기

각 문의 출력을 여러 결과 문과 비교할 수 있습니다. 단일 편집 창에서 여러 SQL 문을 실행하는 경우 화면 아래쪽에 있는 출력 패널의 UI를 사용하여 다른 결과 집합을 스크롤할 수 있습니다.

결과 창을 사용하여 쿼리 결과와 상호 작용하고 탐색할 수 있습니다. 결과 창에는 결과를 탐색하기 위한 다음 기능이 포함되어 있습니다.

시각화

을 클릭하여 시각화를 추가합니다. 시각화는 결과 집합을 탐색하는 데 도움이 될 수 있습니다. 사용 가능한 시각화 형식 의 전체 목록은 시각화 유형을 참조하세요.

시각화 탭에서 을 클릭하여 추가 옵션을 표시합니다.

• 다운로드를 클릭하여 시각화에 표시된 데이터를 CSV, TSV 또는 Excel 파일로 다운로드합니다.
• 제거를 클릭하여 시각화를 삭제합니다.
• 중복을 클릭하여 결과 탭을 복제합니다.
• 이름 바꾸기를 클릭하여 시각화를 다시 설정합니다.

1. 편집을 클릭하여 시각화를 편집합니다.

2. 대시보드에 추가를 클릭하여 쿼리 및 시각화를 새 AI/BI 대시보드에 복사합니다.

3. 새 대시보드 만들기 또는 기존 대시보드에 추가를 선택합니다.

   • 새 대시보드 만들기: 쿼리와 연결된 모든 시각화를 포함하는 새 대시보드를 만듭니다. 새 대시보드의 이름을 선택하라는 메시지가 표시됩니다. 새 대시보드가 홈 폴더에 저장됩니다.
   • 기존 대시보드에 추가: 쿼리 및 관련 시각화를 기존 대시보드에 추가합니다. 드롭다운 메뉴를 사용하여 데이터 세트 및 시각화를 추가할 대시보드를 선택합니다.

다운로드 결과

결과를 CSV 또는 Excel 파일로 다운로드할 수 있습니다. CSV 다운로드는 최대 약 5GB의 데이터를 지원합니다. 결과 탭에서 를 클릭하여 다운로드 옵션을 확인합니다. 최종 파일 다운로드 크기는 5GB 제한이 최종 파일 다운로드보다 이전 단계에 적용되므로 5GB보다 약간 많거나 작을 수 있습니다.

필터

필터를 사용하면 쿼리가 실행된 후 결과 집합을 제한할 수 있습니다. 필터를 적용하여 데이터의 여러 하위 집합을 선택적으로 표시할 수 있습니다. 도우미를 사용하여 결과에 대한 필터를 추가할 수 있습니다.

필터를 추가하려면 다음을 수행합니다.

1. 을 클릭합니다. 필터 아이콘입니다.
2. 적용할 필터의 종류를 설명하는 텍스트를 입력합니다. 명명된 필터가 결과 집합에 적용됩니다.

필터를 편집하려면 다음을 수행합니다.

1. 필터의 이름을 클릭합니다.
2. 드롭다운 메뉴 및 텍스트 필드를 사용하여 필터 설정을 조정합니다.
3. (선택 사항) 필터가 대소문자를 구분하도록 대/소문자 구분을 선택합니다.
4. (선택 사항) 추가 또는 조건을 클릭하여 필터를 추가합니다.

매개 변수 추가

매개 변수를 사용하면 런타임에 값을 쿼리로 대체하여 결과 집합을 제한할 수 있습니다. 매개 변수를 적용하는 방법을 알아보려면 쿼리 매개 변수 작업을 참조하세요.

매개 변수 구문 변경

매개 변수를 표시하기 위해 이중 중괄호({{}})를 사용하는 레거시 SQL 편집기에서 작성된 쿼리는 새 SQL 편집기에서 실행되도록 수정해야 합니다. 새 SQL 편집기에서는 AI/BI 대시보드, AI/BI Genie 및 Notebook과 같은 다른 Databricks 도구와 동일한 매개 변수 구문을 사용합니다.

새 SQL 편집기에서 매개 변수는 명명된 매개 변수 구문을 사용하여 정의됩니다. 명명된 매개 변수는 콜론 앞에 접두사로 지정된 쿼리의 매개 변수입니다(예: :parameter_name).

SQL 참조 설명서는 명명된 매개 변수 표식을 참조하세요. 클래식 SQL 편집기에서 명명된 매개 변수 표식으로 매개 변수 구문을 변환하는 예제는 명명된 매개 변수 구문 예제를 참조하세요.

지원되는 필터 형식

다음 표에서는 새 SQL 편집기에서 지원되는 필터 형식을 보여줍니다. 두 번째 열은 필터가 레거시 SQL 편집기에서도 작동하는지 여부를 나타냅니다.

키보드 바로 가기 키 사용

새 SQL 편집기에서는 빠르게 작업할 수 있도록 다양한 기본 제공 바로 가기 키를 제공합니다. 다음 표에서는 일반적으로 사용되는 바로 가기 키를 식별합니다.

새 SQL 편집기 사용 안 함

새 SQL 편집기를 사용하지 않도록 설정하려면 다음 단계를 사용합니다.

• 새 SQL 편집기: ON를 클릭합니다. 새 SQL 편집기 팝오버 메뉴가 열립니다.
• 새 SQL 편집기 토글을 OFF로 설정하세요.
• 확인 대화 상자에서 활성 쿼리에 대해서만 또는 적합한 모든 쿼리에 대해 새 편집기를 사용하지 않도록 설정하도록 선택합니다.
  • 모든 적격 쿼리에 대한 사용 안 함이 선택되지 않았습니다. 활성 쿼리에 대해서만 새 편집기를 사용하지 않도록 설정하려면 이 설정을 유지합니다.
  • 모든 쿼리에 대해 새 SQL 편집기를 사용하지 않도록 설정하려면모든 적격 쿼리에 대해 사용 안 함 확인란을 선택합니다.

작업 영역 관리자는 미리 보기 포털을 방문하여 작업 영역 수준에서 미리 보기를 끌 수 있습니다. Azure Databricks의 미리 보기를 관리하려면을 참조하세요 .