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

Azure Databricks UI에는 쿼리를 작성하고, 사용 가능한 데이터를 찾아보고, 시각화를 만드는 데 사용할 수 있는 SQL 편집기가 포함되어 있습니다. 저장된 쿼리를 작업 영역의 다른 팀 구성원과 공유할 수도 있습니다.

편집기를 연 후 SQL 쿼리를 작성하거나 사용 가능한 데이터를 찾아볼 수 있습니다. 텍스트 편집기에서는 자동 완성, 자동 서식 지정 및 기타 다양한 바로 가기 키를 지원합니다.

텍스트 편집기의 맨 위에 있는 쿼리 탭을 사용하여 여러 쿼리를 열 수 있습니다. 각 쿼리 탭에는 쿼리를 실행하고, 쿼리를 즐겨찾기로 표시하고, SQL 웨어하우스에 연결하는 컨트롤이 있습니다. 쿼리를 저장, 예약 또는 공유할 수도 있습니다.

컴퓨팅에 연결

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

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

SQL 웨어하우스 옆의 아이콘은 다음과 같은 상태를 나타냅니다.

• 실행 중
• 시작
• 중지

참고 항목

목록에 SQL 웨어하우스가 없는 경우 작업 영역 관리자에게 문의하세요.

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

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(기존 쿼리 열기)를 선택합니다. 기존 쿼리 열기를 클릭하여 저장된 쿼리 목록을 확인합니다. 내 쿼리 또는 즐겨찾기를 클릭하여 쿼리 목록을 필터링합니다. 보려는 쿼리가 포함된 행에서 열기를 클릭합니다.

단일 쿼리 또는 여러 쿼리 실행

쿼리 하나 또는 모든 쿼리를 실행하려면 다음을 수행합니다.

1. SQL 웨어하우스를 선택합니다.

2. SQL 편집기에서 쿼리를 강조 표시합니다(쿼리 창에 여러 쿼리가 있는 경우).

3. Ctrl/Cmd + Enter 키를 누르거나 실행(1000)을 클릭하여 결과 창에 결과를 테이블로 표시합니다.

   

참고 항목

쿼리 반환을 1000 개 행으로 제한하기 위해 모든 쿼리에 대해 기본적으로 제한 1000이 선택됩니다. 제한 1000 설정으로 쿼리를 저장하는 경우 이 설정은 대시보드에 포함된 모든 쿼리 실행에 적용됩니다. 이 쿼리에 대한 모든 행을 반환하려면 실행(1000) 드롭다운을 클릭하여 LIMIT 1000의 선택을 취소할 수 있습니다. 행 수에 대해 다른 제한을 지정하려는 경우 원하는 값으로 쿼리에 LIMIT 절을 추가할 수 있습니다.

쿼리 종료

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

쿼리 옵션

쿼리 편집기 위쪽에 있는 kebab 상황에 맞는 메뉴를 사용하여 메뉴 옵션에 액세스하여 쿼리 정보를 복제, 되돌리기, 서식 지정 및 편집할 수 있습니다.

저장된 쿼리로 되돌리기

쿼리를 편집하면 변경 내용 되돌리기 옵션이 쿼리의 바로 가기 메뉴에 표시됩니다. 되돌리기를 클릭하면 저장된 버전으로 돌아갈 수 있습니다.

쿼리 해제카드 및 복원

쿼리를 휴지통으로 이동하려면 다음을 수행합니다.

• SQL 편집기에서 쿼리 옆에 있는 kebab 상황에 맞는 메뉴를 클릭하고 휴지통으로 이동을 선택합니다.
• 휴지통으로 이동을 클릭하여 확인합니다.

쿼리를 휴지통에서 복원하려면 다음을 수행합니다.

1. 모든 쿼리 목록에서 을 클릭합니다 .
2. 쿼리를 클릭합니다.
3. SQL 편집기의 오른쪽 위에 있는 kebab 상황에 맞는 메뉴를 클릭하고 복원을 클릭합니다.

쿼리 설명 설정 및 쿼리 정보 보기

쿼리 설명을 설정하려면 다음을 수행합니다.

1. 쿼리 옆에 있는 kebab 상황에 맞는 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다.

   

2. 설명 텍스트 상자에 설명을 입력합니다. 그런 다음, 저장을 클릭합니다. 이 대화 상자에서 쿼리가 만들어지고 업데이트된 시기를 포함하여 쿼리의 기록을 볼 수도 있습니다.

즐겨찾기 및 태그 쿼리

즐겨찾기 및 태그를 사용하여 작업 영역 방문 페이지 및 대시보드 및 쿼리에 대한 각 목록 페이지에 표시되는 쿼리 및 대시보드 목록을 필터링할 수 있습니다.

즐겨찾기: 쿼리를 즐겨찾기하려면 쿼리 목록에서 제목 왼쪽에 있는 별표를 클릭합니다. 별이 노란색으로 변합니다.

태그: 의미 있는 문자열을 사용하여 쿼리 및 대시보드에 조직에 태그를 지정할 수 있습니다.

태그 추가

쿼리 편집기에서 태그를 추가합니다.

1. 쿼리 옆에 있는 kebab 상황에 맞는 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다. 쿼리 정보 대화 상자가 나타납니다.

2. 쿼리에 태그가 적용되지 않은 경우 태그가 표시되는 텍스트 상자에 일부 태그를 추가합니다. 새 태그를 만들려면 상자에 태그를 입력합니다. 여러 태그를 입력하려면 항목 간에 Tab 키를 누릅니다.

   

3. 저장을 클릭하여 태그를 적용하고 대화 상자를 닫습니다.

태그 제거

1. 쿼리 옆에 있는 kebab 상황에 맞는 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다.
2. 제거할 태그에서 X를 클릭합니다.
3. 저장을 클릭하여 대화 상자를 닫습니다.

쿼리 결과 보기

쿼리가 실행되면 그 아래 창에 결과가 표시됩니다. 새 결과 테이블은 새 쿼리에 대해 ON입니다. 필요한 경우 드롭다운을 클릭하여 해제합니다. 이 섹션의 이미지는 새 결과 테이블을 사용합니다.

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

시각화, 필터 및 매개 변수

시각화, 필터 또는 매개 변수를 추가하려면 이 옵션을 클릭합니다. 다음 옵션이 표시됩니다.

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

필터: 필터를 사용하면 쿼리가 실행된 후 결과 집합을 제한할 수 있습니다. 필터를 적용하여 데이터의 여러 하위 집합을 선택적으로 표시할 수 있습니다. 필터를 사용하는 방법을 알아보려면 쿼리 필터를 참조하세요.

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

결과 다운로드 또는 사용자 지정

다운로드 및 사용자 지정 옵션을 보려면 이 옵션을 클릭합니다.

사용자 지정 테이블 만들기: 이 옵션은 UI를 사용하여 원래 쿼리의 결과를 수정할 수 있는 새 결과 패널을 엽니다. 테이블 수준의 표시에서 행 번호를 제거하거나 특정 열을 숨길 수 있습니다.

열 이름을 클릭하여 단일 열을 변경할 수도 있습니다. 열 이름과 서식을 변경할 수 있습니다. 표시에 사용되는 데이터 형식을 변경하고 행의 조건부 서식을 지정할 수도 있습니다.

다운로드 결과: CSV, TSV 또는 Excel 파일로 결과를 다운로드할 수 있습니다.

Databricks SQL에서 CSV 및 TSV 형식으로 최대 1GB의 결과 데이터를 다운로드하고 최대 100,000개의 행을 Excel 파일로 다운로드할 수 있습니다.

최종 파일 다운로드 크기는 1GB 제한이 최종 파일 다운로드보다 이전 단계에 적용되므로 1GB보다 약간 많거나 작을 수 있습니다.

참고 항목

쿼리를 다운로드할 수 없는 경우 작업 영역 관리자가 작업 영역에 대한 다운로드를 사용하지 않도록 설정했습니다.

지난 실행

전체 쿼리 구문을 포함하여 쿼리에 대한 이전 실행을 볼 수 있습니다. 이전 실행은 읽기 전용 모드로 열리고 새 쿼리에 복제하거나 편집을 다시 시작하는 단추를 포함합니다. 이 탭에는 예약된 실행이 표시되지 않습니다.

결과 탐색

반환된 쿼리 결과가 쿼리 아래에 표시됩니다. 원시 결과 탭은 반환된 행으로 채워집니다. 기본 제공 필터를 사용하여 값을 오름차순 또는 내림차순으로 다시 정렬할 수 있습니다. 필터를 사용하여 특정 값이 포함된 결과 행을 검색할 수도 있습니다.

결과 창의 탭을 사용하여 시각화, 필터 및 매개 변수를 추가할 수 있습니다.

쿼리 창에서 저장된 쿼리 목록 필터링

쿼리 창에서 만든 쿼리 목록(내 쿼리), 즐겨찾기 및 태그별로 모든 쿼리 목록을 필터링할 수 있습니다.

업데이트 자동화

일정 단추를 사용하여 쿼리 실행에 대한 자동 주기를 설정할 수 있습니다. 자동 업데이트는 대시보드 및 보고서를 최신 데이터로 최신 상태로 유지하는 데 도움이 될 수 있습니다. Schedueled 쿼리는 값이 지정된 임계값에 도달하면 알림을 보내는 특별한 유형의 예약된 작업인 Databricks SQL 경고를 사용하도록 설정할 수도 있습니다.

쿼리 예약을 참조하세요.

Databricks SQL 경고란?을 참조하세요.

쿼리 공유

공유 단추를 사용하면 작업 영역의 다른 사용자와 쿼리를 공유할 수 있습니다. 공유할 때 다음 옵션 중에서 선택합니다.

• 소유자로 실행(소유자의 자격 증명): 이 설정은 뷰어에서 쿼리 소유자와 동일한 쿼리 결과를 볼 수 있음을 의미합니다. 이는 예약된 쿼리 또는 수동 쿼리 실행에 적용됩니다.
• 보기로 실행(뷰어 자격 증명): 이 설정은 결과를 뷰어의 할당된 권한으로 제한합니다.

쿼리 권한 구성을 참조 하세요.

다음 단계

Azure Databricks UI를 사용하여 쿼리를 사용하는 방법을 알아보려면 Access 및 저장된 쿼리 관리를 참조하세요.