ESTIMATE_HYBRID_TABLE_STORAGE_USAGE
ESTIMATE_HYBRID_TABLE_STORAGE_USAGE
ESTIMATE_HYBRID_TABLE_STORAGE_USAGE() 함수는 하이브리드 테이블(hybrid table)의 총 스토리지 사용량을 바이트 단위로 거의 실시간에 가깝게 추정해 반환해요.
본문
문법
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'));