스키마:

ACCOUNT_USAGE

ICEBERG_STORAGE_OPTIMIZATION_HISTORY 뷰

이 Account Usage 뷰를 사용하여 계정의 Apache Iceberg™ 테이블에 대해 지난 365일(1년) 이내에 수행된 *데이터 압축*을 포함한 Iceberg 저장소 최적화 작업을 쿼리합니다. 다음 Iceberg 테이블에 대한 작업을 쿼리할 수 있습니다.

  • Snowflake 관리 테이블

  • 카탈로그 관리 테이블 열기

참고

  • Snowflake는 2025년 10월 20일부터 Snowflake 관리형 Iceberg 테이블에 대한 데이터 파일의 데이터 압축 요금을 청구하고 있습니다.

  • Snowflake 관리형 Iceberg 테이블에서 데이터 압축을 활성화하거나 비활성화하려면 데이터 압축 설정 섹션을 참조하세요.

열 이름

데이터 타입

설명

START_TIME

TIMESTAMP_LTZ

작업이 수행된 시간 범위의 시작(시간 기준)입니다.

END_TIME

TIMESTAMP_LTZ

작업이 수행된 시간 범위의 끝(시간 기준)입니다.

CREDITS_USED

NUMBER

START_TIME 및 END_TIME 기간 동안 데이터 압축에 대해 청구된 크레딧 수입니다.

NUM_BYTES_SCANNED

NUMBER

START_TIME 및 END_TIME 기간 동안 스캔된 바이트 수입니다.

NUM_ROWS_WRITTEN

NUMBER

START_TIME 및 END_TIME 기간 동안 압축된 행 수입니다.

TABLE_ID

NUMBER

Snowflake의 Iceberg 테이블에 대한 내부 시스템 생성 식별자입니다.

TABLE_NAME

VARCHAR

Snowflake에 정의된 Iceberg 테이블의 이름입니다.

ICEBERG_TABLE_UUID

VARCHAR

외부 Iceberg 엔진 또는 카탈로그에서 생성된 Apache Iceberg™ 테이블 식별자입니다.

SCHEMA_ID

VARCHAR

테이블이 있는 Snowflake 스키마에 대한 시스템 생성 식별자입니다.

SCHEMA_NAME

VARCHAR

테이블이 있는 스키마의 이름입니다.

DATABASE_ID

NUMBER

스키마와 테이블이 속한 Snowflake 데이터베이스의 시스템 생성 식별자입니다.

DATABASE_NAME

VARCHAR

스키마와 테이블이 속한 데이터베이스의 이름입니다.

INSTANCE_ID

NUMBER

오브젝트가 속한 인스턴스의 내부 시스템 생성 식별자입니다.

사용법 노트

  • 뷰의 지연 시간은 최대 2시간입니다.

  • 뷰에는 지난 365일 동안의 과거 사용량 데이터가 포함됩니다.

  • USAGE_VIEWER 역할에 이 뷰에 대한 SELECT 권한이 부여됩니다. 자세한 내용은 SNOWFLAKE 데이터베이스 역할 섹션을 참조하십시오.

  • 이 뷰에는 Open Catalog에서 관리하지 않는 외부 관리형 Iceberg 테이블에 대한 데이터 압축 정보가 포함되지 않습니다.

다음 예에서는 청구된 크레딧 수가 지정된 금액을 초과하는 테이블을 필터링하는 방법을 보여줍니다.

  SELECT
      table_name,
      start_time,
      credits_used
    FROM SNOWFLAKE.ACCOUNT_USAGE.ICEBERG_STORAGE_OPTIMIZATION_HISTORY
    WHERE credits_used > 0.0005
    ORDER BY
      credits_used DESC;

The query returns the following results:
Copy
+------------------+-------------------------------+--------------+
| TABLE_NAME       | START_TIME                    | CREDITS_USED |
+------------------+-------------------------------+--------------+
| my_iceberg_table | 2025-09-15 09:00:00.000 -0700 | 0.000529445  |
| my_iceberg_table | 2025-09-15 08:00:00.000 -0700 | 0.000516791  |
+------------------+-------------------------------+--------------+