Vista SCHEMATA

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

Prima di iniziare

Per eseguire una query sulla vista SCHEMATA per i metadati del 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 ottenere la vista SCHEMATA:

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

La vista INFORMATION_SCHEMA.SCHEMATA 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
SCHEMA_OWNER STRING Il valore è sempre NULL
CREATION_TIME TIMESTAMP 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 DDL CREATE SCHEMA che può essere utilizzata per creare il set di dati
DEFAULT_COLLATION_NAME STRING Il nome della specifica di confronto predefinita, se esistente. In caso contrario, NULL.

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 A livello di progetto Regione USA
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA 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.

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 la leggibilità, 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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+