Introdução ao INFORMATION_SCHEMA do BigQuery

INFORMATION_SCHEMA é uma série de visualizações que fornecem acesso a:

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 esr 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;

-- Prepending a project ID returns metadata for the specified project
-- and dataset.
SELECT * FROM myProject.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
  • ROUTINES
  • ROUTINE_OPTIONS
  • TABLES
  • TABLE_OPTIONS
  • VIEWS

Qualificador de região

Os qualificadores de região são representados usando uma sintaxe region-REGION. Qualquer nome da região do conjunto de dados pode ser usado para REGION. Por exemplo, estes são todos os qualificadores de região válidos:

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

Quando presente, um qualificador de região restringe os resultados à região especificada. Exemplo:

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

-- Prepending a project ID returns metadata from the specified project
-- and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.SCHEMATA;

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

  • Todas as visualizações compatíveis com qualificadores de conjunto de dados
  • ASSIGNMENT_CHANGES_BY_PROJECT
  • ASSIGNMENTS_BY_PROJECT
  • CAPACITY_COMMITMENT_CHANGES_BY_PROJECT
  • CAPACITY_COMMITMENTS_BY_PROJECT
  • JOBS_BY_ORGANIZATION
  • JOBS_BY_FOLDER
  • JOBS_BY_PROJECT
  • JOBS_BY_USER
  • JOBS_TIMELINE_BY_ORGANIZATION
  • JOBS_TIMELINE_BY_FOLDER
  • JOBS_TIMELINE_BY_PROJECT
  • JOBS_TIMELINE_BY_USER
  • RESERVATION_CHANGES_BY_PROJECT
  • RESERVATIONS_PROJECT
  • STREAMING_TIMELINE_BY_ORGANIZATION
  • STREAMING_TIMELINE_BY_FOLDER
  • STREAMING_TIMELINE_BY_PROJECT
  • SCHEMATA
  • SCHEMATA_OPTIONS

Limitações

O BigQuery INFORMATION_SCHEMA está sujeito às seguintes limitações:

  • As consultas do BigQuery INFORMATION_SCHEMA precisam estar na sintaxe SQL padrão. INFORMATION_SCHEMA não é compatível com o SQL legado.
  • Os resultados das consultas de INFORMATION_SCHEMA não são armazenados em cache.
  • No momento, não é possível usar o INFORMATION_SCHEMA para recuperar metadados sobre partições em tabelas particionadas.
  • 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).