Introdução às visualizações

Nesta página, você encontra uma visão geral das visualizações no BigQuery.

Introdução

Uma visualização é uma tabela virtual definida por uma consulta SQL. Ao criar uma visualização, você pode consultá-la da mesma forma que faz com uma tabela. Quando um usuário consulta a visualização, os resultados contêm apenas dados das tabelas e dos campos especificados na consulta que define a exibição.

É possível consultar as visualizações no BigQuery usando estas opções:

• caixa do editor de consultas no Console do GCP
• A opção Escrever consulta na IU clássica da Web do BigQuery
• O comando bq query da ferramenta de linha de comando bq query do BigQuery
• A API REST do BigQuery para chamar de maneira programática os métodos jobs.query ou jobs.insert do tipo de consulta
• As bibliotecas de cliente do BigQuery

Você também pode usar uma visualização como fonte de dados para uma ferramenta de visualização, como o Google Data Studio.

Limitações da visualização

As visualizações do BigQuery estão sujeitas às seguintes limitações:

• O conjunto de dados que contém a visualização precisa estar no mesmo local que o conjunto de dados que contém as tabelas referenciadas pela visualização.
• Não é possível executar um job do BigQuery que exporta dados de uma visualização.
• Não é possível usar o método TableDataList da API JSON para recuperar dados de uma visualização. Para mais informações, consulte Tabledata: list.
• Não é possível combinar consultas SQL padrão e SQL legado ao usar visualizações. Uma consulta SQL padrão não pode referenciar uma visualização definida usando a sintaxe do SQL legado.
• Os esquemas das tabelas subjacentes são armazenados com a visualização quando ela é criada. Se colunas forem adicionadas, excluídas, e assim por diante, depois que a visualização for criada, o esquema informado será impreciso até que ela seja atualizada. Mesmo que o esquema informado seja impreciso, todas as consultas enviadas produzirão resultados precisos.
• Não é possível atualizar automaticamente uma exibição do SQL legado para a sintaxe SQL padrão. Para modificar a consulta usada para definir uma visualização, use a opção Editar consulta no console ou na IU clássica da Web do BigQuery, use o comando da CLI bq update --view ou os métodos da API de atualização ou de patch.
• Não é possível incluir uma função definida pelo usuário na consulta SQL que define uma visualização.
• Não é possível referenciar uma visualização em consultas a uma tabela com caractere curinga.

Cotas de visualização

Para informações sobre cotas e limites que se aplicam a visualizações, consulte Limites da visualização.

As consultas SQL usadas para definir visualizações estão sujeitas às cotas de consulta padrão.

Consultar preços

As visualizações do BigQuery são lógicas e não materializadas. Por isso, a consulta que define as visualizações é executada sempre que elas são consultadas. As consultas são faturadas de acordo com a quantidade total de dados em todos os campos da tabela referenciados direta ou indiretamente pela consulta de nível superior. Para mais informações, consulte os preços de consultas.

A seguir

• Para ver informações sobre como criar visualizações, consulte Como criar visualizações.
• Para ver informações sobre como criar uma visualização autorizada, consulte Como criar visualizações autorizadas.
• Para ver informações sobre como listar visualizações, consulte Como listar visualizações.
• Para ver informações sobre como receber metadados de visualizações, consulte Como receber informações sobre visualizações.
• Para ver informações sobre a atualização de visualizações, consulte Como atualizar visualizações.
• Para mais informações sobre como gerenciar visualizações, consulte Como gerenciar visualizações.