Introdução às consultas guardadas

Este documento apresenta uma introdução às consultas guardadas no BigQuery. Pode usar consultas guardadas para criar e gerir scripts SQL. As alterações a uma consulta guardada são guardadas automaticamente para que não perca o seu trabalho quando fecha o editor de consultas. As consultas guardadas melhoram a colaboração e a gestão de consultas com as seguintes opções:

  • Partilhe consultas guardadas com utilizadores e grupos específicos através da gestão de identidade e de acesso (IAM).
  • Reveja o histórico de versões da consulta.
  • Reverter ou criar ramificações a partir de versões anteriores da consulta.

As consultas guardadas são recursos de código do BigQuery Studio com tecnologia Dataform. Os blocos de notas também são recursos de código. Todos os recursos de código são armazenados numa região predefinida. A atualização da região predefinida altera a região de todos os recursos de código criados a partir desse momento.

As capacidades de consulta guardada só estão disponíveis na Google Cloud consola.

Segurança da consulta guardada

Controla o acesso às consultas guardadas através de funções da gestão de identidade e de acesso (IAM). Para mais informações, consulte o artigo Partilhe consultas guardadas.

Regiões suportadas

O BigQuery Studio permite-lhe guardar, partilhar e gerir consultas guardadas. A tabela seguinte apresenta as regiões onde o BigQuery Studio está disponível:

Descrição da região Nome da região Detalhes
África
Joanesburgo africa-south1
Americas
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
Montréal northamerica-northeast1 ícone de folha Baixo CO2
Virgínia do Virgínia us-east4
Oregon us-west1 ícone de folha Baixo CO2
São Paulo southamerica-east1 ícone de folha Baixo CO2
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
Frankfurt europe-west3
Londres europe-west2 ícone de folha Baixo CO2
Madrid 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
Médio Oriente
Doha me-central1
Damã me-central2

Quotas e limites

Para mais informações, consulte o artigo Quotas e limites de consultas guardadas.

Limitações

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

Consultas guardadas clássicas

As consultas guardadas clássicas são uma forma anterior de guardar e partilhar consultas SQL. As consultas guardadas clássicas fornecem o texto da consulta e a única definição de consulta retida por uma consulta guardada clássica é a versão SQL. Esta definição determina se a consulta usa o SQL antigo ou o GoogleSQL. Para consultar os dados, os utilizadores têm de ter acesso aos dados aos quais a consulta guardada acede.

Pode ver as consultas guardadas clássicas na pasta Consultas(clássicas) do painel Explorador:

A pasta Consultas (clássicas) no painel do explorador.

Existem 3 tipos de consultas guardadas clássicas:

  • Pessoal. As consultas guardadas clássicas pessoais só são visíveis para o utilizador que as cria. São identificados com o ícone .
  • Ao nível do projeto. As consultas guardadas ao nível do projeto são visíveis para os diretores que têm as autorizações necessárias. São identificados com o ícone .
  • Público. As consultas guardadas clássicas públicas são visíveis para qualquer pessoa com um link para a consulta. São identificados com o ícone .

Pode migrate as consultas guardadas clássicas para consultas guardadas para tirar partido das novas capacidades ou continuar a mantê-las como consultas guardadas clássicas até à descontinuação. A linha cronológica da descontinuação está a ser revista.

A funcionalidade de consulta guardada clássica só está disponível na Google Cloud consola.

Descontinuação das consultas guardadas clássicas

A funcionalidade de consultas guardadas do BigQuery Studio vai substituir as consultas guardadas clássicas. A linha cronológica da descontinuação está a ser revista. Para editar consultas guardadas clássicas existentes após a descontinuação, tem de migrar as consultas clássicas para consultas guardadas do BigQuery Studio.

Se os utilizadores, incluindo si, tiverem consultas pessoais com informações que não devem ser disponibilizadas a outras pessoas com acesso aos dados no projeto, o proprietário da consulta tem de eliminar as consultas ou as informações antes de concluir a migração.

Para suportar esta transição, as seguintes funções do IAM do BigQuery foram atualizadas em fevereiro de 2024:

Para permitir que os utilizadores sem as funções de administrador do BigQuery, utilizador da tarefa do BigQuery ou utilizador do BigQuery usem consultas guardadas, conceda-lhes as autorizações necessárias no IAM.

As funções personalizadas não são atualizadas automaticamente. Para atualizar uma função personalizada com as autorizações necessárias, consulte o artigo Edite uma função personalizada existente.

O que se segue?