- 스키마:
QUERY_ATTRIBUTION_HISTORY 뷰¶
이 Account Usage 뷰를 사용하면 지난 365일(1년) 동안 계정의 웨어하우스에서 실행된 특정 쿼리의 컴퓨팅 비용을 확인할 수 있습니다.
자세한 내용은 쿼리 비용 특성 섹션을 참조하십시오.
열¶
열 이름 |
데이터 타입 |
설명 |
---|---|---|
|
VARCHAR |
SQL 문의 내부/시스템 생성 식별자입니다. |
|
VARCHAR |
상위 쿼리의 쿼리 ID이거나, 쿼리에 상위 쿼리가 없는 경우에는 NULL입니다. |
|
VARCHAR |
체인에서 최상위 쿼리의 쿼리 ID이거나, 쿼리에 상위 쿼리가 없는 경우에는 NULL입니다. |
|
NUMBER |
쿼리가 실행된 웨어하우스의 내부/시스템 생성 식별자입니다. |
|
VARCHAR |
쿼리가 실행된 웨어하우스의 이름입니다. |
|
VARCHAR |
표준화된 SQL 텍스트를 기반으로 계산된 해시 값 입니다. |
|
VARCHAR |
매개 변수가 있는 쿼리를 기반으로 계산된 해시 값 입니다. |
|
VARCHAR |
QUERY_TAG 세션 매개 변수를 통해 이 문에 대해 설정된 쿼리 태그입니다. |
|
VARCHAR |
쿼리를 실행한 사용자입니다. |
|
TIMESTAMP_LTZ |
쿼리 실행이 시작된 시간(현지 타임존)입니다. |
|
TIMESTAMP_LTZ |
쿼리 실행이 종료된 시간(현지 타임존)입니다. |
|
NUMBER |
이 쿼리에 귀속된 크레딧 수입니다. 쿼리 실행을 위한 크레딧 사용량만 포함하며 웨어하우스 유휴 시간은 포함하지 않습니다. |
|
NUMBER |
Query Acceleration Service 에서 쿼리 가속화에 사용한 크레딧 수입니다. 쿼리가 가속화되지 않은 경우 NULL입니다. . . 가속화된 쿼리의 총비용은 이 열과 |
사용법 노트¶
이 뷰의 지연 시간은 최대 6시간일 수 있습니다.
이 뷰에는 USAGE_VIEWER 또는 GOVERNANCE_VIEWER 데이터베이스 역할 이 부여된 모든 역할에 대한 결과가 표시됩니다.
credits_attributed_compute
열의 값에는 쿼리를 실행하기 위한 웨어하우스 크레딧 사용량이 포함되며, 여기에는 다중 클러스터 웨어하우스의 크기 조정 및/또는 자동 크기 조정이 포함됩니다. 이 비용은 리소스 소비량의 가중 평균을 기준으로 부과됩니다.이 값에는 웨어하우스 유휴 시간의 크레딧 사용량이 포함되지 않습니다. 유휴 시간이란 웨어하우스에서 쿼리가 실행되지 않는 기간으로, 웨어하우스 수준에서 측정할 수 있습니다.
이 값에는 쿼리 실행의 결과로서 발생하는 다른 크레딧 사용량은 포함되지 않습니다. 예를 들어, 다음은 쿼리 비용에 포함되지 않습니다.
데이터 전송 비용
저장소 비용
클라우드 서비스 비용
서버리스 기능 비용
AI 서비스에서 처리하는 토큰에 대한 비용
동시 실행 쿼리의 경우, 웨어하우스의 비용은 주어진 시간 간격 동안 리소스 소비량의 가중 평균을 기준으로 개별 쿼리의 특성에 따라 결정됩니다.
단기 실행 쿼리(<= ~100ms)는 현재 쿼리당 비용 귀속에는 너무 짧아서 뷰에 포함되지 않습니다.
모든 열의 데이터는 2024년 8월 중순부터 제공되고 있습니다. 이 날짜 이전의 데이터 일부는 뷰에서 제공되지만 불완전할 수 있습니다.
예¶
현재 사용자에 대한 쿼리 비용¶
현재 사용자가 현재 월에 실행한 쿼리의 비용을 확인하려면 다음 문을 실행합니다.
SELECT user_name, SUM(credits_attributed_compute) AS credits
FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_ATTRIBUTION_HISTORY
WHERE user_name = CURRENT_USER()
AND start_time >= DATE_TRUNC('MONTH', CURRENT_DATE)
AND start_time < CURRENT_DATE
GROUP BY user_name;
현재 사용자에게 웨어하우스 비용을 귀속시키려면 웨어하우스 비용의 사용자 기반 특성 섹션을 참조하십시오.
저장 프로시저에 대한 쿼리 비용¶
여러 계층 쿼리를 실행하는 저장 프로시저의 경우 프로시저에 대한 루트 쿼리 ID를 사용하여 프로시저의 각 쿼리 비용을 계산할 수 있습니다.
저장 프로시저에 대한 루트 쿼리 ID를 찾으려면 ACCESS_HISTORY 뷰 을 사용합니다. 예를 들어, 저장 프로시저에 대한 루트 쿼리 ID를 찾으려면
query_id
를 설정하고 다음 문을 실행합니다.SET query_id = '<query_id>'; SELECT query_id, parent_query_id, root_query_id, direct_objects_accessed FROM SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY WHERE query_id = $query_id;
자세한 내용은 예: 저장 프로시저를 사용한 상위 쿼리 섹션을 참조하십시오.
전체 프로시저의 쿼리 비용을 합산하려면
<root_query_id>
를 바꾸고 다음 문을 실행합니다.SET query_id = '<root_query_id>'; SELECT SUM(credits_attributed_compute) AS total_attributed_credits FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_ATTRIBUTION_HISTORY WHERE (root_query_id = $query_id OR query_id = $query_id);
추가 예제¶
더 많은 예는 태그, 사용자 및 쿼리별 비용 특성 섹션을 참조하십시오.