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 dei set di dati, devi disporre dell'autorizzazione bigquery.datasets.get Identity and Access Management (IAM) a livello di progetto.

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per visualizzare la visualizzazione 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 nella 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 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 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 della regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati dalla regione degli Stati Uniti. La tabella seguente illustra 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 progetto Google Cloud. 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 la data e l'ora di scadenza predefinita della tabella per tutti i set di dati del 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 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")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+