Es posible que parte de la información de esta página (o toda) no se aplique a Cloud de Confiance de S3NS. Consulta Diferencias con Google Cloud para obtener más información.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Introducción a las consultas guardadas

Las consultas guardadas te permiten crear, administrar y compartir secuencias de comandos de SQL en BigQuery. Los cambios en una consulta guardada se guardan automáticamente para que no pierdas tu trabajo cuando cierres el editor de consultas. Las funciones de consultas guardadas solo están disponibles en la consola de Cloud de Confiance .

Acerca de las consultas guardadas

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.

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`	CO₂ bajo
	Iowa	`us-central1`	CO₂ bajo
	Los Ángeles	`us-west2`
	Las Vegas	`us-west4`
	Montreal	`northamerica-northeast1`	CO₂ bajo
	N. Virginia	`us-east4`
	Oregón	`us-west1`	CO₂ bajo
	São Paulo	`southamerica-east1`	CO₂ 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`	CO₂ bajo
	Finlandia	`europe-north1`	CO₂ bajo
	Fráncfort	`europe-west3`
	Londres	`europe-west2`	CO₂ bajo
	Madrid	`europe-southwest1`	CO₂ bajo
	Milán	`europe-west8`	CO₂ bajo
	Países Bajos	`europe-west4`	CO₂ bajo
	Turín	`europe-west12`	CO₂ bajo
	Varsovia	`europe-central2`	CO₂ bajo
	Zúrich	`europe-west6`	CO₂ 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 Cloud de Confiance 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)

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 Cloud de Confiance , 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.