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:

Resource type	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`
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`
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`
API Storage Write	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`
Inserções de 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`

^† 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 o local para consultar as visualizações INFORMATION_SCHEMA. A consulta das visualizações 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. 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.

Qualificador de projeto

Quando presente, um qualificador de projeto 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.
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.