PROJECT_OPTIONS_CHANGES tampilan

Anda dapat membuat kueri tampilan INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES untuk mengambil metadata real-time tentang perubahan konfigurasi BigQuery sebuah project. Tampilan ini mencerminkan perubahan konfigurasi level project yang dibuat setelah 31 Januari 2024.

Izin yang diperlukan

Untuk mendapatkan konfigurasi ini, Anda memerlukan izin Pengelolaan Akses dan Identitas (IAM) bigquery.config.update di tingkat project. Peran IAM yang telah ditentukan roles/bigquery.admin mencakup izin yang Anda perlukan untuk membuat konfigurasi.

Untuk mengetahui informasi selengkapnya tentang izin BigQuery terperinci, lihat peran dan izin.

Skema

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, hasil kueri akan berisi satu baris untuk setiap perubahan konfigurasi dalam sebuah project.

Tabel virtual INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES memiliki skema berikut:

Nama kolom	Jenis data	Nilai
`update_time`	`TIMESTAMP`	Waktu terjadinya perubahan konfigurasi.
`username`	`STRING`	Untuk pengguna pihak pertama, email tersebut 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 diperbarui pengguna dalam perubahan, yang berisi nilai kolom sebelumnya dan yang baru.
`project_id`	`STRING`	Project ID. Kolom ini kosong untuk perubahan konfigurasi tingkat organisasi.
`project_number`	`INTEGER`	Nomor project. Kolom ini kosong untuk perubahan konfigurasi tingkat organisasi.

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.PROJECT_OPTIONS_CHANGES	Perubahan konfigurasi dalam project yang ditentukan.	`REGION`

Ganti kode berikut:

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

Contoh

Contoh berikut mengambil semua kolom dari tabel virtual INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;

Hasilnya akan 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_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+