스키마:

ACCOUNT_USAGE

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;
    
    Copy
  • 때때로 데이터 압축 및 유지 관리 프로세스에서 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';
Copy

이 쿼리는 특정 날짜부터 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';
Copy