SCHEMATA 뷰

INFORMATION_SCHEMA.SCHEMATA 뷰는 프로젝트나 리전의 데이터 세트에 대한 정보를 제공합니다. 뷰는 데이터 세트마다 행 하나를 반환합니다.

시작하기 전에

데이터 세트 메타데이터에 대해 SCHEMATA 뷰를 쿼리하려면 프로젝트 수준에서 bigquery.datasets.get Identity and Access Management(IAM) 권한이 필요합니다.

다음과 같은 각 사전 정의된 IAM 역할에는 SCHEMATA 뷰를 가져오기 위해 필요한 권한이 포함되어 있습니다.

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

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

스키마

INFORMATION_SCHEMA.SCHEMATA 뷰를 쿼리할 때 쿼리 결과에는 지정된 프로젝트에 있는 각 데이터 세트에 대한 하나의 행이 포함됩니다.

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

열 이름 데이터 유형 값
catalog_name STRING 데이터 세트가 포함된 프로젝트 이름
schema_name STRING 데이터 세트 이름(또는 datasetId라고 함)
schema_owner STRING 값이 항상 NULL임
creation_time TIMESTAMP 데이터 세트의 생성 시간
last_modified_time TIMESTAMP 데이터 세트의 마지막 수정 시간
location STRING 데이터 세트의 지리적 위치
ddl STRING 데이터 세트를 만드는 데 사용할 수 있는 CREATE SCHEMA DDL 문
default_collation_name STRING 기본 대조 사양 이름(있는 경우)입니다. 그 외의 경우는 NULL입니다.
sync_status JSON 리전 간 복제 및 재해 복구 데이터 세트의 기본 복제본과 보조 복제본 간 동기화 상태입니다. 복제본이 기본 복제본이거나 데이터 세트에서 복제를 사용하지 않는 경우 NULL을 반환합니다.

범위 및 구문

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

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

예시

-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

예

기본 프로젝트가 아닌 프로젝트에 쿼리를 실행하려면 프로젝트 ID를 다음 형식으로 데이터 세트에 추가합니다.

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA
 예를 들면 `myproject`.INFORMATION_SCHEMA.SCHEMATA입니다.

SELECT
  * EXCEPT (schema_owner)
FROM
  INFORMATION_SCHEMA.SCHEMATA;

결과는 다음과 비슷합니다. 가독성을 위해 일부 열은 결과에서 제외됩니다.

+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
|  catalog_name  |  schema_name  |    creation_time    | last_modified_time  |  location  |                   ddl                    |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset1    | 2018-11-07 19:50:24 | 2018-11-07 19:50:24 | US         | CREATE SCHEMA `myproject.mydataset1`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset2    | 2018-07-16 04:24:22 | 2018-07-16 04:24:22 | US         | CREATE SCHEMA `myproject.mydataset2`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   default_partition_expiration_days=3.0, |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset3    | 2018-02-07 21:08:45 | 2018-05-01 23:32:53 | US         | CREATE SCHEMA `myproject.mydataset3`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   description="My dataset",              |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+