Introdução às consultas salvas

Use consultas salvas no BigQuery para armazenar, gerenciar e colaborar com segurança nos scripts SQL. Enquanto você trabalha no editor de consultas, as alterações são salvas automaticamente para evitar a perda acidental do trabalho.

Como as consultas salvas são recursos de código do BigQuery Studio com tecnologia do Dataform, elas oferecem recursos avançados de colaboração e controle de versões. Você pode:

• Colabore com segurança:compartilhe consultas salvas com usuários e grupos específicos usando o Identity and Access Management (IAM).
• Acompanhar mudanças:confira um histórico de versões detalhado das edições do editor de consultas.
• Gerenciar versões:ramifique ou reverta para versões anteriores de uma consulta para testar modificações com segurança.

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

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	Baixo CO2
	Iowa	us-central1	Baixo CO2
	Los Angeles	us-west2
	Las Vegas	us-west4
	Montreal	northamerica-northeast1	Baixo CO2
	N. Virgínia	us-east4
	Oregon	us-west1	Baixo CO2
	São Paulo	southamerica-east1	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	Baixo CO2
	Finlândia	europe-north1	CO2 baixo
	Frankfurt	europe-west3
	Londres	europe-west2	Baixo CO2
	Madri	europe-southwest1	Baixo CO2
	Milão	europe-west8	Baixo CO2
	Países Baixos	europe-west4	Baixo CO2
	Turim	europe-west12	Baixo CO2
	Varsóvia	europe-central2	Baixo CO2
	Zurique	europe-west6	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:

• É possível conceder acesso público a consultas salvas somente ao allAuthenticatedUsers principal. Não é possível conceder acesso a consultas salvas ao principal allUsers.
• Se o projeto do Cloud de Confiance tiver mais de 2.500 consultas salvas clássicas, não será possível usar a migração em lote para migrar consultas salvas clássicas para consultas salvas.

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 Cloud de Confiance , 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 (person): 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 (people): visível para qualquer principal com as permissões necessárias.

• Público (share): 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:

• Administrador do BigQuery (roles/bigquery.admin) inclui permissões de roles/dataform.admin.
• Usuário de jobs do BigQuery (roles/bigquery.jobUser) e Usuário do BigQuery (roles/bigquery.user) incluem:
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list

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

• Para saber como criar consultas salvas, consulte Criar consultas salvas.
• Para saber como gerenciar consultas salvas, consulte Gerenciar consultas salvas.