TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 뷰

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 뷰는 다음 유형의 테이블에 대해 이전 90일 동안의 일일 총 스토리지 사용량을 제공합니다.

  • 표준 테이블
  • 구체화된 뷰
  • 기본 테이블의 델타 값(바이트)이 포함된 테이블 클론
  • 기본 테이블의 델타 값(바이트)이 포함된 테이블 스냅샷

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 뷰에는 청구 가능한 바이트가 없는 테이블이 제외됩니다. 다음 표 유형은 제외됩니다.

  • 외부 테이블
  • 익명 테이블
  • 빈 테이블
  • 기본 테이블의 델타 값(바이트)이 없는 테이블 클론
  • 기본 테이블의 델타 값(바이트)이 없는 테이블 스냅샷

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 뷰를 쿼리하면 쿼리 결과에 현재 프로젝트의 상위 폴더(하위 폴더 포함)에 있는 각 테이블 또는 구체화된 뷰에 대해 하루에 하나의 행이 포함됩니다.

이 표의 데이터는 실시간으로 제공되지 않습니다. 테이블 데이터가 이 뷰에 표시되려면 약 72시간이 걸립니다.

이 뷰는 스토리지 사용량을 MiB 초 단위로 반환합니다. 예를 들어 프로젝트에 86,400초 (24시간) 동안 물리적으로 1,000,000바이트가 사용된 경우 총 물리적 사용량은 86,400,000,000바이트 초이며, 이는 다음 예시에 표시된 것처럼 82,397MiB 초로 변환됩니다.

86,400,000,000 / 1,024 / 1,024 = 82,397

저장용량 사용량 값은 BILLABLE_TOTAL_PHYSICAL_USAGE 열에서 확인할 수 있습니다. 자세한 내용은 스토리지 가격 책정 세부정보를 참고하세요.

필수 권한

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 뷰를 쿼리하려면 프로젝트의 상위 폴더에 대한 다음 Identity and Access Management (IAM) 권한이 필요합니다.

  • bigquery.tables.get
  • bigquery.tables.list

다음과 같이 사전 정의된 각 IAM 역할에는 위의 권한이 포함되어 있습니다.

  • roles/bigquery.dataViewer
  • roles/bigquery.dataEditor
  • roles/bigquery.metadataViewer
  • roles/bigquery.admin

BigQuery 권한에 대한 자세한 내용은 BigQuery IAM 역할 및 권한을 참고하세요.

스키마

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 뷰에는 다음과 같은 스키마가 있습니다.

USAGE_DATE DATE 표시된 바이트의 결제일(America/Los_Angeles 시간대 사용)
FOLDER_NUMBERS REPEATED INTEGER 프로젝트가 포함된 폴더의 번호 ID는 프로젝트가 포함된 폴더부터 시작하여 하위 폴더가 포함된 폴더 등의 순서로 표시됩니다. 예를 들어 FOLDER_NUMBERS가 [1, 2, 3]인 경우, 그런 다음 폴더 1에는 프로젝트가 즉시 포함되고, 폴더 2에는 1이 포함되며, 폴더 3에는 2가 포함됩니다. 이 열은 TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER에만 채워집니다.
PROJECT_ID STRING 데이터 세트가 포함된 프로젝트의 프로젝트 ID
TABLE_CATALOG STRING 데이터 세트가 포함된 프로젝트의 프로젝트 ID
PROJECT_NUMBER INT64 데이터 세트가 포함된 프로젝트의 프로젝트 번호
TABLE_SCHEMA STRING 테이블이나 구체화된 뷰가 포함된 데이터 세트 이름(또는 datasetId라고 함)
TABLE_NAME STRING 테이블 또는 구체화된 뷰의 이름(또는 tableId라고 함)
BILLABLE_TOTAL_LOGICAL_USAGE INT64

총 논리적 사용량(MiB 초)입니다.

데이터 세트에 물리적 스토리지 청구 모델이 사용되는 경우 0을 반환합니다.
BILLABLE_ACTIVE_LOGICAL_USAGE INT64

90일 미만의 논리적 사용량(MiB 초)입니다.

데이터 세트에 물리적 스토리지 청구 모델이 사용되는 경우 0을 반환합니다.
BILLABLE_LONG_TERM_LOGICAL_USAGE INT64

90일 초과의 논리적 사용량(MiB 초)입니다.

데이터 세트에 물리적 스토리지 청구 모델이 사용되는 경우 0을 반환합니다.
BILLABLE_TOTAL_PHYSICAL_USAGE INT64

총 사용량(MiB 초)입니다. 여기에는 장애 안전 및 시간 이동 스토리지에 사용되는 물리적 바이트가 포함됩니다.

데이터 세트에 논리적 스토리지 청구 모델이 사용되는 경우 0을 반환합니다.
BILLABLE_ACTIVE_PHYSICAL_USAGE INT64

90일 미만의 물리적 사용량(MiB 초)입니다. 여기에는 장애 안전 및 시간 이동 스토리지에 사용되는 물리적 바이트가 포함됩니다.

데이터 세트에 논리적 스토리지 청구 모델이 사용되는 경우 0을 반환합니다.
BILLABLE_LONG_TERM_PHYSICAL_USAGE INT64

90일 초과의 물리적 사용량(MiB 초)입니다.

데이터 세트에 논리적 스토리지 청구 모델이 사용되는 경우 0을 반환합니다.

범위 및 구문

이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 리전 한정자를 지정하지 않으면 메타데이터가 모든 리전에서 검색됩니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.

뷰 이름 리소스 범위 리전 범위
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 지정된 프로젝트가 포함된 폴더 REGION
다음을 바꿉니다.
  • 선택사항: PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
  • REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 `region-us`입니다.

지정된 프로젝트의 상위 폴더에 있는 테이블의 스토리지 정보를 검색하려면 다음 쿼리를 실행합니다.

SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER;

예

다음 쿼리는 폴더의 모든 테이블에 대한 최신 날짜의 사용량을 보여줍니다.

SELECT
  usage_date,
  project_id,
  table_schema,
  table_name,
  billable_total_logical_usage,
  billable_total_physical_usage
FROM
  (
    SELECT
      *,
      ROW_NUMBER()
        OVER (PARTITION BY project_id, table_schema, table_name ORDER BY usage_date DESC) AS rank
    FROM
      `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER
  )
WHERE rank = 1;

결과는 다음과 비슷합니다.

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| usage_date   | project_id | table_schema | table_name | billable_total_logical_usage | billable_total_physical_usage |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_x    |     734893409201             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_z    |     110070445455             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_y    |            0                 |         52500873256           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_t    |            0                 |         32513713981           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_m    |      8894535352              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_n    |      4183337201              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+