Tampilan ORGANIZATION_OPTIONS

Anda dapat membuat kueri tampilan INFORMATION_SCHEMA.ORGANIZATION_OPTIONS untuk mengambil metadata real-time tentang opsi organisasi BigQuery. Tabel virtual ini berisi opsi konfigurasi yang ditetapkan di tingkat organisasi. Untuk melihat nilai default opsi konfigurasi, lihat setelan konfigurasi.

Izin yang diperlukan

Untuk mendapatkan metadata opsi organisasi, Anda memerlukan izin Identity and Access Management (IAM) berikut:

  • bigquery.config.get

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

  • roles/bigquery.jobUser

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

Skema

Saat Anda membuat kueri tabel virtual INFORMATION_SCHEMA.ORGANIZATION_OPTIONS, hasil kueri akan berisi satu baris untuk setiap opsi konfigurasi dalam sebuah project, jika opsi tersebut berbeda dengan nilai default di level organisasi.

Tampilan INFORMATION_SCHEMA.ORGANIZATION_OPTIONS memiliki skema berikut:

Nama kolom Jenis data Nilai
option_name STRING Salah satu nilai nama dalam tabel opsi.
option_description STRING Deskripsi opsi.
option_type STRING Jenis data option_value.
option_value STRING Nilai opsi saat ini.
Tabel Opsi
option_name option_type option_value
default_time_zone STRING Zona waktu default untuk organisasi ini.
default_kms_key_name STRING Nama kunci default untuk organisasi ini.
default_query_job_timeout_ms STRING Waktu tunggu kueri default dalam milidetik untuk organisasi ini.
default_interactive_query_queue_timeout_ms STRING Waktu tunggu default dalam milidetik untuk kueri interaktif dalam antrean untuk organisasi ini.
default_batch_query_queue_timeout_ms STRING Waktu tunggu default dalam milidetik untuk kueri batch dalam antrean untuk organisasi ini.
reusable_column_aliases_mode STRING Apakah alias kolom yang dapat digunakan kembali diaktifkan di organisasi ini.

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

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.ORGANIZATION_OPTIONS Opsi konfigurasi dalam organisasi yang ditentukan. REGION

Ganti kode berikut:

Contoh

Contoh berikut mengambil kolom OPTION_NAME, OPTION_TYPE, dan OPTION_VALUE dari INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Hasilnya mirip dengan berikut ini:

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+