활동 모니터링하기¶

쿼리 세부 정보¶

Query Details tab 은 추가 정보와 함께 쿼리 결과를 제공합니다. Query Details tab 은 쿼리 페이지의 기본 탭입니다. Query Details tab 은 다음 섹션을 제공합니다.

• Details

• SQL Text

• Results

Details 섹션에서는 다음을 비롯하여 쿼리 실행에 대한 추가 정보를 제공합니다.

• 쿼리의 상태.

• 쿼리 시작 시간.

• 쿼리 종료 시간.

• 쿼리 기간.

• 쿼리 ID.

• 세션 ID.

• 드라이버 상태.

• 클라이언트 드라이버.

SQL Text 섹션에서는 쿼리의 실제 텍스트를 제공합니다. SQL 텍스트 위로 마우스를 가져가 워크시트에서 텍스트를 열거나 텍스트를 복사합니다.

Results 섹션에서는 쿼리의 결과를 제공합니다. Export Query 를 선택하여 결과를 .csv 파일로 내보냅니다.

쿼리 프로필¶

Query Profile 탭을 통해 쿼리 실행 계획을 탐색하고 각 실행 단계에 대해 세분화된 정보를 파악할 수 있습니다.

쿼리 프로필은 쿼리의 역학을 이해할 수 있는 강력한 도구입니다. 특정 쿼리의 성능이나 동작에 대해 자세히 확인해야 할 때마다 사용할 수 있으며, 잠재적인 성능 병목 현상 및 향상 기회를 식별하기 위해 SQL 쿼리식에서 일반적인 실수를 확인할 수 있도록 설계되었습니다.

이 섹션에서는 쿼리 프로필을 탐색하고 사용하는 방법에 대한 간략한 개요를 제공합니다.

• 쿼리 실행 계획

• 연산자 노드

• 쿼리 프로필 탐색

• 정보 창

인터페이스	설명
쿼리 실행 계획	쿼리 실행 계획은 쿼리 프로필 중앙에 표시됩니다. 쿼리 실행 계획은 행 세트 연산자를 나타내는 연산자 노드로 구성됩니다. 연산자 노드 사이의 화살표는 한 연산자에서 다른 연산자로 이동하는 행 세트를 나타냅니다.
연산자 노드	각 연산자 노드는 다음을 포함합니다. 연산자 타입 및 ID 번호. 이 연산자를 실행하는 데 사용된 시간으로, 쿼리 기간의 백분율로 표시됩니다. 연산자 세부 정보 미리 보기. 예: 테이블 이름 또는 식 목록.
쿼리 프로필 탐색	쿼리 프로필의 왼쪽 위 모서리에서 이 버튼을 사용해 다음 작업을 수행할 수 있습니다. 실행 단계 간 이동. 창에 쿼리 실행 계획 맞추기. 쿼리 실행 계획 확대 및 축소. 참고 단계는 쿼리가 단계적으로 실행되는 경우에만 나타납니다.
정보 창	쿼리 프로필에서는 다양한 정보 창을 제공합니다. 이러한 창은 쿼리 실행 계획에 나타납니다. 나타나는 창은 쿼리 실행 계획의 포커스에 따라 다릅니다. 쿼리 프로필은 다음 정보 창을 포함합니다. Profile Overview Statistics Most Expensive Nodes Attributes 창에서 제공하는 정보에 대한 자세한 내용은 쿼리 기록 참조 를 확인해 보십시오.

프로필 개요¶

이 창에서는 쿼리 시간을 사용한 처리 작업에 대한 정보를 제공합니다. 실행 시간은 쿼리를 처리하는 동안 《시간이 사용된 위치》에 대한 정보를 제공합니다. 사용한 시간은 다음의 카테고리로 분류할 수 있습니다.

• Processing — CPU에서 데이터를 처리하기 위해 사용된 시간입니다.

• Local Disk IO — 로컬 디스크 액세스에 의해 처리가 차단된 시간입니다.

• Remote Disk IO — 원격 디스크 액세스에 의해 처리가 차단된 시간입니다.

• Network Communication — 처리에서 네트워크 데이터 전송을 대기 중이었던 시간입니다.

• Synchronization — 참여 프로세스 사이에서의 다양한 동기화 활동입니다.

• Initialization — 쿼리 처리를 설정하기 위해 사용된 시간입니다.

통계¶

세부 정보 창에서 제공되는 주요 정보 소스는 다양한 통계이며, 이는 다음 섹션으로 그룹화됩니다.

• IO — 쿼리 중에 수행된 입출력 작업에 대한 정보:

  • 스캔 진행률 — 해당 테이블에서 현재 스캔한 데이터의 백분율입니다.

  • 스캔된 바이트 수 — 현재까지 스캔한 바이트 수입니다.

  • 캐시에서 스캔된 백분율 — 로컬 디스크 캐시에서 스캔한 데이터의 백분율입니다.

  • 작성된 바이트 수 — 기록된 바이트 수(예: 테이블에 로드할 때)입니다.

  • 결과에 작성된 바이트 수 — 결과 오브젝트에 기록된 바이트 수입니다. 예를 들어, select * from . . . 은 선택 항목에 있는 각 필드를 나타내는 표 형식의 결과 세트를 생성합니다. 일반적으로, 결과의 결과로 생성된 모든 것을 나타내고 결과에 작성된 바이트 수 는 반환된 결과의 크기를 나타냅니다.

  • 결과에서 읽은 바이트 수 — 결과 오브젝트에서 읽은 바이트 수입니다.

  • 스캔된 외부 바이트 수 — 외부 오브젝트(예: 스테이지)에서 읽은 바이트 수입니다.

• DML — 데이터 조작 언어(DML) 쿼리에 대한 통계:

  • 삽입된 행 수 — 테이블 1개(또는 테이블 여러 개)에 삽입된 행 수입니다.

  • 업데이트된 행 수 — 테이블에서 업데이트된 행 수입니다.

  • 삭제된 행 수 — 테이블에서 삭제된 행 수입니다.

  • 언로드된 행 수 — 데이터 내보내기 중 언로드된 행 수입니다.

• Pruning — 테이블 정리의 효과에 대한 정보:

  • 스캔된 파티션 — 현재까지 스캔한 파티션의 수입니다.

  • 파티션 총계 — 지정된 테이블의 총 파티션 수입니다.

• Spilling — 임시 결과가 메모리에 적합하지 않는 작업에 대한 디스크 사용량 정보:

  • 로컬 저장소로 분산된 바이트 수 —로컬 디스크에 분산된 데이터 볼륨입니다.

  • 원격 저장소로 분산된 바이트 수 —원격 디스크에 분산된 데이터 볼륨입니다.

• Network — 네트워크 통신:

  • 네트워크를 통해 전송된 바이트 수 — 네트워크를 통해 전송된 데이터의 양입니다.

• External Functions — 외부 함수 호출에 대한 정보:

  SQL 문에 의해 호출되는 각 외부 함수와 관련하여 다음과 같은 통계가 표시됩니다. 동일한 SQL 문에서 동일한 함수가 두 번 이상 호출되면 통계가 집계됩니다.

  • 총 호출 수 — 외부 함수가 호출된 횟수입니다. (행을 나누는 일괄 처리의 수, 재시도 횟수(일시적인 네트워크 장애가 있는 경우) 등으로 인해 SQL 문의 텍스트에 표시된 외부 함수 호출 횟수와 다를 수 있음)

  • 전송된 행 수 — 외부 함수로 전송된 행의 개수입니다.

  • 수신된 행 수 — 외부 함수로부터 수신된 행의 개수입니다.

  • 전송된 바이트 수(x-리전) — 외부 함수로 전송된 행의 개수입니다. 레이블에 《(x-리전)》이 포함된 경우, 데이터가 여러 리전으로 전송되었습니다(청구에 영향을 줄 수 있음).

  • 수신된 바이트 수(x-리전) — 외부 함수로부터 수신된 행의 개수입니다. 레이블에 《(x-리전)》이 포함된 경우, 데이터가 여러 리전으로 전송되었습니다(청구에 영향을 줄 수 있음).

  • 일시적인 오류로 인한 재시도 — 일시적인 오류로 인한 재시도 횟수입니다.

  • 호출당 평균 지연 시간 — Snowflake가 데이터를 전송한 후 반환된 데이터를 수신한 시간 사이의 호출당 평균 시간입니다.

  • HTTP 4xx 오류 — 4xx 상태 코드를 반환한 총 HTTP 요청 수입니다.

  • HTTP 5xx 오류 — 5xx 상태 코드를 반환한 총 HTTP 요청 수입니다.

  • 성공한 호출당 대기 시간(평균) — 성공적인 HTTP 요청의 평균 대기 시간입니다.

  • 평균 제한 대기 시간 오버헤드 — 제한에 따른 속도 저하로 인한 성공적인 요청당 평균 오버헤드입니다(HTTP 429).

  • 제한으로 인해 재시도된 배치 — HTTP 429 오류로 인해 재시도된 배치 수입니다.

  • 성공한 호출당 대기 시간(P50) — 성공적인 HTTP 요청의 50번째 백분위수 대기 시간입니다. 성공적인 모든 요청의 50%가 완료하는 데 이 시간보다 짧게 걸렸습니다.

  • 성공한 호출당 대기 시간(P90) — 성공적인 HTTP 요청의 90번째 백분위수 대기 시간입니다. 성공적인 모든 요청의 90%가 완료하는 데 이 시간보다 짧게 걸렸습니다.

  • 성공한 호출당 대기 시간(P95) — 성공적인 HTTP 요청의 95번째 백분위수 대기 시간입니다. 성공적인 모든 요청의 95%가 완료하는 데 이 시간보다 짧게 걸렸습니다.

  • 성공한 호출당 대기 시간(P99) — 성공적인 HTTP 요청의 99번째 백분위수 대기 시간입니다. 성공적인 모든 요청의 99%가 완료하는 데 이 시간보다 짧게 걸렸습니다.

• Extension Functions — 확장 함수 호출에 대한 정보:

  • Java UDF handler load time — 로드할 Java UDF 처리기를 위한 시간입니다.

  • Total Java UDF handler invocations — Java UDF 처리기가 호출되는 횟수입니다.

  • Max Java UDF handler execution time — 실행할 Java UDF 처리기의 최대 시간입니다.

  • Avg Java UDF handler execution time — Java UDF 처리기를 실행할 평균 시간입니다.

  • Java UDTF process() invocations — Java UDTF 프로세스 메서드 가 호출된 횟수입니다.

  • Java UDTF process() execution time — Java UDTF 프로세스 실행에 걸리는 시간입니다.

  • Avg Java UDTF process() execution time — Java UDTF 프로세스 실행에 걸린 평균 시간입니다.

  • Java UDTF’s constructor invocations — Java UDTF 생성자 가 호출된 횟수입니다.

  • Java UDTF’s constructor execution time — Java UDTF 생성자 실행에 걸리는 시간입니다.

  • Avg Java UDTF’s constructor execution time — Java UDTF 생성자 실행에 걸리는 평균 시간입니다.

  • Java UDTF endPartition() invocations — Java UDTF endPartition 메서드 가 호출된 횟수입니다.

  • Java UDTF endPartition() execution time — Java UDTF endPartition 메서드 실행에 걸리는 시간입니다.

  • Avg Java UDTF endPartition() execution time — Java UDTF endPartition 메서드 실행에 걸리는 평균 시간입니다.

  • Max Java UDF dependency download time — Java UDF 종속 항목 다운로드에 걸리는 최대 시간입니다.

  • Max JVM memory usage — JVM에서 보고한 최대 메모리 사용량입니다.

  • Java UDF inline code compile time in ms — Java UDF 인라인 코드의 컴파일 시간입니다.

  • Total Python UDF handler invocations — Python UDF 처리기가 호출된 횟수입니다.

  • Total Python UDF handler execution time — Python UDF 처리기의 총 실행 시간입니다.

  • Avg Python UDF handler execution time — Python UDF 처리기 실행에 걸리는 평균 시간입니다.

  • Python sandbox max memory usage — Python 샌드박스 환경의 최대 메모리 사용량입니다.

  • Avg Python env creation time: Download and install packages — 패키지 다운로드와 설치를 포함하여 Python 환경을 만드는 데 걸리는 평균 시간입니다.

  • Conda solver time — Python 패키지를 해결하기 위해 Conda 솔버를 실행하는 데 걸리는 시간입니다.

  • Conda env creation time — Python 환경을 만드는 데 걸리는 시간입니다.

  • Python UDF initialization time — Python UDF를 초기화하는 데 걸리는 시간입니다.

  • Number of external file bytes read for UDFs — UDF에 대해 읽은 외부 파일 바이트 수입니다.

  • Number of external files accessed for UDFs — UDF에 대해 액세스한 외부 파일 수입니다.

  필드 값(예: 《일시적인 오류로 인한 재시도》)이 0이면 필드가 표시되지 않습니다.

가장 부담이 큰 노드¶

이 창에는 쿼리의 총 실행 시간(또는 쿼리가 여러 처리 단계에서 실행되는 경우 표시된 쿼리 단계의 실행 시간) 중 1% 이상 동안 유지된 모든 노드가 나열됩니다. 그리고 실행 시간별로 노드가 내림차순으로 나열되어 사용자가 실행 시간의 측면에서 가장 비용이 많이 소요되는 연산자 노드를 빠르게 찾을 수 있습니다.

속성¶

다음 섹션에서는 가장 일반적인 연산자 타입의 목록 및 속성을 제공합니다.

《급증하는》 조인¶

SQL 사용자가 저지르는 일반적인 실수 중 하나는 조인 조건을 제공하지 않고 테이블을 조인하거나(그로 인해 《데카르트 곱》이 수행됨) 한 테이블의 레코드가 다른 테이블의 여러 레코드와 일치하는 조건을 제공하는 것입니다. 이러한 쿼리의 경우 Join 연산자에서는 사용량보다 훨씬 더 많은 튜플을 생성(크기 기준)합니다.

이는 Join 연산자가 생성한 레코드의 수를 통해 확인할 수 있으며, 일반적으로 Join 연산자에서 오랜 시간이 걸리는 원인이 됩니다.

ALL을 제외한 UNION¶

SQL에서는 UNION 또는 UNION ALL 구문으로 두 데이터 세트를 결합할 수 있습니다. 차이점은 UNION ALL는 단순히 입력을 연결하는 반면 UNION은 동일하게 연결하지만 중복 제거를 수행한다는 점입니다.

일반적인 실수는 UNION ALL 의미 체계로 충분한 상황에서 UNION를 사용하는 것입니다. 이러한 쿼리는 쿼리 프로필에 UnionAll 연산자로 표시되며 맨 위에는 추가 Aggregate 연산자(중복 제거 수행)가 표시됩니다.

너무 커서 메모리에 적합하지 않은 쿼리¶

일부 작업(예: 방대한 데이터 세트에 대한 중복 제거)의 경우 작업을 실행하기 위해 사용되는 서버의 가용 메모리가 임시 결과를 유지하기에 충분하지 않을 수 있습니다. 결과적으로 쿼리 처리 엔진은 데이터를 로컬 디스크로 유출 하기 시작합니다. 로컬 디스크 공간이 충분하지 않으면 유출된 데이터가 원격 디스크에 저장됩니다.

이러한 유출은 쿼리 성능에 커다란 영향을 미칠 수 있습니다(특히 유출에서 원격 디스크가 사용되는 경우). 이를 완화하기 위한 권장 사항은 다음과 같습니다.

• 더 큰 크기의 웨어하우스 사용(사실상 작업에서 사용할 수 있는 메모리/로컬 디스크 공간을 증가) 및/또는

• 크기가 더 작은 일괄 처리로 데이터 처리.

비효율적인 정리¶

Snowflake는 데이터에 대한 풍부한 통계를 수집하여 쿼리 필터를 기반으로 테이블의 불필요한 부분을 읽을 필요가 없습니다. 그러나 이를 위해서는 데이터 저장소 순서가 쿼리 필터 속성과 관련이 있어야 합니다.

정리의 효율성은 TableScan 연산자에서 스캔된 파티션 및 전체 파티션 통계를 비교하여 확인할 수 있습니다. 전자가 후자에 비해 일부에 불과하면 정리가 효율적인 것입니다. 그렇지 않으면, 정리가 효과가 없는 것입니다.

물론, 정리는 실제로 상당한 양의 데이터를 필터링하는 쿼리에만 유용할 수 있습니다. 정리 통계에는 데이터 감소가 표시되지 않지만, 대량의 레코드를 필터링하는 TableScan 상단에 Filter 연산자가 있는 경우 다른 데이터 구성이 이 쿼리에 유용하다는 신호가 될 수 있습니다.

정리에 대한 자세한 내용은 Snowflake 테이블 구조 이해하기 을 참조하십시오.