Visualizzazione PARAMETERS

La vista INFORMATION_SCHEMA.PARAMETERS contiene una riga per ogni parametro di ogni routine in un set di dati.

Autorizzazioni obbligatorie

Per eseguire una query sulla vista INFORMATION_SCHEMA.PARAMETERS, è necessario quanto segue Autorizzazioni IAM (Identity and Access Management):

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

Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazioni necessarie per recuperare i metadati di routine:

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

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.PARAMETERS, i risultati una riga per ogni parametro di ogni routine in un set di dati.

La vista INFORMATION_SCHEMA.PARAMETERS ha il seguente schema:

Nome colonna	Tipo di dati	Valore
SPECIFIC_CATALOG	STRING	Il nome del progetto che contiene il set di dati in cui la routine contenente il parametro
SPECIFIC_SCHEMA	STRING	Il nome del set di dati che contiene la routine in cui è definito
SPECIFIC_NAME	STRING	Il nome della routine in cui è definito il parametro
ORDINAL_POSITION	STRING	La posizione in base 1 del parametro o 0 per il valore restituito
PARAMETER_MODE	STRING	La modalità del parametro, IN, OUT, INOUT oppure NULL
IS_RESULT	STRING	Se il parametro è il risultato della funzione, YES o NO
PARAMETER_NAME	STRING	Il nome del parametro
DATA_TYPE	STRING	Il tipo di parametro sarà ANY TYPE se definito come qualsiasi tipo
PARAMETER_DEFAULT	STRING	Il valore predefinito del parametro come valore letterale SQL. sempre NULL
IS_AGGREGATE	STRING	Se si tratta di un parametro aggregato, devi sempre NULL

Ambito e sintassi

Le query su questa vista devono includere un set di dati o un qualificatore di regione. Per ulteriori informazioni per le informazioni, consulta Sintassi. La tabella seguente illustra gli ambiti delle risorse e delle regioni per questa vista:

Nome vista	Ambito risorsa	Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PARAMETERS	Livello di progetto	REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PARAMETERS	Livello del set di dati	Posizione del set di dati

Sostituisci quanto segue:

• (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non specificato, viene utilizzato il progetto predefinito.
• REGION: qualsiasi nome della regione del set di dati. Ad esempio: region-us.
• DATASET_ID: l'ID del set di dati. Per ulteriori informazioni consulta la sezione Qualificatore del set di dati.

Nota: devi utilizzare un qualificatore di regione per eseguire query su INFORMATION_SCHEMA viste. La posizione della query l'esecuzione deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Esempio

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

Esempio

Esempio

Per eseguire la query su un set di dati in un progetto diverso da quello predefinito, aggiungi l'ID progetto nel seguente formato:

`PROJECT_ID`.`DATASET_ID`.INFORMATION_SCHEMA.PARAMETERS

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• DATASET_ID: l'ID del set di dati.

Ad esempio, example-project.mydataset.INFORMATION_SCHEMA.JOBS_BY_PROJECT.

L'esempio seguente recupera tutti i parametri dal INFORMATION_SCHEMA.PARAMETERS visualizzazione. I metadati restituiti riguardano le routine in mydataset nel progetto predefinito: myproject.

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

Nota: i nomi delle visualizzazioni di INFORMATION_SCHEMA sono sensibili alle maiuscole.

Il risultato è simile al seguente:

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