ORGANIZATION_OPTIONS_CHANGES 뷰

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 뷰를 쿼리하면 조직의 BigQuery 구성 변경사항에 대한 실시간 메타데이터를 검색할 수 있습니다. 이 뷰에는 2024년 1월 31일 이후에 적용된 조직 수준 및 프로젝트 수준 구성 변경사항이 반영됩니다.

필수 권한

구성 변경사항을 가져오는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 BigQuery 관리자(roles/bigquery.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 구성 변경사항을 가져오는 데 필요한 bigquery.config.update 권한이 포함되어 있습니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

스키마

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 뷰를 쿼리하면 조직의 구성 변경사항마다 행이 하나씩 쿼리 결과에 포함됩니다.

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

열 이름 데이터 유형 값
update_time TIMESTAMP 구성 변경이 발생한 시간입니다.
username STRING 퍼스트 파티 사용자의 경우 사용자 이메일입니다. 서드 파티 사용자의 경우 사용자가 서드 파티 ID 공급업체에서 설정한 이름입니다.
updated_options JSON 사용자가 변경에서 업데이트한 구성 옵션의 JSON 객체이며 업데이트된 필드의 이전 값과 새 값을 포함합니다.
project_id STRING 프로젝트 ID입니다. 조직 수준 구성 변경사항의 경우 이 필드는 비어 있습니다.
project_number INTEGER 프로젝트 번호입니다. 조직 수준 구성 변경사항의 경우 이 필드는 비어 있습니다.

데이터 보관

이 뷰에는 실행 중인 세션과 지난 180일 동안 완료된 세션의 기록이 포함됩니다.

범위 및 구문

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

뷰 이름 리소스 범위 리전 범위
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 지정된 조직 내의 구성 변경사항입니다. REGION

다음을 바꿉니다.

예시

다음 예시에서는 default_query_job_timeout_ms option 옵션의 모든 변경사항을 검색합니다.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

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

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+