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 contenente la routine in cui è definita l'opzione
SPECIFIC_SCHEMA STRING Il nome del set di dati contenente la routine in cui è definita l'opzione
SPECIFIC_NAME STRING Il nome della routine
OPTION_NAME STRING Uno dei valori di 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 funzioni UDF JavaScript
data_governance_type DataGovernanceType Il nome del tipo di governance dei dati supportato. Ad esempio, DATA_MASKING.

Ambito e sintassi

Le query su questa vista devono includere un set di dati o un qualificatore di regione. Per ulteriori informazioni, consulta la sezione Sintassi. La tabella seguente illustra gli ambiti della regione e delle risorse 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 A livello di set di dati Posizione del set di dati
Sostituisci quanto segue:

  • Facoltativo: PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non viene specificato, viene utilizzato il progetto predefinito.

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