Introducción a las consultas guardadas

Usa las consultas guardadas en BigQuery para almacenar, administrar y colaborar de forma segura en tus secuencias de comandos de SQL. A medida que trabajas en el editor de consultas, los cambios se guardan automáticamente para evitar la pérdida accidental del trabajo.

Debido a que las consultas guardadas son elementos de código de BigQuery Studio con tecnología de Dataform, ofrecen funciones avanzadas de colaboración y control de versión. Puedes hacer lo siguiente:

• Colabora de forma segura: Comparte consultas guardadas con usuarios y grupos específicos usando Identity and Access Management (IAM).
• Seguimiento de cambios: Revisa un historial de versiones detallado de las ediciones de tu editor de consultas.
• Administra versiones: Crea ramas o revierte a versiones anteriores de una consulta para probar las modificaciones de forma segura.

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 Comparte consultas guardadas y Consideraciones de seguridad para las consultas guardadas.

Regiones admitidas

Todas las consultas guardadas se almacenan en una región predeterminada. La actualización de la región predeterminada cambia la ubicación de las consultas creadas después de ese punto. 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
	Finlandia	europe-north1	CO2 bajo
	Fráncfort	europe-west3
	Londres	europe-west2	CO2 bajo
	Madrid	europe-southwest1	CO2 bajo
	Milán	europe-west8	CO2 bajo
	Países Bajos	europe-west4	CO2 bajo
	Turín	europe-west12	CO2 bajo
	Varsovia	europe-central2	CO2 bajo
	Zúrich	europe-west6	CO2 bajo
Oriente Medio
	Dammam	me-central2
	Doha	me-central1
	Tel Aviv	me-west1

Cuotas y límites

Para obtener más información, consulta las cuotas y los 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 para migrar las consultas guardadas clásicas a las consultas guardadas.

Consultas guardadas clásicas (obsoletas)

Obsoleto: Las consultas guardadas, disponibles en BigQuery Studio, reemplazarán por completo las consultas guardadas clásicas en el futuro. Se está revisando el cronograma de baja. 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.

Para editar las consultas guardadas clásicas existentes después de que dejen de estar disponibles por completo, debes migrarlas a BigQuery Studio.

Las consultas guardadas clásicas son un método más antiguo para guardar y compartir SQL. A diferencia de las consultas guardadas de BigQuery Studio, solo retienen el texto de la consulta y la versión de SQL (SQL heredado o GoogleSQL).

En la consola de Google Cloud , aparecen en la carpeta Consultas(clásicas) dentro del panel Explorador. (Si no habilitaste BigQuery Studio, aparecerán en la carpeta Consultas guardadas (NUMBER) en el panel Explorador clásico).

Hay tres tipos de consultas guardadas clásicas:

• Personal (): Solo es visible para el usuario que la creó.

  • Nota: Si una consulta personal contiene información sensible, debes borrarla o quitar los datos sensibles antes de la migración.

• A nivel de proyecto (): visible para cualquier principal con los permisos necesarios.

• Público (): Visible para cualquier persona que tenga el vínculo a la consulta.

Roles de IAM para la migración y el acceso

Los siguientes roles predefinidos de IAM de BigQuery incluyen los permisos de Dataform necesarios para ayudarte a realizar la transición a las consultas guardadas de BigQuery Studio:

• Administrador de BigQuery (roles/bigquery.admin) incluye permisos de roles/dataform.admin.
• Usuario de trabajo de BigQuery (roles/bigquery.jobUser) y Usuario de BigQuery (roles/bigquery.user) incluyen lo siguiente:
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list

Si no tienes uno de estos roles predefinidos, solicita los permisos necesarios. Los roles personalizados no se actualizan automáticamente y se deben editar de forma manual.

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