Visualizzazione ROUTINE_OPTIONS

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

Autorizzazioni obbligatorie

Per eseguire query sulla visualizzazione 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 ottenere 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 visualizzazione 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 lo schema seguente:

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. Applicabile solo alle UDF JavaScript
data_governance_type DataGovernanceType Il nome del tipo di governance dei dati supportato. Ad esempio, DATA_MASKING.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema informativo anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

Ambito e sintassi

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

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS Livello progetto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS Livello del set di dati Posizione del set di dati
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. 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 maggiori informazioni, vedi 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:

Il seguente esempio recupera le opzioni di routine per tutte le routine in mydataset nel tuo progetto predefinito (myproject) eseguendo una query sulla visualizzazione 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"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+