카테고리:

Information Schema , 테이블 함수

DATABASE_STORAGE_USAGE_HISTORY

이 테이블 함수는 지정된 날짜 범위 내에서 단일 데이터베이스(또는 계정의 모든 데이터베이스)에 대한 평균 일일 저장소 사용량(바이트 단위)을 쿼리하는 데 사용할 수 있습니다. 결과는 다음을 포함합니다.

  • 데이터베이스의 테이블 및 구체화된 뷰에 저장된 모든 데이터.

  • 데이터베이스에 대해 Fail-safe에서 유지 관리되는 모든 과거 데이터.

참고

이 함수는 지난 6개월 이내의 저장소 사용량을 반환합니다.

참고 항목:

STAGE_STORAGE_USAGE_HISTORY , WAREHOUSE_METERING_HISTORY

구문

DATABASE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, DATABASE_NAME => '<string>' ] )
Copy

인자

모든 인자는 선택 사항입니다.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

데이터베이스 저장소 사용량을 검색할 지난 6개월 이내의 날짜 범위:

  • 종료 날짜가 지정되지 않은 경우, CURRENT_DATE 가 범위의 끝으로 사용됩니다.

  • 시작 날짜가 지정되지 않은 경우, DATE_RANGE_END 가 범위의 시작으로 사용됩니다(즉, 기본값은 저장소 사용량의 1일).

범위가 지난 6개월을 벗어나면 오류가 반환됩니다.

DATABASE_NAME => 'string'

저장소 사용량 기록을 검색할 데이터베이스의 이름입니다. 데이터베이스 이름은 작은따옴표로 묶어야 합니다. 또한, 데이터베이스 이름에 공백, 대/소문자 혼합 문자 또는 특수 문자가 포함된 경우, 이름을 작은따옴표 안에 큰따옴표로 묶어야 합니다(예: '"My DB"' vs 'mydb').

데이터베이스를 지정하지 않으면 계정의 모든 데이터베이스에 대한 데이터가 반환됩니다.

사용법 노트

  • ACCOUNTADMIN 역할에 대한 결과 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대한 결과만 반환합니다.

  • Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

출력

이 함수는 다음 열을 반환합니다.

열 이름

데이터 타입

설명

USAGE_DATE

DATE

이 저장소 사용량 레코드의 날짜

DATABASE_NAME

TEXT

데이터베이스의 이름

AVERAGE_DATABASE_BYTES

NUMBER

사용된 데이터베이스 저장소의 바이트 수

AVERAGE_FAILSAFE_BYTES

NUMBER

사용된 Fail-safe 저장소의 바이트 수

데이터베이스가 삭제되고 해당 데이터 보존 기간이 경과한 경우(즉, Time Travel을 사용하여 데이터베이스를 복구할 수 없음), 데이터베이스 이름은 DROPPED_id 로 보고되며, 여기서 id 는 내부 생성 식별자입니다. 이 ID는 테이블 함수에서 반환된 행의 항목을 일치시키는 데 사용할 수 있습니다.

예

계정의 모든 데이터베이스에 대해 데이터베이스당 지난 10일 동안의 평균 일일 저장소 사용량을 검색합니다.

select *
from table(information_schema.database_storage_usage_history(dateadd('days',-10,current_date()),current_date()));
Copy
언어: 한국어