Introducción a las consultas guardadas
En este documento se presenta una introducción a las consultas guardadas en BigQuery. Puedes usar consultas guardadas para crear y gestionar secuencias de comandos SQL. Los cambios que hagas en una consulta guardada se guardarán automáticamente para que no pierdas tu trabajo cuando cierres el editor de consultas. Las consultas guardadas mejoran la colaboración y la gestión de consultas con las siguientes opciones:
- Comparte consultas guardadas con usuarios y grupos específicos mediante la gestión de identidades y accesos (IAM).
- Revisa el historial de versiones de la consulta.
- Volver a versiones anteriores de la consulta o crear una rama a partir de ellas.
Las consultas guardadas son recursos de código de BigQuery Studio con la tecnología de Dataform. Los cuadernos también son recursos de código. Todos los recursos de código se almacenan en una región predeterminada. Si actualiza la región predeterminada, se cambiará la región de todos los recursos de código creados a partir de ese momento.
Las funciones de consultas guardadas solo están disponibles en la Google Cloud consola.
Seguridad de las consultas guardadas
Puedes controlar el acceso a las consultas guardadas mediante roles de Gestión de Identidades y Accesos (IAM). Para obtener más información, consulta Compartir consultas guardadas.
Regiones disponibles
BigQuery Studio te permite guardar, compartir y gestionar consultas guardadas. En la siguiente tabla se indican las regiones en las que está disponible BigQuery Studio:
Descripción de la región | Nombre de la región | Detalles | |
---|---|---|---|
África | |||
Johannesburgo | africa-south1 |
||
América | |||
Columbus | us-east5 |
||
Dallas | us-south1 |
|
|
Iowa | us-central1 |
|
|
Los Ángeles | us-west2 |
||
Las Vegas | us-west4 |
||
Montreal | northamerica-northeast1 |
|
|
Norte de Virginia | us-east4 |
||
Oregón | us-west1 |
|
|
São Paulo | southamerica-east1 |
|
|
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 |
|
|
Fráncfort | europe-west3 |
||
Londres | europe-west2 |
|
|
Madrid | europe-southwest1 |
|
|
Países Bajos | europe-west4 |
|
|
Turín | europe-west12 |
||
Zúrich | europe-west6 |
|
|
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:
- Solo puedes conceder acceso público a las consultas guardadas al principal
allAuthenticatedUsers
. No puedes conceder acceso a consultas guardadas a la entidadallUsers
. - Si tu Google Cloud proyecto contiene más de 2500 consultas guardadas clásicas, no puedes usar la migración por lotes para migrar consultas guardadas clásicas a consultas guardadas.
Consultas guardadas clásicas
Las consultas guardadas clásicas son una forma anterior de guardar y compartir consultas de SQL. Las consultas guardadas clásicas proporcionan el texto de la consulta y la única configuración de consulta que conservan es la versión de SQL. Este ajuste determina si la consulta usa el lenguaje SQL antiguo 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:
Hay tres tipos de consultas guardadas clásicas:
- Personal. Las consultas guardadas clásicas personales solo las puede ver el usuario que las crea. Se identifican con el icono .
- A nivel de proyecto. Las consultas guardadas a nivel de proyecto son visibles para las entidades que tienen los permisos necesarios. Se identifican con el icono .
- Público Las consultas guardadas clásicas públicas son visibles para cualquier persona que tenga un enlace a la consulta. Se identifican con el icono .
Puedes migrate las consultas guardadas clásicas a consultas guardadas para aprovechar las nuevas funciones o seguir manteniéndolas como consultas guardadas clásicas hasta que se retiren. El calendario de desactivación se está revisando.
La función de consulta guardada clásica solo está disponible en laGoogle Cloud consola.
Desactivación de las consultas guardadas clásicas
La función de consultas guardadas de BigQuery Studio sustituirá a las consultas guardadas clásicas. Estamos revisando el calendario de desactivación. Para editar las consultas clásicas guardadas después de la discontinuación, 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 usuarios con acceso a los datos del proyecto, el propietario de la consulta debe eliminar las consultas o la información antes de completar la migración.
Para facilitar esta transición, en febrero del 2024 se actualizaron los siguientes roles de gestión de identidades y accesos de BigQuery:
Administrador de BigQuery (
roles/bigquery.admin
) obtendrá los permisos de Administrador de Dataform (roles/dataform.admin
).Usuario de tareas 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 tengan los roles Administrador de BigQuery, Usuario de tareas de BigQuery o Usuario de BigQuery usen consultas guardadas, concédeles los permisos necesarios en Gestión de identidades y accesos.
Los roles personalizados no se actualizarán automáticamente. Para actualizar un rol personalizado con los permisos necesarios, consulta Editar un rol personalizado.
Siguientes pasos
- Para saber cómo crear consultas guardadas, consulta el artículo Crear consultas guardadas.
- Para saber cómo gestionar las consultas guardadas, consulta Gestionar consultas guardadas.