Tampilan ROUTINE_OPTIONS

Tampilan INFORMATION_SCHEMA.ROUTINE_OPTIONS berisi satu baris untuk setiap opsi setiap rutinitas dalam set data.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.ROUTINE_OPTIONS, Anda memerlukan izin Identity and Access Management (IAM) berikut:

  • bigquery.routines.get
  • bigquery.routines.list

Setiap peran IAM yang telah ditetapkan berikut mencakup izin yang Anda perlukan untuk mendapatkan metadata rutin:

  • roles/bigquery.admin
  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.ROUTINE_OPTIONS, hasil kueri akan berisi satu baris untuk setiap opsi dari setiap rutinitas dalam set data.

Tampilan INFORMATION_SCHEMA.ROUTINE_OPTIONS memiliki skema berikut:

Nama kolom Jenis data Nilai
specific_catalog STRING Nama project yang berisi rutinitas tempat opsi ditentukan
specific_schema STRING Nama set data yang berisi rutinitas tempat opsi ditentukan
specific_name STRING Nama rutinitas
option_name STRING Salah satu nilai nama dalam tabel opsi
option_type STRING Salah satu nilai jenis data dalam tabel opsi
option_value STRING Salah satu opsi nilai dalam tabel opsi
Tabel Opsi
OPTION_NAME OPTION_TYPE OPTION_VALUE
description STRING Deskripsi rutinitas, jika ditentukan
library ARRAY Nama library yang dirujuk dalam rutinitas. Hanya berlaku untuk UDF JavaScript
data_governance_type DataGovernanceType Nama jenis tata kelola data yang didukung. Misalnya DATA_MASKING.

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

Cakupan dan sintaksis

Kueri terhadap tampilan ini harus menyertakan set data atau penentu region. Untuk informasi selengkapnya, lihat Sintaksis. Tabel berikut menjelaskan cakupan region dan resource untuk tabel virtual ini:

Nama tabel virtual Cakupan resource Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS Level project REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS Level set data Lokasi set data
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
  • REGION: nama region set data apa pun. Misalnya, `region-us`.
  • DATASET_ID: ID set data Anda. Untuk mengetahui informasi selengkapnya, lihat Penentu set data.

Contoh

-- Returns metadata for routines in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

-- Returns metadata for routines in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

Contoh

Contoh 1:

Contoh berikut mengambil opsi rutinitas untuk semua rutin dalam mydataset dalam project default Anda (myproject) dengan meng-kueri tampilan INFORMATION_SCHEMA.ROUTINE_OPTIONS:

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

Hasilnya mirip dengan berikut ini:

+-------------------+------------------+---------------+----------------------+---------------+------------------+
| specific_catalog  | specific_schema  | specific_name |     option_name      | option_type   | option_value     |
+-------------------+------------------+---------------+----------------------+---------------+------------------+
| myproject         | mydataset        | myroutine1    | description          | STRING        | "a description"  |
| myproject         | mydataset        | myroutine2    | library              | ARRAY<STRING> | ["a.js", "b.js"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+