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 menentukan lokasi untuk membuat kueri tabel virtual INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tabel virtual 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

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';

Catatan: Nama tampilan INFORMATION_SCHEMA peka huruf besar/kecil.

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