쿼리 기록
참고
작업 영역이 서버리스 컴퓨팅에 사용하도록 설정된 경우 쿼리 기록에는 Notebook 및 작업에 대한 서버리스 컴퓨팅에서 실행되는 모든 SQL 및 Python 쿼리도 포함됩니다. 서버리스 컴퓨팅에 연결 문서를 참조하세요.
작업 영역에 DLT용 쿼리 기록 & 프로필이 경우(공개 미리 보기) 쿼리 기록에 SQL 웨어하우스 또는 DLT 파이프라인을 통해 실행되는 CREATE 및 REFRESH 문이 표시됩니다.
이 화면을 통해 사용할 수 있는 정보를 사용하여 쿼리 문제를 디버그할 수 있습니다.
이 섹션에서는 UI를 사용하여 쿼리 기록으로 작업하는 방법에 대해 설명합니다. API를 사용하여 쿼리 기록을 사용하려면 쿼리 기록참조하세요.
쿼리 기록 보기
쿼리에 대한 이전 실행을 보려면 다음을 수행합니다.
- 사이드바에서
을 클릭하고 쿼리 기록을 클릭합니다. - 필요에 따라 페이지 맨 위에 있는 필터를 사용하여 사용자, 날짜 범위, 컴퓨팅, 기간, 쿼리 상태, 문 유형 및 문 ID별로 목록을 필터링합니다.
Databricks SQL 쿼리의 경우 적어도 CAN MONITOR 권한이 없는 관리자가 아닌 사용자는 쿼리 기록에서만 자신의 쿼리를 볼 수 있습니다.
참고
Databricks SQL 쿼리는 소유자 권한으로 실행하도록 설정된 사용자가 CAN RUN 권한이 있는 다른 사용자와 공유할 때, 쿼리를 공유하는 사용자의 쿼리 기록이 아닌 쿼리를 실행하는 사용자의 쿼리 기록에 표시됩니다.
쿼리 세부 정보 보기
전체 쿼리 문, 쿼리 원본, 기간, 반환된 행 수, I/O 성능 또는 실행 세부 정보와 같은 쿼리에 대한 세부 정보를 보려면
쿼리 기록을 봅니다.
쿼리의 이름을 클릭합니다.
- 명세 ID: 지정된 쿼리 개체와 연결된 UUID(범용 고유 식별자)입니다.
- 쿼리 상태: 쿼리의 현재 상태(큐, 실행 중, 완료됨, 실패 또는 취소됨)로 태그가 지정됩니다.
- 컴퓨팅 유형: 이 필드는 쿼리에 사용되는 컴퓨팅 형식을 보여 있습니다.
-
쿼리 문: 이 섹션에는 전체 쿼리 문이 포함되어 있습니다. 쿼리가 너무 길어 미리 보기에 표시되지 않는 경우,
아이콘을 클릭하여 쿼리를 확장하고 전체 텍스트를 확인하세요. - 쿼리 원본: 이 필드에는 쿼리가 시작된 위치가 표시됩니다. 쿼리는 AI/BI 대시보드, 쿼리 개체, Databricks SQL 편집기, Notebook 및 DLT 파이프라인(공개 미리 보기)을 비롯한 다양한 원본에서 가져올 수 있습니다.
- 벽시계 기간: 예약 시작과 쿼리 실행 종료 사이의 경과된 벽시계 시간을 보여 줍니다. 합계는 예약 시간과 실행 시간의 합계로 자동으로 표시됩니다. 자세히 알아보려면 각 필드를 하위 범주로 확장할 수 있습니다.
- 요약 세부 정보: 패널의 맨 아래에는 집계된 작업 시간, 읽기 및 반환된 행, 파일 및 파티션, 발생할 수 있는 분산을 포함하여 쿼리 성능에 대한 요약 세부 정보가 포함됩니다.
실행 계획을 포함하여 쿼리 성능에 대한 자세한 내용을 보려면 페이지 아래쪽에서 쿼리 프로필 보기를 클릭합니다. 자세한 내용은 쿼리 프로필을 참조하세요.
쿼리 실행 종료
사용자 또는 다른 사용자가 시작한 장기 실행 쿼리를 종료하려면 다음을 수행합니다.
쿼리 기록을 봅니다.
쿼리의 이름을 클릭합니다.
상태 옆에 있는 취소를 클릭합니다.
참고
취소는 쿼리가 실행 중인 경우에만 나타납니다.
쿼리가 종료되고 상태가 Canceled로 변경됩니다.
참고
DLT 계산을 사용하는 문장은 파이프라인 UI에서만 취소할 수 있습니다.
쿼리 기록 시스템 테이블에 액세스
Azure Databricks 시스템 테이블에는 권한 있는 사용자가 계정 전체에서 테이블 형식 쿼리 기록 레코드를 볼 수 있는 쿼리 기록 테이블(system.query.history)이 포함되어 있습니다. 기본적으로 관리자만 계정의 시스템 테이블에 액세스할 수 있습니다. 쿼리 기록 시스템 테이블을 사용하도록 설정하고 액세스하는 방법에 대한 자세한 내용은 쿼리 기록 시스템 테이블 참조참조하세요.