visualizzazione SCHEMATA_OPTIONS

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

Prima di iniziare

Per eseguire una query su SCHEMATA_OPTIONS vista per i metadati del set di dati, è necessario il bigquery.datasets.get Autorizzazione 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 ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS, i risultati Deve contenere 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 contenente 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 è visualizzata solo per 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 relative a questa vista devono includere una regione qualificatore. In caso contrario specificare 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 della 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 progetto Google Cloud. Se non viene specificato, viene utilizzato il progetto predefinito.

Esempio

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

Esempi

Recupera la scadenza predefinita della tabella 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 = '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 del progetto

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi 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")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+