Visualizzazione SCHEMATA_OPTIONS

La visualizzazione INFORMATION_SCHEMA.SCHEMATA_OPTIONS contiene una riga per ogni opzione impostata in ogni set di dati di un progetto.

Prima di iniziare

Per eseguire query sulla visualizzazione SCHEMATA_OPTIONS per i metadati del set di dati, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.datasets.get a livello di progetto.

Ognuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per ottenere la visualizzazione SCHEMATA_OPTIONS:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

Per saperne di più sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.SCHEMATA_OPTIONS, i risultati della query contengono una riga per ogni opzione impostata in ogni set di dati di un progetto.

La vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS ha lo schema seguente:

Nome colonna Tipo di dati Valore
catalog_name STRING Il nome del progetto che contiene il set di dati
schema_name STRING Il nome del set di dati, chiamato anche datasetId
option_name STRING Il nome dell'opzione. Per un elenco delle opzioni supportate, consulta l'elenco delle opzioni dello schema.

L'opzione storage_billing_model viene visualizzata solo per i set di dati aggiornati dopo il 1° dicembre 2022. Per i set di dati aggiornati l'ultima volta prima di questa data, il modello di fatturazione dello spazio di archiviazione è LOGICAL.
option_type STRING Il tipo di dati dell'opzione
option_value STRING Il valore dell'opzione

Ambito e sintassi

Le query su questa vista devono includere un qualificatore di regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati dalla regione Stati Uniti. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Visualizza nome Ambito risorsa Ambito regione
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_OPTIONS Livello progetto Regione degli Stati Uniti
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS Livello progetto REGION
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`.

Esempio

-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA_OPTIONS;

Esempi

Recupera il tempo di scadenza predefinito della tabella per tutti i set di dati nel progetto

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

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
 ad esempio, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'default_table_expiration_days';

Il risultato è simile al seguente:

  +----------------+---------------+-------------------------------+-------------+---------------------+
  |  catalog_name  |  schema_name  |          option_name          | option_type |    option_value     |
  +----------------+---------------+-------------------------------+-------------+---------------------+
  | myproject      | mydataset3    | default_table_expiration_days | FLOAT64     | 0.08333333333333333 |
  | myproject      | mydataset2    | default_table_expiration_days | FLOAT64     | 90.0                |
  | myproject      | mydataset1    | default_table_expiration_days | FLOAT64     | 30.0                |
  +----------------+---------------+-------------------------------+-------------+---------------------+

Recuperare le etichette per tutti i set di dati nel progetto

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

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
; ad esempio, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'labels';

Il risultato è simile al seguente:

  +----------------+---------------+-------------+---------------------------------+------------------------+
  |  catalog_name  |  schema_name  | option_name |          option_type            |      option_value      |
  +----------------+---------------+-------------+---------------------------------+------------------------+
  | myproject      | mydataset1    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  | myproject      | mydataset2    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+