Esta página foi traduzida pela API Cloud Translation.

Introdução a INFORMATION_SCHEMA

As visualizações do BigQuery são visualizações só de leitura, definidas pelo sistema, que fornecem informações de metadados sobre os seus objetos do BigQuery.INFORMATION_SCHEMA A tabela seguinte apresenta todas as visualizações INFORMATION_SCHEMA que pode consultar para obter informações de metadados:

Tipo do recurso	Vista INFORMATION_SCHEMA
Controlo de acesso	`OBJECT_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Configurações	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGESscience` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGESscience`
Conjuntos de dados	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATIONscience`
Empregos	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Empregos por intervalo de tempo	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Recomendações e estatísticas	`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`

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

Preços

Para projetos que usam preços a pedido, as consultas em relação às visualizações incorrem num mínimo de 10 MB de custos de tratamento de dados, mesmo que os bytes processados pela consulta sejam inferiores a 10 MB.INFORMATION_SCHEMA 10 MB é o valor mínimo de faturação para consultas a pedido. Para mais informações, consulte a secção Preços a pedido.

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

Uma vez que as consultas INFORMATION_SCHEMA não são armazenadas em cache, é-lhe cobrado um valor cada vez que executa uma consulta INFORMATION_SCHEMA, mesmo que o texto da consulta seja o mesmo cada vez que a executa.

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

Sintaxe

Uma vista INFORMATION_SCHEMA tem de ser qualificada com um conjunto de dados ou uma região.

Nota: tem de especificar uma localização para consultar uma vista INFORMATION_SCHEMA. A consulta de uma vista INFORMATION_SCHEMA falha com o seguinte erro se a localização da execução da consulta não corresponder à localização do conjunto de dados ou ao qualificador regional usado:

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

Qualificador do 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 vistas INFORMATION_SCHEMA suportam qualificadores de conjuntos 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 através de uma sintaxe region-REGION. Pode usar qualquer nome de localização do conjunto de dados 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 à localização especificada. Por exemplo, a seguinte consulta devolve metadados para todos os conjuntos de dados num projeto na multirregião US:

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

As seguintes visualizações do INFORMATION_SCHEMA não suportam qualificadores de região:

Se não for especificado um qualificador de região nem um qualificador de conjunto de dados, recebe um erro.

As consultas em relação a uma vista INFORMATION_SCHEMA qualificada por região são executadas na região especificada, o que significa que não pode escrever uma única consulta para juntar dados de vistas em regiões diferentes. 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, 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 vistas INFORMATION_SCHEMA suportam qualificadores de projetos. Se não for especificado um qualificador de projeto, a vista é predefinida para o projeto no qual a consulta está a ser executada.

A especificação de um qualificador de projeto para vistas ao nível da organização (por exemplo, STREAMING_TIMELINE_BY_ORGANIZATION) não tem impacto nos resultados.

Limitações

As consultas do BigQuery INFORMATION_SCHEMA têm de estar na sintaxe do GoogleSQL. O INFORMATION_SCHEMA não suporta SQL antigo.
Os resultados das consultas INFORMATION_SCHEMA não são colocados em cache.
Não é possível usar visualizações INFORMATION_SCHEMA em declarações DDL.
As visualizações INFORMATION_SCHEMA não contêm informações sobre conjuntos de dados ocultos.
As consultas INFORMATION_SCHEMA com qualificadores de região podem incluir metadados de recursos nessa região de conjuntos de dados eliminados que se encontram no seu período de viagem no tempo.
Quando lista recursos a partir de uma vista INFORMATION_SCHEMA, as autorizações são verificadas apenas ao nível principal e não ao nível de uma linha individual. Por conseguinte, qualquer política de recusa (pré-visualização) que segmente condicionalmente uma linha individual através de etiquetas é ignorada.