STAGE_STORAGE_USAGE_HISTORY
STAGE_STORAGE_USAGE_HISTORY
이 테이블 함수를 사용하면 지정된 날짜 범위 내에서 계정의 모든 Snowflake 스테이지에 대한 일별 평균 데이터 스토리지 사용량(바이트)을 조회할 수 있어요. 출력에는 다음의 스토리지가 포함돼요.
- 명명된 내부 스테이지.
- 기본 준비 영역(테이블 및 사용자용).
참고: 이 함수는 지난 6개월 이내의 스테이지 스토리지 사용량을 반환해요. 참고: 이 함수는 더 완전한 데이터 집합을 제공하고 더 긴 날짜 범위를 지원하는 ACCOUNT_USAGE.STAGE_STORAGE_USAGE_HISTORY 뷰를 위해 일반적으로 더 이상 사용되지 않아요(deprecated).
본문
구문
STAGE_STORAGE_USAGE_HISTORY(
[ DATE_RANGE_START => <constant_expr> ]
[, DATE_RANGE_END => <constant_expr> ] )
인자
모든 인자는 선택적이에요.
지난 6개월 이내의, 스테이지 스토리지 사용량을 검색할 날짜 범위예요.
- 종료 날짜를 지정하지 않으면 CURRENT_DATE가 범위의 끝으로 사용돼요.
- 시작 날짜를 지정하지 않으면 DATE_RANGE_END가 범위의 시작으로 사용돼요(즉 기본값은 하루의 스토리지 사용량).
범위가 지난 6개월 밖에 있으면 오류가 반환돼요.
사용상 주의사항
- ACCOUNTADMIN 역할 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대해서만 결과를 반환해요.
- Information Schema 테이블 함수를 호출할 때는 세션에 INFORMATION_SCHEMA 스키마가 사용 중이어야 하거나 함수 이름이 완전히 정규화되어야 해요. 자세한 내용은 Snowflake Information Schema를 참고해요.
출력
함수는 다음 컬럼을 반환해요.
| Column Name | Data Type | Description |
|---|---|---|
| USAGE_DATE | DATE | 이 스토리지 사용량 레코드의 날짜(UTC 시간대)예요. |
| AVERAGE_STAGE_BYTES | NUMBER | 사용된 스테이지 스토리지의 바이트 수예요. |
예시
계정의 모든 내부 스테이지에 대해 지난 10일 동안의 일별 평균 스토리지 사용량을 검색해요.
select *
from table(information_schema.stage_storage_usage_history(dateadd('days',-10,current_date()),current_date()));