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

Azure Databricks UI에는 쿼리를 작성하고, 사용 가능한 데이터를 찾아보고, 시각화를 만드는 데 사용할 수 있는 SQL 편집기가 포함되어 있습니다. 저장된 쿼리를 작업 영역의 다른 팀 구성원과 공유할 수도 있습니다. 이 문서에서는 SQL 편집기를 사용하여 쿼리를 작성, 실행 및 관리하는 방법을 설명합니다. SQL 편집기의 새 버전은 공개 미리 보기로 제공됩니다. 새 SQL 편집기를 사용하도록 설정하고 작업하는 방법을 알아보려면 새 SQL 편집기를 사용하여 동료와 공동 작업을 참조하세요.

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

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

SQL 편집기 열기

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

SQL 편집기가 마지막으로 열린 쿼리로 열립니다. 쿼리가 없거나 모든 쿼리가 명시적으로 닫힌 경우 새 쿼리가 열립니다. 새 쿼리라는 이름이 자동으로 지정되고 만들기 타임스탬프가 제목에 추가됩니다.

컴퓨팅에 연결

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

처음으로 쿼리를 만들 때, 사용 가능한 SQL 웨어하우스의 list이(가) 사전순으로 나타납니다. 마지막으로 사용한 SQL Warehouse는 다음에 쿼리를 만들 때 선택됩니다.

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

• 실행
• 시작
• 중지

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

SQL 편집기에서 데이터 개체 찾아보기

메타데이터 읽기 권한이 있으면 SQL 편집기에서 schema 브라우저가 사용 가능한 데이터베이스와 tables을(를) 표시합니다. Catalog Explorer데이터 객체를 찾아볼 수도 있습니다.

활성 컴퓨팅 없이 Catalog 탐색기에서 Unity Catalog관리되는 데이터베이스 개체를 탐색할 수 있습니다. Unity Catalog에 의해 제어되지 않는 hive_metastore 및 기타 catalogs 데이터를 탐색하려면 적절한 권한으로 컴퓨팅 리소스에 접속해야 합니다. Unity 데이터 거버넌스를 참조하십시오 Catalog.

schema 브라우저 위쪽에 있는 을 클릭하여 schema을/를 refresh하십시오. 검색 상자에 필터 문자열을 입력하여 schema 필터링할 수 있습니다.

table 이름을 클릭하면 해당 table의 columns이 표시됩니다.

쿼리 만들기

텍스트를 입력하여 SQL 편집기에서 쿼리를 만들 수 있습니다. schema 브라우저에서 요소를 insert하여 catalogs 및 tables을 참조할 수 있습니다.

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

   SQL 편집기에서는 자동 완성을 지원합니다. 입력할 때 자동 완성에서 완성을 추천합니다. 예를 들어 커서 위치에서 유효한 완성이 column경우 자동 완성은 column 이름을 제안합니다. select * from table_name as t where t.을 입력할 때 자동 완성 기능은 t이 table_name의 별칭임을 인식하고 table_name내부에서 columns을 제안합니다.

   

2. (선택 사항) 편집이 끝나면 저장을 클릭합니다. 기본적으로 쿼리는 사용자 홈 폴더에 저장되거나 다른 위치를 select 수 있습니다. 그런 다음, 저장을 클릭합니다.

자동 완성 설정 및 해제

라이브 자동 완성은 schema 토큰, 쿼리 구문 식별자(예: SELECT 및 JOIN), 그리고 쿼리 스니펫의 제목을완성할 수 있습니다. 데이터베이스 schema가 5,000개 토큰(tables 또는 columns)을 초과하지 않는 한, 기본적으로 활성화됩니다.

SQL 편집기 아래의 토글을 사용하여 라이브 자동 완성을 끄거나 켭니다.

• 라이브 자동 완성을 비활성화하려면 Ctrl + 스페이스바를 누르거나 SQL 편집기 아래쪽에서 단추를 클릭합니다.

쿼리 저장

SQL 편집기의 오른쪽 위에 있는 저장 단추는 쿼리를 저장합니다.

여러 쿼리 편집

기본적으로 SQL 편집기에서는 탭을 사용하므로 여러 쿼리를 동시에 편집할 수 있습니다. 새 탭을 열려면 클릭한 다음 새 쿼리 만들거나 기존 쿼리열기 . 기존 쿼리 열기를 클릭하여 저장된 쿼리의 list 확인합니다. 내 쿼리 또는 즐겨찾기를 클릭하여 쿼리의 list을(를) 필터링합니다. 보려는 쿼리가 포함된 행에서 열기를 클릭합니다.

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

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

1. SQL 웨어하우스 Select.

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

3. Ctrl/Cmd + 입력을 누르거나 실행(1000)을 클릭하여 결과를 table 형태로 결과 창에 표시합니다.

   

쿼리 종료

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

쿼리 옵션

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

저장된 쿼리로 되돌리기

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

쿼리 삭제 및 복원

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

• SQL 편집기에서 쿼리 옆에 있는 kebab 메뉴 를 클릭한 다음 select휴지통으로 이동.
• 휴지통으로 이동을 클릭하여 확인합니다.

휴지통에서 쿼리 restore 처리하기:

1. 모든 쿼리 list에서 을(를) 클릭합니다.
2. 쿼리를 클릭합니다.
3. SQL 편집기의 오른쪽 위에 있는 kebab 컨텍스트 메뉴 를 클릭하고 Restore를 클릭합니다.

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

쿼리 설명을 set로 수행하기 위한 방법은:

1. 쿼리 옆의 케밥 컨텍스트 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다.

   

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

즐겨찾기 및 태그 쿼리

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

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

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

태그 추가

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

1. 쿼리 옆의 케밥 컨텍스트 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다. 쿼리 정보 대화 상자가 나타납니다.

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

   

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

태그 Remove

1. 쿼리 옆의 케밥 컨텍스트 메뉴를 클릭하고 쿼리 정보 편집을 클릭합니다.
2. remove태그에서 X 클릭합니다.
3. 저장을 클릭하여 대화 상자를 닫습니다.

쿼리 결과 보기

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

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

시각화, 필터 및 parameters

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

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

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

매개 변수: Parameters 런타임에 values 쿼리로 대체하여 결과 setlimit 수 있습니다. 쿼리 와 함께하는 작업을 참조하여 을 적용하는 방법을 알아보세요.

대시보드 편집, 다운로드 또는 추가

더 많은 옵션을 보려면 결과 탭에서 을(를) 클릭합니다.

1. 편집을 클릭하여 시각화에 표시된 결과를 사용자 지정합니다.
2. 삭제를 클릭하여 결과 탭을 삭제합니다.
3. 중복을 클릭하여 결과 탭을 복제합니다.
4. 대시보드에 추가를 클릭하여 쿼리 및 시각화를 새 대시보드에 복사합니다.
   • 이 작업은 쿼리와 연결된 모든 시각화를 포함하는 새 대시보드를 만듭니다. 대시보드를 편집하는 방법을 알아보려면 대시보드를 참조하세요.
   • 새 대시보드의 이름을 선택하라는 메시지가 표시됩니다. 새 대시보드가 홈 폴더에 저장됩니다.
   • 기존 대시보드에 결과를 추가할 수 없습니다.
5. 레거시 대시보드에 추가를 클릭하여 새 또는 기존 레거시 대시보드에 결과 탭을 추가합니다.
6. 다운로드 옵션을 클릭하여 결과를 다운로드합니다. 세부 정보 및 제한은 다음 설명을 참조하세요.

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

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

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

지난 실행

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

결과 탐색

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

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

쿼리 window에서 저장된 쿼리의 list를 필터링합니다.

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

업데이트 자동화

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

쿼리 예약을 참조하세요.

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

쿼리 공유

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

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

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

다음 단계

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