쿼리 기록으로 쿼리 활동 모니터링하기¶

쿼리 기록을 보기 위해 필요한 권한¶

실행한 쿼리의 기록을 언제든지 볼 수 있습니다.

다른 쿼리 기록을 보려면 활성 역할이 Query History 에서 볼 수 있는 다른 항목에 영향을 미칩니다.

• 활성 역할이 ACCOUNTADMIN 역할인 경우 계정에 대한 모든 쿼리 기록을 볼 수 있습니다.

• 활성 역할에 웨어하우스에 대해 부여된 MONITOR 또는 OPERATE 권한이 있는 경우 해당 웨어하우스를 사용하는 다른 사용자가 실행한 쿼리를 볼 수 있습니다.

• 활성 역할에 SNOWFLAKE 데이터베이스에 대한 GOVERNANCE_VIEWER 데이터베이스 역할이 부여된 경우 계정의 모든 사용자에 대한 쿼리 기록을 볼 수 있습니다. SNOWFLAKE 데이터베이스 역할 섹션을 참조하십시오.

• 활성 역할에 SNOWFLAKE 데이터베이스에 대한 READER_USAGE_VIEWER 데이터베이스 역할이 부여된 경우 계정과 연결된 독자 계정의 모든 사용자에 대한 쿼리 기록을 볼 수 있습니다. SNOWFLAKE 데이터베이스 역할 섹션을 참조하십시오.

쿼리 기록 사용 시 고려 사항¶

계정의 Query History 를 검토할 때 다음 사항을 고려하십시오.

• 세션 의 데이터 보존 정책으로 인해 7일 이상 전에 실행된 쿼리에 대한 세부 정보에는 User 정보가 포함되지 않습니다. 사용자 필터를 사용하여 개별 사용자가 실행한 쿼리를 검색할 수 있습니다. 쿼리 기록 필터링하기 섹션을 참조하십시오.

• 구문 또는 구문 분석 오류로 인해 실패한 쿼리의 경우 실행된 SQL 문 대신 <redacted> 가 표시됩니다. 적절한 권한이 있는 역할을 부여받은 경우 ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR 매개 변수를 설정하여 전체 쿼리 텍스트를 볼 수 있습니다.

• 필터와 Started 및 End Time 열은 현재 타임존을 사용합니다. 이 설정은 변경할 수 없습니다. 세션에 대한 TIMEZONE 매개 변수를 설정해도 사용되는 타임존은 변경되지 않습니다.

쿼리 기록 필터링하기¶

쿼리 기록 목록은 다음과 같이 필터링할 수 있습니다.

• 예를 들어 장기 실행 쿼리, 실패한 쿼리, 대기 중인 쿼리를 식별하기 위한 쿼리 상태입니다.

• 다음을 포함하여 쿼리를 수행한 사용자:

  • 쿼리 기록을 볼 수 있는 액세스 권한이 있는 모든 사용자를 확인할 수 있는 All.

  • 자신이 로그인한 사용자(기본값)

  • 다른 사용자의 쿼리 기록을 볼 수 있는 역할을 가진 우 계정의 개별 Snowflake 사용자.

• 쿼리가 실행된 기간(최대 14일).

• 다음을 포함한 기타 필터:

  • SQL Text. GROUP BY와 같은 특정 문을 사용하는 쿼리를 볼 수 있습니다.

  • Query ID. 특정 쿼리에 대한 세부 정보를 볼 수 있습니다.

  • Warehouse. 특정 웨어하우스를 사용하여 실행된 쿼리를 볼 수 있습니다.

  • Statement Type. DELETE, UPDATE, INSERT 또는 SELECT와 같은 특정 유형의 문을 사용한 쿼리를 볼 수 있습니다.

  • Duration. 예를 들어 특히 장기 실행 쿼리를 식별할 수 있습니다.

  • Session ID. 특정 Snowflake 세션 중에 실행되는 쿼리를 볼 수 있습니다.

  • Query Tag. QUERY_TAG 세션 매개 변수를 통해 설정된 특정 쿼리 태그가 있는 쿼리를 볼 수 있습니다.

  • Parameterized Query Hash 를 클릭하여 필터에 지정된 매개 변수화된 쿼리 해시 ID 에 따라 그룹화된 쿼리를 표시합니다. 자세한 내용은 매개 변수가 있는 쿼리의 해시(query_parameterized_hash) 사용하기 섹션을 참조하십시오.

  • Client generated statements. 웹 인터페이스를 포함하여 클라이언트, 드라이버 또는 라이브러리에서 실행되는 내부 쿼리를 볼 수 있습니다. 예를 들어, 사용자가 Snowsight 의 Warehouses 페이지로 이동할 때마다 Snowflake는 백그라운드에서 SHOW WAREHOUSES 문을 실행합니다. 이 필터가 활성화되면 해당 문이 표시됩니다. 클라이언트가 생성한 문에 대해서는 계정에 비용이 청구되지 않습니다.

  • Queries executed by user tasks. 실행된 SQL 문이나 사용자 작업으로 호출된 저장 프로시저를 볼 수 있습니다.

  • Show replication refresh history, 원격 리전과 계정에 대한 복제 새로 고침 작업을 수행하는 데 사용되는 쿼리를 볼 수 있습니다.

거의 실시간 결과를 보려면 Auto Refresh 를 활성화하십시오. Auto Refresh 가 활성화되면 테이블이 10초마다 새로 고쳐집니다.

기본적으로 Queries 테이블에서 다음 열을 볼 수 있습니다.

• SQL Text. 실행된 문의 텍스트입니다(항상 표시됨).

• Query ID. 쿼리의 ID입니다(항상 표시됨).

• Status, 실행된 문의 상태입니다(항상 표시됨).

• User. 문을 실행한 사용자 이름을 확인합니다.

• Warehouse. 문을 실행하는 데 사용된 웨어하우스를 확인합니다.

• Duration. 문을 실행하는 데 걸린 시간을 확인합니다.

• Started. 문 실행이 시작된 시간을 확인합니다.

결과가 더 많으면 테이블을 정렬할 수 없습니다. 테이블을 정렬한 후 목록 맨 위에 있는 Load More 를 선택하면 새 결과가 데이터 끝에 추가되고 정렬 순서가 더 이상 적용되지 않습니다.

보다 구체적인 정보를 보려면 Columns 를 선택하여 테이블에서 다음과 같은 열을 추가하거나 제거할 수 있습니다.

• All. 모든 열을 표시합니다.

• User 를 클릭하여 문을 실행한 사용자를 표시합니다.

• Warehouse 를 클릭하여 문을 실행하는 데 사용된 웨어하우스의 이름을 표시합니다.

• Warehouse Size. 문을 실행하는 데 사용된 웨어하우스의 크기를 표시합니다.

• Duration 을 클릭하여 문이 실행되는 데 걸린 시간을 표시합니다.

• Started 를 클릭하여 문의 시작 시간을 표시합니다.

• End Time. 문의 종료 시간을 표시합니다.

• Session ID. 문을 실행한 세션의 ID를 표시합니다.

• Client Driver. 문을 실행하는 데 사용된 클라이언트, 드라이버 또는 라이브러리의 이름과 버전을 표시합니다. 문은 Snowsight 디스플레이 Go 1.1.5 에서 실행됩니다.

• Bytes Scanned. 쿼리 처리 중에 스캔된 바이트 수를 표시합니다.

• Rows. 문에서 반환된 행 수를 표시합니다.

• Query Tag. 쿼리에 설정된 쿼리 태그를 표시합니다.

• Parameterized Query Hash 를 입력하여 필터에 지정된 매개 변수화된 쿼리 해시 ID 에 따라 그룹화된 쿼리를 표시합니다. 자세한 내용은 매개 변수가 있는 쿼리의 해시(query_parameterized_hash) 사용하기 섹션을 참조하십시오.

• Incident. 문제 해결 또는 디버깅 목적으로 사용되는 인시던트의 실행 상태의 문에 대한 세부 정보를 표시합니다.

쿼리에 대한 추가 세부 정보를 보려면 테이블에서 쿼리를 선택하여 Query Details 를 여십시오.

그룹화된 쿼리 기록 사용 방법¶

Snowsight 에서 Grouped Query History 에 액세스하려면 다음을 수행합니다.

1. Snowsight 에 로그인합니다.

2. Monitoring » Query History » Grouped Queries 를 선택합니다. 이 페이지에는 공통된 매개 변수화된 쿼리 해시 ID 를 기준으로 그룹화된 쿼리가 표시됩니다.

   참고

   개별 쿼리는 Grouped Queries 목록에 즉시 표시되지 않습니다. AGGREGATE_QUERY_HISTORY 뷰의 기록에서 목록을 업데이트하는 데 걸리는 대기 시간은 최대 180분(3시간)이지만 목록이 훨씬 빠르게 채워지는 경우가 많습니다.

3. 그룹화된 쿼리를 선택하면 해당 매개 변수화된 쿼리 해시에 대한 성능 통계를 볼 수 있습니다. Snowsight 는 실행된 총 쿼리 수, 실패한 쿼리 수, 지연 시간(p50, p90, p99) 및 분당 실행 횟수를 표시합니다. 페이지 하단 섹션에는 해당 해시의 일부로 실행된 샘플 개별 쿼리가 표시되며, 각 쿼리를 선택하여 구체적인 세부 정보를 확인할 수 있습니다.

   예를 들어, 지난 하루 동안 이 그룹에서 약 3,500만 개의 쿼리가 실행되었으며, 총 지속 시간은 196시간, 총 큐잉 시간은 87ms였습니다.

   

   페이지 하단에서 상태, 기간 및 기타 메트릭을 기준으로 쿼리 목록을 정렬할 수 있습니다.

4. Monitoring » Query History » Individual Queries 를 선택하면 개별 쿼리를 볼 수 있습니다.

   이 뷰는 하이브리드 테이블에 대해 생성될 수 있는 쿼리의 양이 매우 많기 때문에 Unistore 워크로드에서 실행되는 모든 쿼리를 반영하지는 않습니다. 이 동작에 대한 자세한 내용은 하이브리드 테이블에 대한 쿼리 기록 섹션을 참조하십시오.

   Snowflake는 Unistore 워크로드가 있는 모든 사용자가 Grouped Queries 뷰에서 시작할 것을 권장합니다.

Grouped Queries 목록을 필터링할 수는 없지만 필터링된 결과를 반환하는 집계 쿼리를 직접 실행할 수 있습니다.

그룹화된 쿼리 기록을 보는 데 필요한 권한¶

사용자는 언제든지 실행한 쿼리의 기록을 볼 수 있습니다. 사용자의 활동 역할은 표시되는 다른 쿼리에 영향을 줍니다. 다음 중 하나에 해당하는 경우 Grouped Queries 및 Individual Queries 가 모두 표시됩니다.

• 귀하의 활동 역할은 ACCOUNTADMIN 입니다.

• SNOWFLAKE 데이터베이스에서 IMPORTED PRIVILEGES 활동 역할이 부여되었습니다(SNOWFLAKE 데이터베이스의 스키마를 사용할 다른 역할 활성화 참조).

• GOVERNANCE_VIEWER 데이터베이스 역할 이 있습니다.

이러한 역할이나 권한이 없는 경우 Individual Queries 만 볼 수 있습니다. 액세스 권한에 대한 자세한 내용은 쿼리 기록으로 쿼리 활동 모니터링하기 섹션을 참조하십시오.

Snowflake Native App 에서 수정된 쿼리 프로필 데이터¶

Snowflake Native App Framework 는 다음과 같은 컨텍스트에서 쿼리 프로필 의 정보를 수정합니다.

• 앱이 설치되거나 업그레이드될 때 실행되는 쿼리입니다.

• 앱이 소유한 저장 프로시저에서 발생하는 쿼리입니다.

• 앱이 소유한 안전하지 않은 뷰 또는 함수가 포함된 쿼리입니다.

이러한 각 유형의 쿼리에 대해 Snowsight 는 전체 쿼리 프로필 트리를 표시하는 대신 쿼리 프로필 데이터를 비어 있는 단일 노드로 축소합니다.

쿼리 세부 정보 검토하기¶

특정 쿼리의 세부 정보를 검토하고 성공적인 쿼리 결과를 보려면 쿼리에 대한 Query Details 를 여십시오.

다음을 포함하여 쿼리 실행에 대한 정보를 보려면 Details 를 검토할 수 있습니다.

• 쿼리의 상태.

• 쿼리가 시작된 시간(사용자의 현지 타임존).

• 쿼리가 종료된 시간(사용자의 현지 타임존).

• 쿼리를 실행하는 데 사용된 웨어하우스의 크기.

• 쿼리 기간.

• 쿼리 ID.

• 쿼리의 쿼리 태그(존재하는 경우).

• 드라이버 상태. 자세한 내용은 Snowflake 플라이언트 버전 보기 섹션을 참조하십시오.

• 쿼리를 제출하는 데 사용된 클라이언트, 드라이버 또는 라이브러리의 이름과 버전. 예를 들어 Snowsight 를 사용하여 실행되는 쿼리의 경우 Go 1.1.5 입니다.

• 세션 ID.

Query Details 탭 위에 나열된 쿼리를 실행한 사용자와 쿼리를 실행하는 데 사용된 웨어하우스를 볼 수 있습니다.

SQL Text 섹션에서 쿼리의 실제 텍스트를 검토합니다. SQL 텍스트를 마우스로 가리켜 워크시트에서 문을 열거나 문을 복사할 수 있습니다. 쿼리가 실패한 경우 오류 세부 정보를 검토할 수 있습니다.

Results 섹션에는 쿼리의 결과가 표시됩니다. 결과의 처음 10,000행만 볼 수 있으며 쿼리를 실행한 사용자만 결과를 볼 수 있습니다. 전체 결과 세트를 CSV 형식의 파일로 내보내려면 Export Results 를 선택하십시오.

쿼리 세부 정보를 사용할 수 없는 문제 해결하기¶

쿼리에 쿼리 세부 정보가 없는 경우 가능한 원인은 다음과 같습니다.

• 쿼리를 아직 실행하는 중입니다. 쿼리 실행이 완료되면 쿼리 세부 정보와 프로필을 볼 수 있습니다.

• 자신의 역할에 쿼리 세부 정보를 볼 수 있는 권한이 없습니다.

• 쿼리가 14일 이상 전에 실행되었으며 쿼리 세부 정보와 프로필을 더 이상 사용할 수 없습니다.

• 쿼리를 실행하지 못했으므로 쿼리 프로필이 없습니다.

• Snowflake 플랫폼은 작업 세부 정보를 보존하도록 설계되었지만 작업 쿼리 세부 정보 및 쿼리 프로필 메트릭의 깊이는 최선의 노력을 기준으로 하며 모든 쿼리에 대해 보장되는 것은 아닙니다.

쿼리 프로필 검토하기¶

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

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

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

• 쿼리 실행 계획

• 연산자 노드

• 쿼리 프로필 탐색

• 정보 창

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

Snowflake Native App 에서 수정된 기록 데이터 쿼리¶

Snowflake Native App 과 관련된 쿼리의 경우 query_text 및 error_message 필드는 다음 컨텍스트의 쿼리 기록 에서 수정됩니다.

• 앱이 설치되거나 업그레이드될 때 실행되는 쿼리.

• 앱이 소유한 저장 프로시저의 하위 작업에서 발생하는 쿼리.

이러한 각 상황에서 Snowsight 의 쿼리 기록 셀은 공백으로 나타납니다.

프로필 개요¶

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

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

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

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

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

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

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

• Hybrid Table Requests Throttling — 하이브리드 테이블에 저장된 데이터 읽기 및 쓰기 요청을 스로틀링 하는 데 소요되는 시간입니다.

통계¶

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

• 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 테이블 구조 이해하기 을 참조하십시오.