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 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:

  • 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, 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 che contiene 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 Data/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 DDL CREATE SCHEMA che può essere utilizzata per creare il set di dati
default_collation_name STRING Il nome della specifica di regole di confronto predefinita se esiste; altrimenti, NULL.
sync_status JSON Lo stato della sincronizzazione tra le repliche primaria e secondaria per i set di dati di replica tra regioni e recupero di emergenza. Restituisce NULL se la replica è una replica primaria o se il set di dati non utilizza la replica.

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 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 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;

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 facilitare la lettura, alcune colonne sono 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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+