SQL 편집기에서 쿼리 작성 및 데이터 탐색
Azure Databricks UI에는 쿼리를 작성하고, 사용 가능한 데이터를 찾아보고, 시각화를 만드는 데 사용할 수 있는 SQL 편집기가 포함되어 있습니다. 저장된 쿼리를 작업 영역의 다른 팀 구성원과 공유할 수도 있습니다. 이 문서에서는 SQL 편집기를 사용하여 쿼리를 작성, 실행 및 관리하는 방법을 설명합니다. SQL 편집기의 새 버전은 공개 미리 보기로 제공됩니다. 새 SQL 편집기를 사용하도록 설정하고 작업하는 방법을 알아보려면 새 SQL 편집기를 사용하여 동료와 공동 작업을 참조하세요.
편집기를 연 후 SQL 쿼리를 작성하거나 사용 가능한 데이터를 찾아볼 수 있습니다. 텍스트 편집기에서는 자동 완성, 자동 서식 지정 및 기타 다양한 바로 가기 키를 지원합니다.
텍스트 편집기의 맨 위에 있는 쿼리 탭을 사용하여 여러 쿼리를 열 수 있습니다. 각 쿼리 탭에는 쿼리를 실행하고, 쿼리를 즐겨찾기로 표시하고, SQL Warehouse에 연결하는 컨트롤이 있습니다. 쿼리를 저장, 예약 또는 공유할 수도 있습니다.
SQL 편집기 열기
Azure Databricks UI에서 SQL 편집기를 열려면 사이드바에서 SQL 편집기를 클릭
합니다.
SQL 편집기가 마지막으로 열린 쿼리로 열립니다. 쿼리가 없거나 모든 쿼리가 명시적으로 닫힌 경우 새 쿼리가 열립니다. 새 쿼리라는 이름이 자동으로 지정되고 만들기 타임스탬프가 제목에 추가됩니다.
컴퓨팅에 연결
쿼리를 실행하려면 실행 중인 SQL Warehouse에 대한 CAN USE 권한이 있어야 합니다. 편집기 위쪽의 드롭다운을 사용하여 사용 가능한 옵션을 확인할 수 있습니다. 목록을 필터링하려면 텍스트 상자에 텍스트를 입력합니다.
쿼리를 처음 생성하면 사용 가능한 SQL Warehouse 목록이 알파벳순으로 표시됩니다. 마지막으로 사용한 SQL Warehouse는 다음에 쿼리를 만들 때 선택됩니다.
SQL Warehouse 옆의 아이콘은 다음과 같은 상태를 나타냅니다.
실행
시작
중지
참고 항목
목록에 SQL Warehouse가 없는 경우 작업 영역 관리자에게 문의하세요.
선택한 SQL Warehouse는 쿼리를 실행할 때 자동으로 다시 시작됩니다. SQL Warehouse를 시작하는 다른 방법을 알아보려면 SQL Warehouse 시작을 참조하세요.
SQL 편집기에서 데이터 개체 찾아보기
메타데이터 읽기 권한이 있는 경우 SQL 편집기에서 스키마 브라우저에 사용 가능한 데이터베이스 및 테이블이 표시됩니다. 또한 카탈로그 탐색기에서 데이터 개체를 찾아볼 수 있습니다.
활성 컴퓨팅 없이 카탈로그 탐색기에서 Unity 카탈로그 관리 데이터베이스 개체를 탐색할 수 있습니다. Unity 카탈로그가 제어하지 않는 hive_metastore 및 기타 카탈로그의 데이터를 탐색하려면 적절한 권한으로 컴퓨팅에 연결해야 합니다. Unity 카탈로그를 사용하여 데이터 거버넌스를 참조하세요.
참고 항목
스키마 브라우저 또는 카탈로그 탐색기에 데이터 개체가 없는 경우 작업 영역 관리자에게 문의하세요.
스키마 브라우저의 위쪽 근처 
을 클릭하여 스키마를 새로 고칩니다. 검색 상자에 필터 문자열을 입력하여 스키마를 필터링할 수 있습니다.
테이블 이름을 클릭하여 해당 테이블의 열을 표시합니다.
쿼리 만들기
텍스트를 입력하여 SQL 편집기에서 쿼리를 만들 수 있습니다. 스키마 브라우저에서 요소를 삽입하여 카탈로그 및 테이블을 참조할 수 있습니다.
SQL 편집기에서 쿼리를 입력합니다.
SQL 편집기에서는 자동 완성을 지원합니다. 입력할 때 자동 완성에서 완성을 추천합니다. 예를 들어 커서 위치에서 유효한 완성이 열인 경우 자동 완성에서는 열 이름을 추천합니다.
select * from table_name as t where t.를 입력하는 경우 자동 아ㅗㄴ성에서는t가table_name의 별칭임을 인식하고table_name내의 열을 추천합니다.
(선택 사항) 편집이 끝나면 저장을 클릭합니다. 기본적으로 쿼리는 사용자 홈 폴더에 저장되거나 다른 위치를 선택할 수 있습니다. 그런 다음, 저장을 클릭합니다.
자동 완성 설정 및 해제
라이브 자동 완성을 통해 스키마 토큰, 쿼리 구문 식별자(예: SELECT 및 JOIN), 쿼리 코드 조각의 제목을 완성할 수 있습니다. 데이터베이스 스키마의 토큰(테이블 또는 열)이 5,000개를 넘지 않는 경우 이것을 기본적으로 사용하도록 설정됩니다.
SQL 편집기 아래의 토글을 사용하여 라이브 자동 완성을 끄거나 켭니다.
- 라이브 자동 완성을 비활성화하려면 Ctrl + 스페이스바를 누르거나 SQL 편집기 아래쪽에서
단추를 클릭합니다.
쿼리 저장
SQL 편집기의 오른쪽 위에 있는 저장 단추는 쿼리를 저장합니다.
Important
쿼리를 수정해도 저장을 명시적으로 클릭하지 않으면 해당 상태는 쿼리 초안으로 유지됩니다. 쿼리 초안은 30일 동안 유지됩니다. 30일이 지나면 쿼리 초안이 자동으로 삭제됩니다. 변경 내용을 유지하려면 명시적으로 저장해야 합니다.
여러 쿼리 편집
기본적으로 SQL 편집기에서는 탭을 사용하므로 여러 쿼리를 동시에 편집할 수 있습니다. 새 탭을 열려면 +를 클릭한 다음 Create new query(새 쿼리 만들기) 또는 Open existing query(기존 쿼리 열기)를 선택합니다. 기존 쿼리 열기를 클릭하여 저장된 쿼리 목록을 확인합니다. 내 쿼리 또는 즐겨찾기를 클릭하여 쿼리 목록을 필터링합니다. 보려는 쿼리가 포함된 행에서 열기를 클릭합니다.
단일 쿼리 또는 여러 쿼리 실행
쿼리 하나 또는 모든 쿼리를 실행하려면 다음을 수행합니다.
SQL Warehouse를 선택합니다.
SQL 편집기에서 쿼리를 강조 표시합니다(쿼리 창에 여러 개의 쿼리가 있는 경우).
Ctrl/Cmd + Enter 키를 누르거나 실행(1000)을 클릭하여 결과 창에 결과를 테이블로 표시합니다.
참고 항목
모든 쿼리에 대해 기본적으로 1000 제한이 선택되어 쿼리 반환을 1000행으로 제한합니다. 1000 제한 설정으로 쿼리를 저장하는 경우 이 설정은 대시보드에 포함된 모든 쿼리 실행에 적용됩니다. 이 쿼리에 대한 모든 행을 반환하려면 실행(1000) 드롭다운을 클릭하여 1000개 제한을 선택 취소할 수 있습니다. 행 수에 대해 다른 제한을 지정하려는 경우 원하는 값으로 쿼리에 LIMIT 절을 추가할 수 있습니다.
쿼리 종료
쿼리가 실행 중일 때 쿼리를 종료하려면 취소를 클릭합니다. 관리자는 실행 중인 쿼리 중단를 참조하여 다른 사용자가 시작한 실행 중인 쿼리를 종료할 수 있습니다.
쿼리 옵션
쿼리 편집기 위쪽에 있는 
케밥 컨텍스트 메뉴를 사용하여 메뉴 옵션에 액세스하여 쿼리 정보를 복제, 되돌리기, 서식 지정 및 편집할 수 있습니다.
저장된 쿼리로 되돌리기
쿼리를 편집하면 변경 내용 되돌리기 옵션이 쿼리의 바로 가기 메뉴에 표시됩니다. 되돌리기를 클릭하면 저장된 버전으로 돌아갈 수 있습니다.
쿼리 삭제 및 복원
쿼리를 휴지통으로 이동하려면 다음을 수행합니다.
- SQL 편집기의 쿼리 옆에 있는 케밥 컨텍스트 메뉴를 클릭하고 휴지통으로 이동을 선택합니다.
- 휴지통으로 이동을 클릭하여 확인합니다.
쿼리를 휴지통에서 복원하려면 다음을 수행합니다.
- 모든 쿼리 목록에서
를 클릭합니다. - 쿼리를 클릭합니다.
- SQL 편집기의 오른쪽 상단에 있는 케밥 컨텍스트 메뉴를 클릭하고 복원을 클릭합니다.
쿼리 설명 설정 및 쿼리 정보 보기
쿼리 설명을 설정하려면 다음을 수행합니다.
쿼리 옆의
케밥 컨텍스트 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다.
설명 텍스트 상자에 설명을 입력합니다. 그런 다음, 저장을 클릭합니다. 이 대화 상자에서 쿼리가 만들어지고 업데이트된 시기를 포함하여 쿼리의 기록을 볼 수도 있습니다.
즐겨찾기 및 태그 쿼리
즐겨찾기 및 태그를 사용하여 작업 영역 방문 페이지와 대시보드 및 쿼리에 대한 각 목록 페이지에 표시되는 쿼리 및 대시보드 목록을 필터링할 수 있습니다.
즐겨찾기: 쿼리를 즐겨찾기 추가하려면 쿼리 목록에서 제목 왼쪽에 있는 별을 클릭합니다. 별이 노란색으로 변합니다.
태그: 조직에 의미 있는 문자열로 쿼리 및 대시보드에 태그를 지정할 수 있습니다.
태그 추가
쿼리 편집기에서 태그를 추가합니다.
쿼리 옆의
케밥 컨텍스트 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다. 쿼리 정보 대화 상자가 나타납니다.쿼리에 태그가 적용되지 않은 경우 태그가 표시되는 텍스트 상자에 일부 태그를 추가합니다. 새 태그를 만들려면 상자에 태그를 입력합니다. 여러 태그를 입력하려면 항목 간에 Tab 키를 누릅니다.
저장을 클릭하여 태그를 적용하고 대화 상자를 닫습니다.
태그 제거
- 쿼리 옆의 케밥 컨텍스트 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다.
- 제거할 태그에서 X를 클릭합니다.
- 저장을 클릭하여 대화 상자를 닫습니다.
쿼리 결과 보기
쿼리가 실행되면 그 아래 창에 결과가 표시됩니다. 새 결과 테이블은 새 쿼리에 대해 ON입니다. 필요한 경우 드롭다운을 클릭하여 해제합니다. 이 섹션의 이미지는 새 결과 테이블을 사용합니다.
결과 창을 사용하여 쿼리 결과와 상호 작용하고 탐색할 수 있습니다. 결과 창에는 결과를 탐색하기 위한 다음 기능이 포함되어 있습니다.
시각화, 필터 및 매개 변수
시각화, 필터 또는 매개 변수를 추가하려면 
을 클릭합니다. 다음 옵션이 표시됩니다.
시각화: 시각화는 결과 집합을 탐색하는 데 도움이 될 수 있습니다. 사용 가능한 시각화 형식의 전체 목록은 시각화 유형을 참조하세요.
필터: 필터를 사용하면 쿼리가 실행된 후 결과 집합을 제한할 수 있습니다. 필터를 적용하여 데이터의 여러 하위 집합을 선택적으로 표시할 수 있습니다. 필터를 사용하는 방법을 알아보려면 쿼리 필터를 참조하세요.
매개 변수: 매개 변수를 사용하면 런타임에 값을 쿼리로 대체하여 결과 집합을 제한할 수 있습니다. 매개 변수를 적용하는 방법을 알아보려면 쿼리 매개 변수 작업을 참조하세요.
대시보드 편집, 다운로드 또는 추가
Important
- Databricks는 AI/BI 대시보드(이전의 Lakeview 대시보드)를 사용하는 것이 좋습니다. 이전에 Databricks SQL 대시보드라고도 하는 이전 버전의 대시보드를 이제 레거시 대시보드라고 합니다. Databricks는 새 레거시 대시보드를 만들지 않는 것이 좋습니다.
- 마이그레이션 도구 또는 REST API를 사용하여 레거시 대시보드를 변환합니다. 기본 제공 마이그레이션 도구 사용에 대한 지침은 AI/BI 대시보드에 레거시 대시보드 복제를 참조하세요. REST API를 사용하여 대시보드를 만들고 관리하는 방법에 대한 자습서는 대시보드 자습서를 참조하세요.
더 많은 옵션을 보려면 결과 탭에서 
을(를) 클릭합니다.
- 편집을 클릭하여 시각화에 표시된 결과를 사용자 지정합니다.
- 삭제를 클릭하여 결과 탭을 삭제합니다.
- 중복을 클릭하여 결과 탭을 복제합니다.
- 대시보드에 추가를 클릭하여 쿼리 및 시각화를 새 대시보드에 복사합니다.
- 이 작업은 쿼리와 연결된 모든 시각화를 포함하는 새 대시보드를 만듭니다. 대시보드를 편집하는 방법을 알아보려면 대시보드를 참조하세요.
- 새 대시보드의 이름을 선택하라는 메시지가 표시됩니다. 새 대시보드가 홈 폴더에 저장됩니다.
- 기존 대시보드에 결과를 추가할 수 없습니다.
- 레거시 대시보드에 추가를 클릭하여 새 또는 기존 레거시 대시보드에 결과 탭을 추가합니다.
- 다운로드 옵션을 클릭하여 결과를 다운로드합니다. 세부 정보 및 제한은 다음 설명을 참조하세요.
결과 다운로드: 결과를 CSV, TSV, Excel 파일로 다운로드할 수 있습니다.
Databricks SQL의 최대 약 1GB 결과 데이터를 CSV 및 TSV 형식으로 다운로드하고 최대 100,000개 행을 Excel 파일로 다운로드할 수 있습니다.
최종 파일 다운로드 크기는 1GB 제한이 최종 파일 다운로드보다 이전 단계에 적용되므로 1GB보다 약간 많거나 작을 수 있습니다.
참고 항목
쿼리를 다운로드할 수 없는 경우 작업 영역 관리자가 작업 영역에 대한 다운로드를 사용하지 않도록 설정한 것입니다.
지난 실행
전체 쿼리 구문을 포함하여 쿼리에 대한 이전 실행을 볼 수 있습니다. 이전 실행은 읽기 전용 모드로 열리고 새 쿼리에 복제하거나 편집을 재개하는 단추를 포함합니다. 이 탭에 예약된 실행은 표시되지 않습니다.
결과 탐색
반환된 쿼리 결과가 쿼리 아래에 표시됩니다. 원시 결과 탭은 반환된 행으로 채워집니다. 기본 제공 필터를 사용하여 값을 오름차순 또는 내림차순으로 다시 정렬할 수 있습니다. 필터를 사용하여 특정 값이 포함된 결과 행을 검색할 수도 있습니다.
결과 창의 탭을 사용하여 시각화, 필터 및 매개 변수를 추가할 수 있습니다.
쿼리 창에서 저장된 쿼리 목록 필터링
쿼리 창에서 사용자가 만든 쿼리 목록(내 쿼리), 즐겨찾기, 태그별로 모든 쿼리 목록을 필터링할 수 있습니다.
업데이트 자동화
일정 단추를 사용하여 쿼리 실행에 대한 자동 주기를 설정할 수 있습니다. 자동 업데이트는 대시보드 및 보고서를 최신 데이터로 최신 상태로 유지하는 데 도움이 될 수 있습니다. 예약된 쿼리는 값이 지정된 임계값에 도달하면 알림을 보내는 특별한 유형의 예약된 작업인 Databricks SQL 경고를 사용하도록 설정할 수도 있습니다.
쿼리 예약을 참조하세요.
Databricks SQL 경고란?을 참조하세요.
쿼리 공유
공유 단추를 사용하면 작업 영역의 다른 사용자와 쿼리를 공유할 수 있습니다. 공유할 때 다음 옵션 중에서 선택합니다.
- 소유자로 실행(소유자의 자격 증명): 이 설정은 뷰어에서 쿼리 소유자와 동일한 쿼리 결과를 볼 수 있음을 의미합니다. 이는 예약된 쿼리 또는 수동 쿼리 실행에 적용됩니다.
- 뷰어로 실행(뷰어 자격 증명): 이 설정은 결과를 뷰어의 할당된 권한으로 제한합니다.
쿼리 권한 구성을 참조하세요.
다음 단계
Azure Databricks UI를 사용하여 쿼리를 사용하는 방법을 알아보려면 저장된 쿼리 관리 및 접근를 참조하세요.