Visualizzazione ROUTINE_OPTIONS

La vista INFORMATION_SCHEMA.ROUTINE_OPTIONS contiene una riga per ogni opzione di ogni routine in un set di dati.

Autorizzazioni obbligatorie

Per eseguire una query sulla vista INFORMATION_SCHEMA.ROUTINE_OPTIONS, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):

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

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

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

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

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.ROUTINE_OPTIONS, i risultati della query contengono una riga per ogni opzione di ogni routine in un set di dati.

La vista INFORMATION_SCHEMA.ROUTINE_OPTIONS ha il seguente schema:

Nome colonna Tipo di dati Valore
SPECIFIC_CATALOG STRING Il nome del progetto che contiene la routine in cui è definita l'opzione
SPECIFIC_SCHEMA STRING Il nome del set di dati che contiene la routine in cui è definita l'opzione
SPECIFIC_NAME STRING Il nome della routine
OPTION_NAME STRING Uno dei valori del nome nella tabella delle opzioni
OPTION_TYPE STRING Uno dei valori del tipo di dati nella tabella delle opzioni.
OPTION_VALUE STRING Una delle opzioni di valore nella tabella delle opzioni.
Tabella delle opzioni
OPTION_NAME OPTION_TYPE OPTION_VALUE
description STRING La descrizione della routine, se definita
library ARRAY I nomi delle librerie a cui viene fatto riferimento nella routine. Applicabili solo alle funzioni definite dall'utente JavaScript
data_governance_type DataGovernanceType Il nome del tipo di governance dei dati supportato. Ad esempio, DATA_MASKING.

Ambito e sintassi

Le query in questa visualizzazione devono includere un set di dati o un qualificatore di regione. Per ulteriori informazioni, consulta la sezione Sintassi. La tabella seguente illustra gli ambiti a livello di regione e risorsa per questa visualizzazione:

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS A livello di progetto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS Livello 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.

Esempio

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

Esempio

Esempio 1:

L'esempio seguente recupera le opzioni di routine per tutte le routine in mydataset nel tuo progetto predefinito (myproject) eseguendo una query nella vista INFORMATION_SCHEMA.ROUTINE_OPTIONS:

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

Il risultato è simile al seguente:

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