Tabel virtual EFFECTIVE_PROJECT_OPTIONS

Anda dapat membuat kueri tabel virtual INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS untuk mengambil metadata real-time tentang opsi project BigQuery yang efektif. Tabel virtual ini berisi setelan default di tingkat organisasi atau project.

Izin yang diperlukan

Untuk mendapatkan metadata opsi project yang efektif, Anda memerlukan izin Identity and Access Management (IAM) bigquery.config.get.

Peran IAM yang telah ditetapkan berikut mencakup izin yang Anda perlukan untuk mendapatkan metadata opsi project yang efektif:

roles/bigquery.jobUser

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

Skema

Saat Anda membuat kueri tabel virtual INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS, hasil kueri akan berisi satu baris untuk setiap konfigurasi dalam sebuah project.

Tabel virtual INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS memiliki skema berikut:

Nama kolom	Jenis data	Nilai
`OPTION_NAME`	`STRING`	ID opsi untuk setelan konfigurasi yang ditentukan.
`OPTION_DESCRIPTION`	`STRING`	Deskripsi opsi.
`OPTION_TYPE`	`STRING`	Jenis data `OPTION_VALUE`.
`OPTION_SET_LEVEL`	`STRING`	Tingkat dalam hierarki tempat setelan ditetapkan, dengan kemungkinan nilai `DEFAULT`, `ORGANIZATION`, atau `PROJECTS`.
`OPTION_SET_ON_ID`	`STRING`	Tetapkan nilai berdasarkan nilai `OPTION_SET_LEVEL`: Jika `DEFAULT`, tetapkan ke `null`. Jika `ORGANIZATION`, tetapkan ke `""`. Jika `PROJECT`, tetapkan ke `ID`.
`OPTION_VALUE`	`STRING`	Nilai opsi saat ini.

Tabel opsi

`OPTION_NAME`	`OPTION_TYPE`	`OPTION_VALUE`
`default_time_zone`	`STRING`	Zona waktu default yang efektif untuk project ini.
`default_kms_key_name`	`STRING`	Nama kunci default yang efektif untuk project ini.
`default_query_job_timeout_ms`	`INT64`	Waktu tunggu kueri default yang efektif dalam milidetik untuk project ini.
`default_interactive_query_queue_timeout_ms`	`STRING`	Waktu tunggu default yang efektif dalam milidetik untuk kueri interaktif dalam antrean untuk project ini.
`default_batch_query_queue_timeout_ms`	`STRING`	Waktu tunggu default yang efektif dalam milidetik untuk kueri batch dalam antrean untuk project ini.

Retensi data

Tabel virtual ini berisi sesi yang sedang berjalan dan histori sesi yang diselesaikan 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.EFFECTIVE_PROJECT_OPTIONS	Opsi konfigurasi dalam project yang ditentukan.	`REGION`

Ganti kode berikut:

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

Contoh

Contoh berikut mengambil kolom OPTION_NAME, OPTION_TYPE, OPTION_VALUE, OPTION_SET_LEVEL, dan OPTION_SET_ON_ID dari tabel virtual INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS.

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

Hasilnya akan mirip dengan berikut ini:

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