Visualizzazione SCHEMATA_OPTIONS

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

Prima di iniziare

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

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per ottenere la vista SCHEMATA_OPTIONS:

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

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

Schema

Quando esegui una query sulla vista 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 il seguente schema:

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, indicato anche come `datasetId`
`OPTION_NAME`	`STRING`	Il nome dell'opzione. Per un elenco delle opzioni supportate, consulta l'elenco delle opzioni di schema.
`OPTION_TYPE`	`STRING`	Il tipo di dati dell'opzione
`OPTION_VALUE`	`STRING`	Il valore dell'opzione

Ambito e sintassi

Le query in questa vista devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati dalla regione degli 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`	A livello di progetto	Regione USA
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS	A livello di progetto	`REGION`

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.

Nota: devi specificare la località per eseguire una query sulle viste INFORMATION_SCHEMA e la località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Esempio

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

Esempi

Recupera la data di scadenza predefinita 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                |
  +----------------+---------------+-------------------------------+-------------+---------------------+

Recupera le etichette per tutti i set di dati nel tuo 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")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+