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.
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:
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.getdataform.locations.listdataform.repositories.createdataform.repositories.list
Usuario de BigQuery (
roles/bigquery.user) obtendrá los siguientes permisos:dataform.locations.getdataform.locations.listdataform.repositories.createdataform.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?
- Obtén información para crear consultas guardadas.
- Obtén información para administrar consultas guardadas.