카테고리:

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개월 이내의 날짜 범위:

  • 종료 날짜가 지정되지 않은 경우, :doc:`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

Time Trave의 현재 바이트를 포함하여 사용된 데이터베이스 저장소의 바이트 수입니다.

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