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 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 |
CO2 baixo | |
Frankfurt | europe-west3 |
Baixo CO2 | |
Londres | europe-west2 |
Baixo CO2 | |
Madri | europe-southwest1 |
Baixo CO2 | |
Países Baixos | europe-west4 |
Baixo CO2 | |
Turim | europe-west12 |
||
Zurique | europe-west6 |
Baixo CO2 | |
Oriente Médio | |||
Doha | me-central1 |
||
Damã | 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 principalallUsers
. - 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.