Introdução às consultas salvas

As consultas salvas permitem criar, gerenciar e compartilhar scripts SQL no BigQuery. As mudanças em uma consulta salva são salvas automaticamente para que você não perca seu trabalho ao fechar o editor de consultas. Os recursos de consulta salva só estão disponíveis no console do Google Cloud .

Sobre as consultas salvas

As consultas salvas melhoram a colaboração e o gerenciamento de consultas com as seguintes opções:

  • Compartilhe consultas salvas 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 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.

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 Compartilhar consultas salvas e Considerações de segurança para consultas salvas.

Regiões compatíveis

Todas as consultas salvas são armazenadas em uma região padrão. A atualização da região padrão altera o local de todas as consultas criadas depois desse ponto. 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 Baixo CO2
Finlândia europe-north1 Ícone de folha CO2 baixo
Frankfurt europe-west3
Londres europe-west2 ícone de folha Baixo CO2
Madri europe-southwest1 Ícone de folha Baixo CO2
Milão europe-west8 ícone de folha Baixo CO2
Países Baixos europe-west4 Ícone de folha Baixo CO2
Turim europe-west12 ícone de folha Baixo CO2
Varsóvia europe-central2 ícone de folha Baixo CO2
Zurique europe-west6 Ícone de folha Baixo CO2
Oriente Médio
Damã me-central2
Doha me-central1
Tel Aviv me-west1

Cotas e limites

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

Limitações

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

Consultas salvas clássicas (descontinuadas)

Para editar consultas salvas clássicas depois que elas forem totalmente descontinuadas, é necessário migrá-las para o BigQuery Studio.

As consultas salvas clássicas são um método mais antigo de salvar e compartilhar SQL. Ao contrário das consultas salvas do BigQuery Studio, elas retêm apenas o texto da consulta e a versão do SQL (SQL legado ou GoogleSQL).

No console do Google Cloud , elas aparecem na pasta Consultas(clássicas) no painel Explorer. Se você não tiver ativado o BigQuery Studio, elas vão aparecer na pasta Consultas salvas (NUMBER) no painel Análises clássicas.

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

  • Pessoal (): visível apenas para o usuário que o criou.

    • Observação: se uma consulta pessoal tiver informações sensíveis, exclua a consulta ou remova os dados sensíveis antes da migração.

  • No projeto (): visível para qualquer principal com as permissões necessárias.

  • Público (): visível para qualquer pessoa que tenha o link para a consulta.

Papéis do IAM para migração e acesso

Os seguintes papéis predefinidos do IAM do BigQuery incluem as permissões do Dataform necessárias para ajudar na transição para as consultas salvas do BigQuery Studio:

Se você não tiver um desses papéis predefinidos, solicite as permissões necessárias. Os papéis personalizados não são atualizados automaticamente e precisam ser editados manualmente.

A seguir