Introducción a las consultas guardadas

En este documento, se proporciona una introducción a las consultas guardadas y las consultas guardadas clásicas en BigQuery.

Consultas guardadas

En este documento, se proporciona una introducción a las consultas guardadas en BigQuery. Puedes usar consultas guardadas para crear y administrar secuencias de comandos de SQL. Las consultas guardadas mejoran la colaboración y la administración de consultas con las siguientes opciones:

  • Comparte consultas con usuarios y grupos específicos usando Identity and Access Management (IAM).
  • Revisa el historial de versiones de consultas.
  • Revierte o bifurca desde versiones anteriores de la consulta.

Las consultas guardadas guardan el texto y la configuración de la consulta.

Las consultas guardadas son elementos de código de BigQuery Studio con tecnología de Dataform. Los notebooks también son elementos de código. Todos los elementos de código se almacenan en una región predeterminada. La actualización de la región predeterminada cambia la región de todos los elementos de código creados después de ese punto.

Las funciones de consultas guardadas solo están disponibles en la consola de Google Cloud.

Seguridad de consultas guardadas

Puedes controlar el acceso a las consultas guardadas usando los roles de Identity and Access Management (IAM). Para obtener más información, consulta Otorga acceso a las consultas guardadas.

Regiones admitidas

BigQuery Studio te permite guardar, compartir y administrar consultas guardadas. En la siguiente tabla, se enumeran las regiones en las que BigQuery Studio está disponible:

Descripción de la región Nombre de la región Detalles
África
Johannesburgo africa-south1
América
Columbus us-east5
Dallas us-south1 ícono de hoja CO2 bajo
Iowa us-central1 ícono de hoja CO2 bajo
Los Ángeles us-west2
Las Vegas us-west4
Montreal northamerica-northeast1 ícono de hoja CO2 bajo
N. Virginia us-east4
Oregón us-west1 ícono de hoja CO2 bajo
São Paulo southamerica-east1 ícono de hoja CO2 bajo
Carolina del Sur us-east1
Asia-Pacífico
Hong Kong asia-east2
Yakarta asia-southeast2
Bombay asia-south1
Seúl asia-northeast3
Singapur asia-southeast1
Sídney australia-southeast1
Taiwán asia-east1
Tokio asia-northeast1
Europa
Bélgica europe-west1 ícono de hoja CO2 bajo
Fráncfort europe-west3 ícono de hoja CO2 bajo
Londres europe-west2 ícono de hoja CO2 bajo
Madrid europe-southwest1 ícono de hoja CO2 bajo
Países Bajos europe-west4 ícono de hoja CO2 bajo
Turín europe-west12
Zúrich europe-west6 ícono de hoja CO2 bajo
Oriente Medio
Doha me-central1
Dammam me-central2

Cuotas y límites

Para obtener más información, consulta Cuotas y límites de las consultas guardadas.

Consultas guardadas clásicas

Las consultas guardadas clásicas son una forma anterior de guardar y compartir consultas en SQL. Las consultas guardadas clásicas proporcionan el texto de la consulta, y el único parámetro de configuración de consulta retenido por una consulta guardada clásica es la versión de SQL. Este parámetro de configuración rige si la consulta usa SQL heredado o GoogleSQL. Para consultar los datos, los usuarios deben tener acceso a los datos a los que accede la consulta guardada. Para obtener más información, consulta Otorga acceso a las consultas guardadas.

Hay 3 tipos de consultas guardadas clásicas:

  • Privadas. Las consultas guardadas clásicas privadas son visibles solo para el usuario que las crea. Se identifican con el ícono .
  • Nivel de proyecto. Las consultas guardadas a nivel de proyecto son visibles para las principales que tienen los permisos necesarios. Se identifican con el ícono .
  • Públicas. Las consultas guardadas clásicas públicas son visibles para cualquier persona que tenga un vínculo a la consulta. Se identifican con el ícono .

Puedes migrar las consultas guardadas clásicas a consultas guardadas para aprovechar las capacidades nuevas, o mantenerlas como consultas clásicas guardadas hasta 2025.

La función de consulta guardada clásica solo está disponible en la consola de Google Cloud.

Baja de las consultas guardadas clásicas

Para marzo de 2025, la función de consultas guardadas de BigQuery Studio reemplazará las consultas guardadas clásicas. Para editar las consultas guardadas clásicas existentes después de 2024, debes migrar las consultas clásicas a consultas guardadas.

Si los usuarios, incluido tú, tienen consultas personales con información que no debería estar disponible para otros con acceso a los datos del proyecto, el propietario de la consulta debe borrar las consultas o la información antes de marzo de 2025.

Para admitir esta transición, los siguientes roles de IAM de BigQuery se actualizarán en febrero de 2024:

Para permitir que los usuarios que no tienen los roles de Administrador de BigQuery, Usuario de trabajo de BigQuery o Usuario de BigQuery usen consultas guardadas, otórgales los permisos necesarios en IAM.

Los roles personalizados no se actualizarán de forma automática. Para actualizar un rol personalizado con los permisos necesarios, consulta Edita un rol personalizado existente.

¿Qué sigue?