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 Detalhes
África
Johannesburgo africa-south1
América
Columbus us-east5
Dallas us-south1 Ícone de folha Baixo CO2
Iowa us-central1 Ícone de folha Baixo CO2
Los Angeles us-west2
Las Vegas us-west4
Montreal northamerica-northeast1 Ícone de folha Baixo CO2
N. Virgínia us-east4
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
Hong Kong asia-east2
Jacarta asia-southeast2
Mumbai asia-south1
Seul asia-northeast3
Singapura asia-southeast1
Sydney australia-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
Madri europe-southwest1 Ícone de folha Baixo CO2
Países Baixos europe-west4 Ícone de folha Baixo CO2
Turim europe-west12
Zurique europe-west6 Ícone de folha Baixo CO2
Oriente Médio
Doha me-central1
Dammam me-central2

Cotas e limites

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

Limitações

As consultas salvas têm as seguintes limitações:

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:

  • Pessoal. 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 do BigQuery Studio.

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 foram 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