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 una query sulla vista INFORMATION_SCHEMA.ROUTINE_OPTIONS, è necessario quanto segue 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 vista INFORMATION_SCHEMA.ROUTINE_OPTIONS, i risultati 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 contenente la routine in cui è definita l'opzione
SPECIFIC_SCHEMA STRING Il nome del set di dati che contiene la routine in cui l'opzione è definito
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 dei valori 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 JavaScript definite dall'utente
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 maggiori 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 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 progetto Google Cloud. Se non 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:

Il seguente esempio 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"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+