Esta página foi traduzida pela API Cloud Translation.

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 dados`CREATE 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 Google 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`.

Nota: tem de usar um qualificador de região para consultar as visualizações INFORMATION_SCHEMA. A localização da execução da consulta tem de corresponder à região da vista INFORMATION_SCHEMA.

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