Introdução a INFORMATION_dataset

As visualizações INFORMATION_SCHEMA do BigQuery são visualizações somente leitura definidas pelo sistema que fornecem informações de metadados sobre seus objetos do BigQuery. A tabela a seguir lista todas as visualizações de INFORMATION_SCHEMA que podem ser consultadas para recuperar informações de metadados:

Tipo de recurso	Visualizar INFORMATION_SCHEMA
Controle de acesso	`OBJECT_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Configurações	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGES` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGES`
Conjuntos de dados	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience`
Empregos	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Jobs por fração de tempo	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Recomendações e insights	`INSIGHTS` `RECOMMENDATIONS` `RECOMMENDATIONS_BY_ORGANIZATION`
Reservas	`ASSIGNMENTS_BY_PROJECT^†` `ASSIGNMENT_CHANGES_BY_PROJECT^†` `CAPACITY_COMMITMENTS_BY_PROJECT^†` `CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†` `RESERVATIONS_BY_PROJECT^†` `RESERVATION_CHANGES_BY_PROJECT^†` `RESERVATIONS_TIMELINE_BY_PROJECT^†`
Rotinas	`PARAMETERS` `ROUTINES` `ROUTINE_OPTIONS`
Índices da Pesquisa	`SEARCH_INDEXES` `SEARCH_INDEX_COLUMNS`
Sessões	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
Streaming	`STREAMING_TIMELINE_BY_PROJECT^†` `STREAMING_TIMELINE_BY_FOLDER` `STREAMING_TIMELINE_BY_ORGANIZATION`
Tabelas	`COLUMNS` `COLUMN_FIELD_PATHS` `CONSTRAINT_COLUMN_USAGE` `KEY_COLUMN_USAGE` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
Índices vetoriais	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Visualizações	`VIEWS` `MATERIALIZED_VIEWS`
API Write	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`

^† Para visualizações *BY_PROJECT, o sufixo BY_PROJECT é opcional. Por exemplo, consultar INFORMATION_SCHEMA.JOBS_BY_PROJECT e INFORMATION_SCHEMA.JOBS retorna os mesmos resultados.

Preços

Para projetos que usam sistema de preços sob demanda, as consultas nas visualizações de INFORMATION_SCHEMA incorrem um mínimo de 10 MB de cobranças de processamento de dados, mesmo que os bytes processados pela consulta sejam inferiores a 10 MB. Esse é o valor mínimo de faturamento para consultas sob demanda. Para saber mais informações, consulte Preços sob demanda.

Para projetos que usam preços baseados em capacidade, as consultas em visualizações e tabelas de INFORMATION_SCHEMA consomem os slots comprados do BigQuery. Para mais informações, consulte preços baseados na capacidade.

Como as consultas de INFORMATION_SCHEMA não são armazenadas em cache, a cobrança é feita sempre que você executa uma consulta de INFORMATION_SCHEMA, ainda que você use sempre o mesmo texto de consulta.

Não são cobradas taxas de armazenamento pelas visualizações de INFORMATION_SCHEMA.

Sintaxe

Uma visualização INFORMATION_SCHEMA precisa ser qualificada com um conjunto de dados ou uma região.

Observação:é necessário especificar um local para consultar uma visualização INFORMATION_SCHEMA. A consulta da visualização INFORMATION_SCHEMA falhará com o erro a seguir se o local de execução da consulta não corresponder ao local do conjunto de dados ou do qualificador regional usado:

Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

Qualificador de conjunto de dados

Quando presente, um qualificador de conjunto de dados restringe os resultados ao conjunto de dados especificado. Por exemplo:

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

As seguintes visualizações INFORMATION_SCHEMA são compatíveis com qualificadores de conjunto de dados:

COLUMNS
COLUMN_FIELD_PATHS
MATERIALIZED_VIEWS
PARAMETERS
PARTITIONS
ROUTINES
ROUTINE_OPTIONS
TABLES
TABLE_OPTIONS
VIEWS

Qualificador de região

Os qualificadores de região são representados com o uso de uma sintaxe region-REGION. Qualquer nome do local do conjunto de dados pode ser usado para REGION. Por exemplo, os seguintes qualificadores de região são válidos:

region-us
region-asia-east2
region-europe-north1

Quando presente, um qualificador de região restringe os resultados ao local especificado. Por exemplo, a consulta a seguir retorna metadados de todos os conjuntos de dados em um projeto na multirregião US:

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

As visualizações INFORMATION_SCHEMA a seguir não são compatíveis com os qualificadores de região:

Se nenhum qualificador de região ou de conjunto de dados for especificado, você receberá um erro.

As consultas em uma visualização INFORMATION_SCHEMA qualificada por região são executadas na região especificada, o que significa que não é possível escrever uma única consulta para mesclar dados de visualizações em diferentes regiões. Para combinar visualizações INFORMATION_SCHEMA de várias regiões, grave os resultados da consulta em tabelas e copie as tabelas ou mova os conjuntos de dados para uma região comum.

Qualificador de projeto

Quando presente, um qualificador de projeto restringe os resultados ao projeto especificado. Por exemplo:

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

Todas as visualizações INFORMATION_SCHEMA são compatíveis com qualificadores de projeto. Se um qualificador de projeto não for especificado, a visualização será padronizada para o projeto em que a consulta está sendo executada.

Especificar um qualificador de projeto para visualizações no nível da organização (por exemplo, STREAMING_TIMELINE_BY_ORGANIZATION) não afeta os resultados.

Limitações

As consultas INFORMATION_SCHEMA do BigQuery precisam estar na sintaxe GoogleSQL. INFORMATION_SCHEMA não é compatível com o SQL legado.
Os resultados das consultas de INFORMATION_SCHEMA não são armazenados em cache.
As visualizações de INFORMATION_SCHEMA não podem ser usadas em instruções de Linguagem de definição de dados (DDL, na sigla em inglês).
As visualizações INFORMATION_SCHEMA não contêm informações sobre os conjuntos de dados ocultos.
As consultas INFORMATION_SCHEMA com qualificadores de região podem incluir metadados de recursos nessa região provenientes de conjuntos de dados excluídos que estão dentro do período de viagem no tempo.
Quando você lista recursos de uma visualização INFORMATION_SCHEMA, as permissões são verificadas apenas no nível pai, não em uma linha individual. Portanto, qualquer política de negação (visualização) que segmenta condicionalmente uma linha individual usando tags é ignorada.