Tampilan ORGANIZATION_OPTIONS_CHANGES

Anda dapat membuat kueri tampilan INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES untuk mengambil metadata real-time tentang perubahan konfigurasi BigQuery dalam organisasi. Tampilan ini mencerminkan perubahan konfigurasi tingkat organisasi dan tingkat project yang dilakukan setelah 31 Januari 2024.

Izin yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mendapatkan perubahan konfigurasi, minta administrator untuk memberi Anda peran IAM BigQuery Admin (roles/bigquery.admin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditentukan ini berisi bigquery.config.update izin, yang diperlukan untuk mendapatkan perubahan konfigurasi.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Skema

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, hasil kueri akan berisi satu baris untuk setiap perubahan konfigurasi dalam organisasi.

Tampilan INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES memiliki skema berikut:

Nama kolom Jenis data Nilai
update_time TIMESTAMP Waktu terjadinya perubahan konfigurasi.
username STRING Untuk pengguna pihak pertama, ini adalah email pengguna mereka. Untuk pengguna pihak ketiga, ini adalah nama yang ditetapkan pengguna di penyedia identitas pihak ketiga.
updated_options JSON Objek JSON dari opsi konfigurasi yang diupdate pengguna dalam perubahan, yang berisi nilai sebelumnya dan nilai baru dari kolom yang diupdate.
project_id STRING ID project. Kolom ini kosong untuk perubahan konfigurasi tingkat organisasi.
project_number INTEGER Nomor project. Kolom ini kosong untuk perubahan konfigurasi tingkat organisasi.

Untuk stabilitas, sebaiknya cantumkan kolom secara eksplisit dalam kueri skema informasi, bukan menggunakan karakter pengganti (SELECT *). Mencantumkan kolom secara eksplisit mencegah kueri rusak jika skema yang mendasarinya berubah.

Retensi data

Tampilan ini berisi sesi yang sedang berjalan, dan histori sesi yang selesai dalam 180 hari terakhir.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus memiliki penentu region.

Nama tabel virtual Cakupan resource Cakupan region
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES Perubahan konfigurasi dalam organisasi yang ditentukan. REGION

Ganti kode berikut:

  • REGION: nama region set data apa pun. Misalnya, US, atau us-west2.

Contoh

Contoh berikut mengambil semua perubahan opsi 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;

Hasilnya mirip dengan berikut ini:

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| 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}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+