Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Introdução ao INFORMATION_SCHEMA do BigQuery

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_PRIVILEGES
Reservas de BI BI_CAPACITIES
BI_CAPACITY_CHANGES
Opções de configuração EFFECTIVE_PROJECT_OPTIONS
ORGANIZATION_OPTIONS
PROJECT_OPTIONS
Conjuntos de dados SCHEMATA
Opções do conjunto de dados SCHEMATA_OPTIONS
Metadados do índice SEARCH_INDEXES
SEARCH_INDEXES_COLUMNS
Metadados de jobs JOBS_BY_PROJECT
JOBS_BY_USER
JOBS_BY_FOLDER
JOBS_BY_ORGANIZATION
Metadados de jobs por timelice JOBS_TIMELINE_BY_PROJECT
JOBS_TIMELINE_BY_USER
JOBS_TIMELINE_BY_FOLDER
JOBS_TIMELINE_BY_ORGANIZATION
Metadados de reserva RESERVATIONS_BY_PROJECT
RESERVATION_CHANGES_BY_PROJECT
RESERVATIONS_TIMELINE_BY_PROJECT
ASSIGNMENTS_BY_PROJECT
ASSIGNMENT_CHANGES_BY_PROJECT
CAPACITY_COMMITMENTS_BY_PROJECT
CAPACITY_COMMITMENT_CHANGES_BY_PROJECT
Rotinas ROUTINES
Opções de rotina ROUTINE_OPTIONS
Parâmetros de rotina PARAMETERS
Metadados da sessão SESSIONS_BY_PROJECT
SESSIONS_BY_USER
Dados de streaming STREAMING_TIMELINE_BY_PROJECT
STREAMING_TIMELINE_BY_FOLDER
STREAMING_TIMELINE_BY_ORGANIZATION
Metadados de tabelas TABLES
TABLE_OPTIONS
Colunas da tabela COLUMNS
COLUMN_FIELD_PATHS
Partições de tabelas PARTITIONS
Snapshots da tabela TABLE_SNAPSHOT
Uso do armazenamento da tabela (atual) TABLE_STORAGE_BY_PROJECT
TABLE_STORAGE_BY_ORGANIZATION
Uso do armazenamento da tabela ao longo do tempo TABLE_STORAGE_TIMELINE_BY_PROJECT
TABLE_STORAGE_TIMELINE_BY_ORGANIZATION
Visualizações 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 fixos, as consultas nas tabelas e visualizações de INFORMATION_SCHEMA consomem seus slots comprados do BigQuery. Para mais informações, consulte os preços fixos.

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

Pode ser necessário qualificar uma visualização INFORMATION_SCHEMA com um conjunto de dados ou região.

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
  • 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, TABLE_STORAGE_TIMELINE_BY_ORGANIZATION) não afeta os resultados.

Limitações

  • As consultas do BigQuery INFORMATION_SCHEMA precisam estar na sintaxe SQL padrão do Google. 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).