PROJECT_OPTIONS 뷰

INFORMATION_SCHEMA.PROJECT_OPTIONS 뷰를 쿼리하여 BigQuery 프로젝트 옵션에 대한 실시간 메타데이터를 검색할 수 있습니다. 이 뷰에는 프로젝트 수준에서 설정된 구성 옵션이 포함됩니다. 구성 옵션 기본값을 보려면 구성 설정을 참조하세요.

필수 권한

구성 옵션 메타데이터를 가져오려면 다음 Identity and Access Management(IAM) 권한이 필요합니다.

  • bigquery.config.get

다음과 같은 사전 정의된 IAM 역할에는 프로젝트 옵션 메타데이터를 가져오는 데 필요한 권한이 포함되어 있습니다.

  • roles/bigquery.jobUser

세분화된 BigQuery 권한에 대한 자세한 내용은 역할 및 권한을 참조하세요.

스키마

INFORMATION_SCHEMA.PROJECT_OPTIONS 뷰를 쿼리하면 프로젝트의 구성 옵션 중 기본값과 다른 옵션마다 행이 하나씩 쿼리 결과에 포함됩니다.

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

열 이름 데이터 유형 값
option_name STRING 지정된 구성 설정의 옵션 ID.
project_id STRING 프로젝트 ID입니다.
project_number INTEGER 프로젝트의 번호
option_description STRING 옵션 설명.
option_type STRING OPTION_VALUE의 데이터 유형.
option_value STRING 옵션의 현재 값.
옵션 표
option_name option_type option_value
default_time_zone STRING 이 프로젝트의 기본 시간대.
default_kms_key_name STRING 이 프로젝트의 기본 키 이름.
default_query_job_timeout_ms STRING 이 프로젝트의 기본 쿼리 제한 시간(밀리초)입니다. 이는 연속 쿼리에도 적용됩니다.
default_interactive_query_queue_timeout_ms STRING 이 프로젝트에 대해 큐에 추가된 대화형 쿼리의 기본 제한 시간(밀리초)입니다.
default_batch_query_queue_timeout_ms STRING 이 프로젝트에 대해 큐에 추가된 일괄 쿼리의 기본 제한 시간(밀리초)입니다.

데이터 보관

이 뷰는 현재 실행 중인 세션과 지난 180일 동안 완료된 세션 기록을 포함합니다.

범위 및 문법

이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다.

뷰 이름 리소스 범위 리전 범위
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS 지정된 프로젝트 내의 구성 옵션. REGION

다음을 바꿉니다.

예시

다음 예시에서는 INFORMATION_SCHEMA.PROJECT_OPTIONS 뷰에서 OPTION_NAME, OPTION_TYPE, OPTION_VALUE 열을 검색합니다.

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

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

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+