TABLE_SNAPSHOTS 뷰

INFORMATION_SCHEMA.TABLE_SNAPSHOTS 뷰는 테이블 스냅샷에 대한 메타데이터를 포함합니다. 자세한 내용은 테이블 스냅샷 소개를 참조하세요.

필수 권한

INFORMATION_SCHEMA.TABLE_SNAPSHOTS 뷰를 쿼리하려면 데이터 세트에 대한 bigquery.tables.list Identity and Access Management(IAM) 권한이 필요합니다. 사전 정의된 roles/bigquery.metadataViewer 역할에 필수 권한이 포함되어 있습니다.

BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

스키마

INFORMATION_SCHEMA.TABLE_SNAPSHOTS 테이블을 쿼리하면 지정된 데이터 세트 또는 리전의 각 테이블 스냅샷에 대한 하나의 행이 결과에 포함됩니다.

INFORMATION_SCHEMA.TABLE_SNAPSHOTS 테이블에는 다음과 같은 스키마가 있습니다. 테이블 스냅샷을 가져온 표준 테이블을 기본 테이블이라고 부릅니다.

열 이름 데이터 유형
table_catalog STRING 테이블 스냅샷이 포함된 프로젝트의 이름
table_schema STRING 테이블 스냅샷이 포함된 데이터 세트의 이름
table_name STRING 테이블 스냅샷의 이름
base_table_catalog STRING 기본 테이블이 포함된 프로젝트의 이름
base_table_schema STRING 기본 테이블이 포함된 데이터 세트의 이름
base_table_name STRING 기본 테이블의 이름
snapshot_time TIMESTAMP 테이블 스냅샷이 생성된 시간

범위 및 구문

이 뷰에 대한 쿼리에는 데이터 세트나 리전 한정자가 포함되어야 합니다. 데이터 세트 한정자가 있는 쿼리에는 데이터 세트에 대한 권한이 있어야 합니다. 리전 한정자가 있는 쿼리에는 프로젝트에 대한 권한이 있어야 합니다. 자세한 내용은 구문을 참조하세요. 다음 표에서는 이 뷰의 리전 범위와 리소스 범위를 설명합니다.

뷰 이름 리소스 범위 리전 범위
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS 프로젝트 수준 REGION
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS 데이터 세트 수준 데이터 세트 위치
다음을 바꿉니다.

  • (선택사항) PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
  • REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 region-us입니다.
  • DATASET_ID: 데이터 세트의 ID입니다. 자세한 내용은 데이터 세트 한정자를 참조하세요.

예시

-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

다음 쿼리는 mydataset 데이터 세트에서 테이블 스냅샷에 대한 메타데이터를 검색합니다. 이 예시에서는 UTC 기준 2021년 5월 14일 오후 12시에 기본 테이블 myproject.mydataset.mytable에서 가져온 myproject.mydataset.mytablesnapshot 테이블 스냅샷을 보여줍니다.

SELECT *
FROM
  `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

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

+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog  | table_schema  | table_name      | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+----------------+---------------+-----------------+----------------------------------------------------------------------------------------+
| myproject      | mydataset     | mytablesnapshot | myProject          | mydataset         | mytable         | 2021-05-14 12:00:00.000 UTC |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+