EFFECTIVE_PROJECT_OPTIONS 뷰

INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 뷰를 쿼리하여 BigQuery 유효 프로젝트 옵션에 대한 실시간 메타데이터를 검색할 수 있습니다. 이 뷰에는 조직 또는 프로젝트 수준의 기본 설정이 포함됩니다.

필수 권한

효과적인 프로젝트 옵션 메타데이터를 가져오려면 bigquery.config.get Identity and Access Management(IAM) 권한이 필요합니다.

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

  • roles/bigquery.jobUser

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

스키마

INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 뷰를 쿼리하면 프로젝트의 구성마다 행이 한 개씩 쿼리 결과에 포함됩니다.

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

열 이름 데이터 유형 값
OPTION_NAME STRING 지정된 구성 설정의 옵션 ID.
OPTION_DESCRIPTION STRING 옵션 설명.
OPTION_TYPE STRING OPTION_VALUE의 데이터 유형.
OPTION_SET_LEVEL STRING 설정이 정의된 계층 구조의 수준으로 가능한 값은 DEFAULT, ORGANIZATION 또는 PROJECTS입니다.
OPTION_SET_ON_ID STRING OPTION_SET_LEVEL 값에 따라 값을 설정합니다.
  • DEFAULT이면 null로 설정합니다.
  • ORGANIZATION이면 ""로 설정합니다.
  • PROJECT이면 ID로 설정합니다.
OPTION_VALUE STRING 옵션의 현재 값.
옵션 표
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING 이 프로젝트의 유효 기본 시간대.
default_kms_key_name STRING 이 프로젝트의 유효 기본 키 이름.
default_query_job_timeout_ms INT64 이 프로젝트의 유효 기본 쿼리 제한 시간(밀리초)입니다.
default_interactive_query_queue_timeout_ms STRING 이 프로젝트의 큐에 추가된 대화형 쿼리에 적용되는 유효 기본 제한 시간(밀리초)입니다.
default_batch_query_queue_timeout_ms STRING 이 프로젝트의 큐에 추가된 일괄 쿼리의 유효 기본 제한 시간(밀리초)입니다.

데이터 보관

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

범위 및 구문

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

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

다음을 바꿉니다.

예시

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

SELECT
  option_name, option_type, option_value, option_set_level, option_set_on_id
FROM
  `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

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

  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | option_name                                | option_type | option_value        | option_set_level | option_set_on_id   |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles | organizations    | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              | organization     | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+