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`	Baixo CO₂
	Iowa	`us-central1`	Baixo CO₂
	Los Angeles	`us-west2`
	Las Vegas	`us-west4`
	Montreal	`northamerica-northeast1`	Baixo CO₂
	N. Virgínia	`us-east4`
	Oregon	`us-west1`	Baixo CO₂
	São Paulo	`southamerica-east1`	CO₂ 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`	CO₂ baixo
	Frankfurt	`europe-west3`	Baixo CO₂
	Londres	`europe-west2`	Baixo CO₂
	Madri	`europe-southwest1`	Baixo CO₂
	Países Baixos	`europe-west4`	Baixo CO₂
	Turim	`europe-west12`
	Zurique	`europe-west6`	Baixo CO₂
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:

É 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 seu projeto do Google Cloud tiver mais de 2.500 consultas salvas clássicas, não será possível usar a migração em lote (pré-lançamento) para migrar consultas salvas clássicas para 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:

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:

O Administrador do BigQuery (roles/bigquery.admin) vai receber as permissões Administrador do Dataform (roles/dataform.admin).
O usuário de jobs do BigQuery (roles/bigquery.jobUser) receberá as seguintes permissões:
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list
O usuário do BigQuery (roles/bigquery.user) vai receber as seguintes permissões:
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list

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

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