Introdução às consultas salvas

Neste documento, apresentamos uma introdução a consultas salvas e consultas salvas clássicas no BigQuery.

Consultas salvas

Este documento fornece uma introdução a consultas salvas no BigQuery. Você pode usar as consultas salvas para criar e gerenciar scripts SQL. As consultas salvas melhoram a colaboração e o gerenciamento de consultas com as seguintes opções:

  • Compartilhe consultas com usuários e grupos específicos usando o Identity and Access Management (IAM).
  • Revise o histórico de versões da consulta.
  • Reverter ou ramificar de versões anteriores da consulta.

As consultas salvas salvam tanto o texto da consulta quanto as configurações da consulta.

As consultas salvas são recursos de código do BigQuery Studio com tecnologia do Dataform. Os Notebooks também são recursos de código. Todos os recursos de código são armazenados em uma região padrão. A atualização da região padrão altera a região de todos os recursos de código criados depois desse ponto.

Os recursos de consulta salva só estão disponíveis no console do Google Cloud.

Segurança de consultas salvas

Para controlar o acesso a consultas salvas, use os papéis do Identity and Access Management (IAM). Para mais informações, consulte Conceder acesso a consultas salvas.

Regiões compatíveis

O BigQuery Studio permite salvar, compartilhar e gerenciar consultas salvas. A tabela a seguir lista as regiões em que o BigQuery Studio está disponível:

Descrição da região Nome da região Modelos
de detalhes
América
Iowa us-central1 Ícone de folha Baixo CO2
Oregon us-west1 Ícone de folha Baixo CO2
São Paulo southamerica-east1 Ícone de folha CO2 baixo
Carolina do Sul us-east1
Ásia-Pacífico
Mumbai asia-south1
Singapura asia-southeast1
Taiwan asia-east1
Tóquio asia-northeast1
Europa
Bélgica europe-west1 Ícone de folha CO2 baixo
Frankfurt europe-west3 ícone de folha Baixo CO2
Londres europe-west2 ícone de folha Baixo CO2
Países Baixos europe-west4
Zurique europe-west6 Ícone de folha Baixo CO2

Cotas e limites

Para mais informações, consulte Cotas e limites de consultas salvas.

Consultas salvas clássicas

As consultas salvas clássicas são uma maneira anterior de salvar e compartilhar consultas SQL. As consultas salvas clássicas fornecem o texto de consulta, e a única configuração de consulta mantida por uma consulta salva clássica é a versão SQL. Essa configuração determina se a consulta usa SQL legado ou GoogleSQL. Para consultar os dados, os usuários precisam ter acesso aos dados acessados pela consulta salva. Para mais informações, consulte Conceder acesso a consultas salvas.

Existem três tipos de consultas salvas clássicas:

  • Privado. As consultas salvas clássicas particulares permanecem visíveis apenas para o usuário que as criou. Elas são identificadas com o ícone .
  • Nível do projeto. As consultas salvas para envolvidos no projeto ficam visíveis para os principais com as permissões necessárias. Elas são identificadas com o ícone .
  • Público. Pública: as consultas públicas salvas clássicas são visíveis para qualquer pessoa com o link da consulta. Elas são identificadas com o ícone .

Você pode migrar consultas salvas clássicas em consultas salvas para aproveitar os novos recursos ou continuem a mantê-las como consultas salvas clássicas.

O recurso clássico de consulta salva está disponível apenas no Console do Google Cloud.

Descontinuação das consultas salvas clássicas

Até março de 2025, o recurso de consultas salvas do BigQuery Studio substituirá as consultas salvas clássicas. Para editar consultas salvas clássicas após 2024, é necessário migrar consultas clássicas para consultas salvas.

Se os usuários, incluindo você, tiverem consultas pessoais com informações que não podem ser disponibilizadas para outras pessoas com acesso a dados no projeto, o proprietário da consulta precisará excluir as consultas ou as informações até março. 2025.

Para dar suporte a essa transição, os seguintes papéis do IAM do BigQuery serão atualizados em fevereiro de 2024:

Para permitir que os usuários sem os papéis de Administrador do BigQuery, Usuário de job do BigQuery ou Usuário do BigQuery usem consultas salvas, conceda a eles as permissões necessárias no IAM.

Os papéis personalizados não serão atualizados automaticamente. Para atualizar um papel personalizado com as permissões necessárias, consulte Editar um papel personalizado atual.

A seguir