- 스키마:
PIPE_USAGE_HISTORY 뷰¶
이 Account Usage 뷰는 지난 365일(1년) 동안 Snowpipe 를 사용하여 테이블에 로딩된 데이터의 기록 또는 Iceberg 자동 새로 고침 에 사용된 크레딧의 기록을 쿼리하는 데 사용할 수 있습니다.
이 뷰는 전체 Snowflake 계정에 대해 로딩된 데이터 기록 및 청구된 크레딧을 표시합니다. pipe_name
열을 사용하여 자동 새로 고침을 통해 특정 파이프 또는 Iceberg 테이블에 대한 뷰를 필터링할 수 있습니다.
열¶
열 이름 |
데이터 타입 |
설명 |
---|---|---|
PIPE_ID |
NUMBER |
데이터 로딩에 사용되는 파이프의 내부/시스템 생성 식별자입니다. 쿼리에 파이프 이름이 지정되지 않은 경우 NULL을 표시합니다. 각 행에는 시간 범위 내에서 사용 중인 모든 파이프의 합계가 포함됩니다. |
PIPE_NAME |
TEXT |
자동 새로 고침 기능이 있는 파이프 또는 Iceberg 테이블의 이름입니다. 외부 테이블 또는 델타 기반 Iceberg 테이블의 메타데이터를 새로 고치는 데 사용되는 내부(숨겨진) 파이프 오브젝트에 대해 NULL 을 표시합니다. |
USAGE_DATE |
DATE |
데이터 수집이 발생한 날짜입니다. |
CREDITS_USED |
NUMBER |
START_TIME 및 END_TIME 기간 동안 Snowpipe 데이터 로딩에 대해 청구된 크레딧 수입니다. |
BYTES_INSERTED |
FLOAT |
START_TIME 및 END_TIME 기간 동안 로딩된 바이트 수입니다. |
FILES_INSERTED |
VARIANT |
START_TIME 및 END_TIME 기간 동안 로딩된 파일 수입니다. |
사용법 노트¶
뷰의 지연 시간은 최대 180분(3시간)입니다.
이 뷰의 데이터를 ORGANIZATION USAGE 스키마 의 해당 뷰와 조정하려는 경우, 먼저 세션의 시간대를 UTC로 설정해야 합니다. Account Usage 뷰를 쿼리하기 전에 다음을 실행하십시오.
ALTER SESSION SET TIMEZONE = UTC;
때때로 데이터 압축 및 유지 관리 프로세스에서 Snowflake 크레딧이 소모될 수 있습니다. 예를 들어, 반환된 결과에는 0 BYTES_INSERTED 및 0 FILES_INSERTED 로 크레딧을 소비한 것으로 표시될 수 있습니다. 이는 데이터가 로딩되지 않고 있지만, 데이터 압축 및 유지 관리 프로세스에서 일부 크레딧을 사용했다는 의미입니다.
Snowflake는 Snowpipe 파일 요금과 동일한 요금으로 외부 테이블과 내부의 명명된 스테이지 및 외부 스테이지의 디렉터리 테이블에서 자동 새로 고침 알림을 위한 요금을 청구합니다. 이 PIPE_USAGE_HISTORY 뷰를 검사하거나 PIPE_USAGE_HISTORY 함수를 쿼리하여 외부 테이블 및 디렉터리 테이블 자동 새로 고침 알림으로 인해 발생하는 요금을 추정할 수 있습니다. 자동 새로 고침 파이프는 NULL 파이프 이름 아래에 나열됩니다. Information Schema 테이블 함수 AUTO_REFRESH_REGISTRATION_HISTORY 를 사용하여 테이블 수준/스테이지 수준 세분성에서 외부 테이블 자동 새로 고침 알림 기록을 볼 수도 있습니다.
자동 새로 고침 알림의 요금이 부과되지 않도록 하려면 외부 테이블과 디렉터리 테이블에 대해 수동 새로 고침을 수행하십시오. 외부 테이블의 경우 ALTER EXTERNAL TABLE <이름> REFRESH … 문을 사용하여 외부 테이블을 외부 저장소에 수동으로 동기화할 수 있습니다. 디렉터리 테이블의 경우 ALTER STAGE <이름> REFRESH … 문을 사용하여 디렉터리를 외부 저장소에 수동으로 동기화할 수 있습니다.
Snowflake는 Iceberg 자동 새로 고침 에 대해 Snowpipe 파일 요금을 청구하지 않습니다.
예¶
이 쿼리는 특정 날짜부터 my_auto_refresh_pipe
라는 파이프에 대한 파이프 사용 기록을 제공합니다.
SELECT
pipe_id,
start_time,
end_time,
credits_used,
bytes_inserted,
files_inserted
FROM SNOWFLAKE.ACCOUNT_USAGE.PIPE_USAGE_HISTORY
WHERE pipe_name = 'my_auto_refresh_pipe'
AND START_TIME >= '2025-04-01';
이 쿼리는 특정 날짜부터 iceberg_glue_table
이라는 Iceberg 테이블에 대한 자동 새로 고침 청구에 사용된 크레딧을 표시합니다.
SELECT
pipe_id,
start_time,
end_time,
credits_used,
FROM SNOWFLAKE.ACCOUNT_USAGE.PIPE_USAGE_HISTORY
WHERE pipe_name = 'iceberg_glue_table'
AND START_TIME >= '2025-04-01';