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	CO2 bajo
	Iowa	us-central1	CO2 bajo
	Los Ángeles	us-west2
	Las Vegas	us-west4
	Montreal	northamerica-northeast1	CO2 bajo
	N. Virginia	us-east4
	Oregón	us-west1	CO2 bajo
	São Paulo	southamerica-east1	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	CO2 bajo
	Fráncfort	europe-west3	CO2 bajo
	Londres	europe-west2	CO2 bajo
	Madrid	europe-southwest1	CO2 bajo
	Países Bajos	europe-west4	CO2 bajo
	Turín	europe-west12
	Zúrich	europe-west6	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:

• Puedes otorgar acceso público a las consultas guardadas solo a la principal allAuthenticatedUsers. No puedes otorgar acceso a las consultas guardadas a la principal allUsers.
• Si tu proyecto de Google Cloud contiene más de 2,500 consultas guardadas clásicas, no puedes usar la migración por lotes (Versión preliminar) para migrar las consultas guardadas clásicas a las consultas guardadas.

Consultas guardadas clásicas

Obsoleto: las consultas guardadas, disponibles en la vista previa de BigQuery Studio, reemplazarán por completo las consultas guardadas clásicas antes de marzo de 2025. Para obtener más información, consulta Baja de las consultas guardadas clásicas. Para obtener información sobre cómo migrar a las consultas guardadas, consulta Migra 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.

Nota: Si no habilitaste BigQuery Studio, las consultas guardadas clásicas aparecerán en la carpeta Consultas guardadas (NUMBER) del panel Explorador en lugar de la carpeta Consultas (clásicas).

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 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

En 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 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 marzo de 2025.

Para respaldar esta transición, se actualizaron los siguientes roles de IAM de BigQuery en febrero de 2024:

• Administrador de BigQuery (roles/bigquery.admin) obtendrá permisos de Administrador de Dataform (roles/dataform.admin).

• El usuario del trabajo de BigQuery (roles/bigquery.jobUser) obtendrá los siguientes permisos:

  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list

• Usuario de BigQuery (roles/bigquery.user) obtendrá los siguientes permisos:

  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list

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?

• Para obtener información sobre cómo crear consultas guardadas, consulta Crea consultas guardadas.
• Si deseas obtener información para administrar consultas guardadas, consulta Cómo administrar consultas guardadas.