COLUMNS 뷰

INFORMATION_SCHEMA.COLUMNS 뷰에는 테이블의 각 열(필드)에 대해 하나의 행이 포함됩니다.

필수 권한

INFORMATION_SCHEMA.COLUMNS 뷰를 쿼리하려면 다음 Identity and Access Management(IAM) 권한이 필요합니다.

bigquery.tables.get
bigquery.tables.list

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

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

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

스키마

INFORMATION_SCHEMA.COLUMNS 뷰를 쿼리하면 테이블의 각 열(필드)당 하나의 행이 쿼리 결과에 포함됩니다.

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

열 이름	데이터 유형	값
`TABLE_CATALOG`	`STRING`	데이터 세트가 포함된 프로젝트의 프로젝트 ID
`TABLE_SCHEMA`	`STRING`	테이블이 포함된 데이터 세트 이름(또는 `datasetId`라고 함)
`TABLE_NAME`	`STRING`	테이블 또는 뷰의 이름(또는 `tableId`라고 함)
`COLUMN_NAME`	`STRING`	열 이름
`ORDINAL_POSITION`	`INT64`	테이블에 있는 열의 1부터 시작하는 오프셋. _PARTITIONTIME 또는 _PARTITIONDATE와 같은 의사 열이면 값은 `NULL`입니다.
`IS_NULLABLE`	`STRING`	열의 모드가 `NULL` 값을 허용하는지 여부에 따라 `YES` 또는 `NO`
`DATA_TYPE`	`STRING`	열의 GoogleSQL 데이터 유형
`IS_GENERATED`	`STRING`	값이 항상 `NEVER`임
`GENERATION_EXPRESSION`	`STRING`	값이 항상 `NULL`임
`IS_STORED`	`STRING`	값이 항상 `NULL`임
`IS_HIDDEN`	`STRING`	열이 _PARTITIONTIME 또는 _PARTITIONDATE와 같은 의사 열인지 여부에 따라 `YES` 또는 `NO`
`IS_UPDATABLE`	`STRING`	값이 항상 `NULL`임
`IS_SYSTEM_DEFINED`	`STRING`	열이 _PARTITIONTIME 또는 _PARTITIONDATE와 같은 의사 열인지 여부에 따라 `YES` 또는 `NO`
`IS_PARTITIONING_COLUMN`	`STRING`	열이 파티션 나누기 열인지 여부에 따라 `YES` 또는 `NO`
`CLUSTERING_ORDINAL_POSITION`	`INT64`	테이블 클러스터링 열에 있는 해당 열의 1부터 시작하는 오프셋. 테이블이 클러스터링된 테이블이 아니면 값은 `NULL`입니다.
`COLLATION_NAME`	`STRING`	콜레이션 사양 이름(있는 경우)입니다. 그 외의 경우는 `NULL`입니다. `STRING` 또는 `ARRAY<STRING>`이 전달된 경우 콜레이션 사양(있는 경우)이 반환됩니다. 그 외의 경우는 `NULL`이 반환됩니다.
`COLUMN_DEFAULT`	`STRING`	존재하는 경우 열의 기본값이고 그렇지 않은 경우 값은 `NULL`입니다.
`ROUNDING_MODE`	`STRING`	유형이 매개변수화된 `NUMERIC` 또는 `BIGNUMERIC`인 경우 필드에 기록되는 값에 사용되는 반올림 모드입니다. 그렇지 않으면 값은 `NULL`입니다.

범위 및 구문

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

뷰 이름	리소스 범위	리전 범위
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.COLUMNS	프로젝트 수준	`REGION`
`[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.COLUMNS`	데이터 세트 수준	데이터 세트 위치

다음을 바꿉니다.

(선택사항) PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.

+ REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 region-us입니다. + DATASET_ID: 데이터 세트의 ID입니다. 자세한 내용은 데이터 세트 한정자를 참조하세요.

참고: INFORMATION_SCHEMA 뷰를 쿼리하려면 리전 한정자를 사용해야 합니다. 쿼리 실행 위치는 INFORMATION_SCHEMA 뷰의 리전과 일치해야 합니다.

예

다음 예시는 census_bureau_usa 데이터 세트에 있는 population_by_zip_2010 테이블의 INFORMATION_SCHEMA.COLUMNS 뷰에서 메타데이터를 검색합니다. 이 데이터 세트는 BigQuery 공개 데이터 세트 프로그램의 일부입니다.

쿼리하려는 테이블이 bigquery-public-data 프로젝트라는 다른 프로젝트에 있으므로 프로젝트 ID를 `project_id`.dataset.INFORMATION_SCHEMA.view 형식으로 데이터 세트에 추가합니다(예: `bigquery-public-data`.census_bureau_usa.INFORMATION_SCHEMA.TABLES).

다음 열은 현재 나중에 사용하도록 예약되어 있으므로 쿼리 결과에서 제외됩니다.

IS_GENERATED
GENERATION_EXPRESSION
IS_STORED
IS_UPDATABLE

  SELECT
    * EXCEPT(is_generated, generation_expression, is_stored, is_updatable)
  FROM
    `bigquery-public-data`.census_bureau_usa.INFORMATION_SCHEMA.COLUMNS
  WHERE
    table_name = 'population_by_zip_2010';

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

+------------------------+-------------+------------------+-------------+-----------+-----------+-------------------+------------------------+-----------------------------+
|       table_name       | column_name | ordinal_position | is_nullable | data_type | is_hidden | is_system_defined | is_partitioning_column | clustering_ordinal_position |
+------------------------+-------------+------------------+-------------+-----------+-----------+-------------------+------------------------+-----------------------------+
| population_by_zip_2010 | zipcode     |                1 | NO          | STRING    | NO        | NO                | NO                     |                        NULL |
| population_by_zip_2010 | geo_id      |                2 | YES         | STRING    | NO        | NO                | NO                     |                        NULL |
| population_by_zip_2010 | minimum_age |                3 | YES         | INT64     | NO        | NO                | NO                     |                        NULL |
| population_by_zip_2010 | maximum_age |                4 | YES         | INT64     | NO        | NO                | NO                     |                        NULL |
| population_by_zip_2010 | gender      |                5 | YES         | STRING    | NO        | NO                | NO                     |                        NULL |
| population_by_zip_2010 | population  |                6 | YES         | INT64     | NO        | NO                | NO                     |                        NULL |
+------------------------+-------------+------------------+-------------+-----------+-----------+-------------------+------------------------+-----------------------------+