Questa pagina è stata tradotta dall'API Cloud Translation.

visualizzazione SCHEMATA

La visualizzazione INFORMATION_SCHEMA.SCHEMATA fornisce informazioni sui set di dati in un progetto o 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 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 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 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`	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 `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. 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 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`.

Nota: devi utilizzare un qualificatore di regione per eseguire query su INFORMATION_SCHEMA viste. La posizione dell'esecuzione della query deve corrispondere alla regione della visualizzazione INFORMATION_SCHEMA.

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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+