Administrar consultas guardadas

En este documento, se describe cómo administrar consultas guardadas y consultas guardadas clásicas.

Consultas guardadas

Usa las siguientes secciones para aprender a administrar consultas guardadas. Las consultas guardadas son elementos de código de BigQuery Studio con tecnología de Dataform.

Importante: En marzo de 2024, las APIs compatibles con las funciones de BigQuery Studio se habilitaron automáticamente para todos los proyectos de BigQuery existentes. Los proyectos de BigQuery nuevos tienen estas APIs habilitadas de forma predeterminada. Para obtener más información, consulta Habilitación automática de las APIs de BigQuery Studio.

Permisos necesarios

Para administrar consultas guardadas, necesitas los siguientes roles de Identity and Access Management (IAM):

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
• Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)
• Propietario del código (roles/dataform.codeOwner)

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Otorga acceso a las consultas guardadas

Para otorgar acceso a una consulta guardada a otros usuarios, agrégalos a un rol de IAM adecuado.

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Busca la consulta guardada a la que deseas otorgar acceso.

3. Haz clic en Ver acciones junto a la consulta guardada y, luego, en Compartir > Administrar permisos.

4. En el panel Administrar permisos, haz clic en Agregar usuario o grupo.

5. En el campo Principales nuevas, ingresa una principal.

6. En la lista Rol, selecciona uno de los siguientes roles:

   • Propietario del código: puede realizar cualquier acción en la consulta guardada, como borrarla o compartirla.
   • Editor de código: puede editar la consulta.
   • Visualizador de código: puede ver la consulta.
   Nota: La principal también debe tener el rol Usuario de BigQuery (roles/bigquery.user) para ejecutar la consulta guardada.

7. Opcional: Para ver una lista completa de las funciones y la configuración de uso compartido avanzada, haz clic en Uso compartido avanzado.

8. Haz clic en Guardar.

9. Para volver a la información de la consulta guardada, haz clic en Cerrar.

Comparte consultas guardadas

Puedes compartir una consulta guardada con otros usuarios generando y compartiendo un vínculo a la consulta guardada. Para que los usuarios puedan ver la consulta guardada que compartiste, primero debes otorgarles acceso a ella.

Para ejecutar una consulta compartida, los usuarios deben tener acceso a los datos a los que accede la consulta. Para obtener más información, consulta Otorga acceso a un conjunto de datos.

Si planeas compartir una consulta guardada, considera incluir un comentario en la consulta que describa su propósito.

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, expande la carpeta Consultas compartidas. Busca la consulta guardada que deseas compartir.

3. Haz clic en Ver acciones junto a la consulta y, luego, en Compartir > Copiar vínculo.

4. Comparte el vínculo con otros usuarios.

Visualiza todas las consultas guardadas

Para ver una lista de todas las consultas guardadas en tu proyecto, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, haz clic en Ver acciones junto a Consultas y, luego, realiza una de las siguientes acciones:

• Para abrir la lista en la pestaña actual, haz clic en Mostrar todo.
• Para abrir la lista en una pestaña nueva, haz clic en Mostrar todo en > Nueva pestaña.
• Para abrir la lista en una pestaña dividida, haz clic en Mostrar todo en > Dividir pestaña.

Visualiza los metadatos de consultas guardadas

Para ver los metadatos de la consulta guardada, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Haz clic en el nombre de la consulta guardada de la que deseas ver los metadatos.

3. Mira el panel Resumen para ver información sobre la consulta guardada, como la región que usa y la fecha en la que se modificó por última vez.

Trabaja con versiones de consultas guardadas

Usa las siguientes secciones para aprender a ver, comparar y restablecer versiones de una consulta guardada.

Visualiza versiones de consultas guardadas

Para ver las versiones de las consultas guardadas, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Haz clic en el nombre de la consulta guardada de la que deseas ver la actividad.

3. Haz clic en la pestaña Actividad para ver una lista de las versiones de consultas guardadas en orden descendente por fecha.

Compara versiones de consultas guardadas

Para comparar las versiones de las consultas guardadas, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Haz clic en el nombre de la consulta guardada para la que deseas comparar la información de la versión.

3. En la pestaña Actividad, haz clic en Ver acciones junto a la versión de una consulta guardada y, luego, en Comparar. Se abrirá el panel de comparación y se comparará la versión de la consulta guardada que seleccionaste con la versión actual de la consulta guardada.

4. Opcional: Para comparar las versiones intercaladas en lugar de en paneles separados, haz clic en Comparar y, luego, en Intercalado.

Restablece una versión de consulta guardada

Usa una de las siguientes opciones para restablecer una versión de consulta guardada. Restablecer desde el panel de comparación te permite comparar la versión anterior de la consulta guardada con la versión actual antes de decidir si restablecerla.

Panel de actividad

1. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Haz clic en el nombre de la consulta guardada de la que deseas restablecer una versión anterior.
2. Selecciona el panel Actividad.
3. Haz clic en Ver acciones junto a la versión de la consulta guardada que deseas restablecer y, luego, en Restablecer.
4. Haz clic en Confirmar para confirmar la acción.

Panel de comparación

1. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Haz clic en el nombre de la consulta guardada de la que deseas restablecer una versión anterior.
2. Selecciona el panel Actividad.
3. Haz clic en Ver acciones junto a la versión de la consulta guardada y, luego, en Comparar. Se abrirá el panel de comparación y se comparará la versión de la consulta guardada que seleccionaste con la versión más reciente de la consulta guardada.
4. Si deseas restablecer la versión anterior de la consulta guardada después de la comparación, haz clic en Restablecer.
5. Haz clic en Confirmar para confirmar la acción.

Descarga consultas guardadas

Para descargar una consulta guardada, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Haz clic en el nombre de una consulta guardada para abrirla.

3. Haz clic en Descargar.

Borrar las consultas guardadas

Para borrar una consulta guardada, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas y, si es necesario, la carpeta Consultas compartidas. Busca la consulta guardada que deseas borrar.

3. Haz clic en Ver acciones junto a la consulta guardada y, luego, en Borrar.

4. Para confirmar la eliminación, escribe delete en el cuadro de diálogo.

5. Haz clic en Borrar.

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.

Usa las siguientes secciones para aprender a administrar consultas guardadas clásicas.

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

Comparte consultas guardadas clásicas

Puedes compartir consultas guardadas clásicas a las que hayas otorgado visibilidad de proyecto o pública. La visibilidad de proyecto permite que las principales con los permisos necesarios vean, actualicen o borren la consulta. La visibilidad pública permite que cualquier persona con el vínculo de la consulta pueda verla, pero no actualizarla ni borrarla.

Para compartir una consulta guardada clásica con otros usuarios, debes generar y compartir un vínculo a la consulta guardada clásica.

Para ejecutar una consulta compartida clásica, los usuarios deben tener acceso a los datos a los que accede la consulta. Para obtener más información, consulta Otorga acceso a un conjunto de datos.

Si planeas compartir una consulta guardada clásica, considera incluir un comentario en la consulta que describa su propósito.

1. En el panel Explorador, expande tu proyecto y la carpeta Consultas (clásicas) y, luego, busca la consulta guardada clásica que deseas compartir.
2. Haz clic en Ver acciones junto a la consulta y, luego, en Obtener vínculo.
3. Comparte el vínculo con los usuarios a los que deseas otorgarles acceso a la consulta.

Migra consultas guardadas clásicas

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas (clásicas) y, si es necesario, la carpeta Consultas del proyecto.

3. Haz clic en el nombre de una consulta guardada clásica para abrirla.

4. Haz clic en Guardar consulta (clásica) > Guardar consulta como….

5. En el cuadro de diálogo Guardar consulta, escribe un nombre y elige la ubicación para la consulta.

6. Haz clic en Guardar.

Borra consultas guardadas clásicas

1. En la consola de Google Cloud, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Consultas (clásicas) y, si es necesario, la carpeta Consultas del proyecto.

3. Busca la consulta guardada clásica que deseas borrar.

4. Haz clic en Ver acciones junto a la consulta y, luego, en Borrar.

5. Para confirmar la eliminación, escribe delete en el cuadro de diálogo.

6. Haz clic en Borrar.