Vista SCHEMATA

A vista INFORMATION_SCHEMA.SCHEMATA apresenta informações sobre os conjuntos de dados num projeto ou numa região. A vista devolve uma linha para cada conjunto de dados.

Antes de começar

Para consultar a vista SCHEMATA para metadados do conjunto de dados, precisa da autorização de gestão de identidade e de acesso (IAM) ao nível do projeto.bigquery.datasets.get

Cada uma das seguintes funções de IAM predefinidas inclui as autorizações de que precisa para obter a vista SCHEMATA:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

Quando consulta a vista INFORMATION_SCHEMA.SCHEMATA, os resultados da consulta contêm uma linha para cada conjunto de dados no projeto especificado.

A vista INFORMATION_SCHEMA.SCHEMATA tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
catalog_name STRING O nome do projeto que contém o conjunto de dados
schema_name STRING O nome do conjunto de dados, também conhecido como datasetId
schema_owner STRING O valor é sempre NULL
creation_time TIMESTAMP Hora de criação do conjunto de dados
last_modified_time TIMESTAMP A hora da última modificação do conjunto de dados
location STRING A localização geográfica do conjunto de dados
ddl STRING A declaração DDL que pode ser usada para criar o conjunto de dadosCREATE SCHEMA
default_collation_name STRING O nome da especificação de ordenação predefinida se existir; caso contrário, NULL.
sync_status JSON O estado da sincronização entre as réplicas principal e secundária para a replicação entre regiões e os conjuntos de dados de recuperação de desastres. Devolve NULL se a réplica for uma réplica principal ou o conjunto de dados não usar a replicação.

Âmbito e sintaxe

As consultas a esta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos da região dos EUA. A tabela seguinte explica o âmbito da região para esta vista:

Nome da vista Âmbito do recurso Âmbito da região
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA Nível do projeto Região dos EUA
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Trusted Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplo

-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

Exemplo

Para executar a consulta num projeto que não seja o projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: 

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA
 por exemplo, `myproject`.INFORMATION_SCHEMA.SCHEMATA.

SELECT
  * EXCEPT (schema_owner)
FROM
  INFORMATION_SCHEMA.SCHEMATA;

O resultado é semelhante ao seguinte. Para facilitar a leitura, algumas colunas são excluídas do resultado.

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