visualizzazione 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 query sulla vista SCHEMATA 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 SCHEMATA visualizza:

  • 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, 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, chiamato anche datasetId
SCHEMA_OWNER STRING Il valore è sempre NULL
CREATION_TIME TIMESTAMP L'ora di creazione del set di dati
LAST_MODIFIED_TIME TIMESTAMP Ora dell'ultima modifica del set di dati
LOCATION STRING La posizione geografica del set di dati
DDL STRING CREATE SCHEMA Istruzione DDL che può essere utilizzata per creare il set di dati
DEFAULT_COLLATION_NAME STRING Il nome della specifica di confronto predefinita se esiste; altrimenti NULL.

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 Livello di progetto Regione degli Stati Uniti
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA 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 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 migliorare la leggibilità, alcune colonne 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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+