Introdução à INFORMATION_SCHEMA

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

Tipo de recurso	Visualização 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_REPLICAS SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION`
Jobs	`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	`INSIGHTSscience` `RECOMMENDATIONSscience` `RECOMMENDATIONS_BY_ORGANIZATIONscience`
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 de pesquisa	`SEARCH_INDEXES` `SEARCH_INDEX_COLUMNS` `SEARCH_INDEX_COLUMN_OPTIONSscience` `SEARCH_INDEX_OPTIONS` `SEARCH_INDEXES_BY_ORGANIZATION`
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_FOLDER` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDERscience` `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`

^† Nas 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 on demand, as consultas nas visualizações 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 isso. Esse é o valor mínimo de faturamento para consultas on demand. Para ver mais informações sobre esses preços, acesse este link.

Para projetos que usam preços baseados em capacidade, as consultas em visualizações e tabelas INFORMATION_SCHEMA consomem os slots do BigQuery comprados. Para ver mais informações sobre esses preços, acesse este link.

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 use sempre o mesmo texto.

Não são cobradas taxas de armazenamento pelas visualizações 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 vai falhar com o erro a seguir se o local de execução 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. 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 de 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 à região especificada. Os qualificadores de região não são hierárquicos. Isso significa que a multirregião da UE não inclui as regiões europe-*, e a multirregião dos EUA não inclui as regiões us-*. Por exemplo, a consulta a seguir retorna metadados de todos os conjuntos de dados na multirregião US para o projeto em que a consulta está sendo executada, mas não inclui conjuntos de dados na região us-west1:

-- Returns metadata for all datasets in the US multi-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. Ou seja, 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, leia e combine os resultados da consulta localmente ou copie as tabelas resultantes para uma região comum.

Qualificador de projeto

Quando presente, esse tipo de qualificador restringe os resultados ao projeto especificado. 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.
Atualmente, as visualizações 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 (prévia) que segmenta condicionalmente uma linha individual usando tags é ignorada.