Tampilan PARAMETERS

Tampilan INFORMATION_SCHEMA.PARAMETERS berisi satu baris untuk setiap parameter dari setiap rutinitas dalam set data.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.PARAMETERS, 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 rutinitas:

  • 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.PARAMETERS, hasil kueri akan berisi satu baris untuk setiap parameter dari setiap rutinitas dalam set data.

Tampilan INFORMATION_SCHEMA.PARAMETERS memiliki skema berikut:

Nama kolom Jenis data Nilai
specific_catalog STRING Nama project yang berisi set data tempat rutinitas yang berisi parameter ditetapkan
specific_schema STRING Nama set data yang berisi rutinitas tempat parameter ditentukan
specific_name STRING Nama rutinitas tempat parameter ditentukan
ordinal_position STRING Posisi berbasis 1 untuk parameter, atau 0 untuk nilai yang ditampilkan
parameter_mode STRING Mode parameter, baik IN, OUT, INOUT, atau NULL
is_result STRING Apakah parameter tersebut merupakan hasil fungsi, YES atau NO
parameter_name STRING Nama parameter
data_type STRING Jenis parameter, akan menjadi ANY TYPE jika ditentukan sebagai jenis apa pun
parameter_default STRING Nilai default parameter sebagai nilai literal SQL, selalu NULL
is_aggregate STRING Apakah ini merupakan parameter gabungan, selalu NULL

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.PARAMETERS Level project REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PARAMETERS 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 parameters of a routine in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.PARAMETERS;

-- Returns metadata for parameters of a routine in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.PARAMETERS;

Contoh

Contoh

Untuk menjalankan kueri terhadap set data di project selain project default Anda, tambahkan project ID dalam format berikut: 

`PROJECT_ID`.`DATASET_ID`.INFORMATION_SCHEMA.PARAMETERS
 Ganti kode berikut:

  • PROJECT_ID: ID project.
  • DATASET_ID: ID set data.

Misalnya, example-project.mydataset.INFORMATION_SCHEMA.JOBS_BY_PROJECT.

Contoh berikut mengambil semua parameter dari tampilan INFORMATION_SCHEMA.PARAMETERS. Metadata yang ditampilkan adalah untuk rutinitas di mydataset dalam project default Anda — myproject.

SELECT
  * EXCEPT(is_typed)
FROM
  mydataset.INFORMATION_SCHEMA.PARAMETERS
WHERE
  table_type = 'BASE TABLE';

Hasilnya mirip dengan berikut ini:

+-------------------+------------------+---------------+------------------+----------------+-----------+----------------+-----------+-------------------+--------------+
| specific_catalog  | specific_schema  | specific_name | ordinal_position | parameter_mode | is_result | parameter_name | data_type | parameter_default | is_aggregate |
+-------------------+------------------+---------------+------------------+----------------+-----------+----------------+-----------+-------------------+--------------+
| myproject         | mydataset        | myroutine1    | 0                | NULL           | YES       | NULL           | INT64     | NULL              | NULL         |
| myproject         | mydataset        | myroutine1    | 1                | NULL           | NO        | x              | INT64     | NULL              | NULL         |
+-------------------+------------------+---------------+------------------+----------------+-----------+----------------+-----------+-------------------+--------------+