Visualizzazione SCHEMATA

La visualizzazione INFORMATION_SCHEMA.SCHEMATA fornisce informazioni sui set di dati in un progetto o una regione. La visualizzazione restituisce una riga per ogni set di dati.

Prima di iniziare

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

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per visualizzare la visualizzazione SCHEMATA:

  • 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, i risultati della query contengono una riga per ogni set di dati nel progetto specificato.

La vista INFORMATION_SCHEMA.SCHEMATA 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, noto anche come datasetId
SCHEMA_OWNER STRING Il valore è sempre NULL
CREATION_TIME TIMESTAMP La data e l'ora di creazione del set di dati
LAST_MODIFIED_TIME TIMESTAMP L'ora dell'ultima modifica del set di dati
LOCATION STRING La posizione geografica del set di dati
DDL STRING L'istruzione CREATE SCHEMA DDL che può essere utilizzata per creare il set di dati
DEFAULT_COLLATION_NAME STRING Il nome della specifica di regole di confronto predefinita se esistente; in caso contrario, NULL.

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 Livello progetto Regione degli Stati Uniti
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA 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;

    Esempio

    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
     ad esempio, `myproject`.INFORMATION_SCHEMA.SCHEMATA.

    SELECT
  * EXCEPT (schema_owner)
FROM
  INFORMATION_SCHEMA.SCHEMATA;

    Il risultato è simile al seguente. Per una maggiore leggibilità, alcune colonne vengono escluse dal risultato.

    +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
|  catalog_name  |  schema_name  |    creation_time    | last_modified_time  |  location  |                   ddl                    |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset1    | 2018-11-07 19:50:24 | 2018-11-07 19:50:24 | US         | CREATE SCHEMA `myproject.mydataset1`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset2    | 2018-07-16 04:24:22 | 2018-07-16 04:24:22 | US         | CREATE SCHEMA `myproject.mydataset2`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   default_partition_expiration_days=3.0, |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset3    | 2018-02-07 21:08:45 | 2018-05-01 23:32:53 | US         | CREATE SCHEMA `myproject.mydataset3`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   description="My dataset",              |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+