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
sui 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 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 sulla vistaINFORMATION_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 |
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 relative a 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 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 |
- (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. Alcune colonne sono escluse dal risultato per migliorarne la leggibilità.
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+ | 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" | | | | | | | ); | +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+