ESTIMATE_HYBRID_TABLE_STORAGE_USAGE

ESTIMATE_HYBRID_TABLE_STORAGE_USAGE

ESTIMATE_HYBRID_TABLE_STORAGE_USAGE() 함수는 하이브리드 테이블(hybrid table)의 총 스토리지 사용량을 바이트 단위로 거의 실시간에 가깝게 추정해 반환해요.

출처: Snowflake SQL Reference

본문

문법

ESTIMATE_HYBRID_TABLE_STORAGE_USAGE( '<table_name>' )

사용 메모

  • 이 함수는 하이브리드 테이블에만 작동해요. 일반 테이블, 뷰 또는 다른 객체에 호출하면 오류를 반환해요.
  • 함수를 호출하려면 사용 중인 역할이 대상 테이블에 SELECT 권한이 있어야 해요. 그렇지 않으면 함수가 테이블이 존재하지 않거나 권한이 없다는 오류를 반환해요.
  • 보고되는 값은 추정치예요. 샘플링된 스토리지 메타데이터에서 도출되므로 정확한 바이트 수와 다를 수 있고 최근 쓰기를 반영하지 못할 수 있어요. 방금 생성되었거나 데이터가 아주 적은 테이블은, 추정치가 등록될 만큼 충분한 데이터가 누적될 때까지 0 바이트를 보고할 수 있어요.
  • TOTAL_ESTIMATED_BYTES는 기본(기본 키) 데이터, 보조 인덱스, 기반 스토어에 여전히 보관 중인 테이블 데이터의 이전 버전을 포함한 테이블 총 스토리지 사용량을 반영해요. 클라우드 객체 스토리지에 저장된 데이터는 포함하지 않아요.
  • 이 함수는 쿼리의 FROM 절에서 호출하고 TABLE(...)로 감싸야 해요. 자세한 내용은 테이블 함수를 참고하세요.

출력

이 함수는 다음 컬럼을 가진 단일 행을 반환해요.

Column Name Data Type Description
TABLE_NAME VARCHAR 하이브리드 테이블의 정규화된 이름이에요.
TOTAL_ESTIMATED_BYTES NUMBER 테이블의 추정 총 스토리지 사용량(바이트)이에요.

예제

하이브리드 테이블의 스토리지 사용량을 추정해요.

SELECT * FROM TABLE(ESTIMATE_HYBRID_TABLE_STORAGE_USAGE('my_db.my_schema.my_hybrid_table'));
+---------------------------------+-----------------------+
| TABLE_NAME                      | TOTAL_ESTIMATED_BYTES |
|---------------------------------+-----------------------|
| MY_DB.MY_SCHEMA.MY_HYBRID_TABLE |              11475750 |
+---------------------------------+-----------------------+

추정 바이트 수만 반환해요.

SELECT TOTAL_ESTIMATED_BYTES
  FROM TABLE(ESTIMATE_HYBRID_TABLE_STORAGE_USAGE('my_db.my_schema.my_hybrid_table'));

더 알아보기