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`

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.
Catatan: Anda harus menggunakan penentu region untuk membuat kueri tabel virtual INFORMATION_SCHEMA. Lokasi eksekusi kueri harus cocok dengan region tampilan INFORMATION_SCHEMA.

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

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