Introducción a las 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. Los cambios en una búsqueda guardada se guardan automáticamente para que no pierdas tu trabajo cuando cierres el editor de búsquedas. Las consultas guardadas mejoran la colaboración y la administración de consultas con las siguientes opciones:

  • Comparte consultas guardadas 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 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 Google Cloud consola.

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 Cómo compartir 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
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.

Limitaciones

Las consultas guardadas tienen las siguientes limitaciones:

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.

Puedes ver las consultas guardadas clásicas en la carpeta Consultas(clásicas) del panel Explorador clásico:

La carpeta Consultas (clásicas) en el panel Explorador

Hay 3 tipos de consultas guardadas clásicas:

  • Personales. Las consultas guardadas clásicas personales 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 migrate las consultas guardadas clásicas a consultas guardadas para aprovechar las capacidades nuevas, o mantenerlas como consultas clásicas guardadas hasta su baja. Se está revisando el cronograma de la baja.

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

Baja de las consultas guardadas clásicas

La función de consultas guardadas de BigQuery Studio reemplazará las consultas guardadas clásicas. Se está revisando el cronograma de baja. Para editar las consultas guardadas clásicas existentes después de la baja, debes migrar las consultas clásicas a las consultas guardadas de BigQuery Studio.

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 completar la migración.

Para respaldar esta transición, se actualizaron los siguientes roles de IAM de BigQuery 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 automáticamente. Para actualizar un rol personalizado con los permisos requeridos, consulta Edita un rol personalizado existente.

¿Qué sigue?