Crea consultas guardadas

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

Consultas guardadas

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

Si deseas obtener más información para borrar las consultas guardadas y administrar el historial de consultas guardadas, lee la sección Consultas guardadas.

Habilita BigQuery Studio

Sigue las instrucciones en Habilita BigQuery Studio para la administración de elementos para guardar, compartir y administrar versiones de recursos de código, como las consultas guardadas.

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

Configura los permisos adecuados para crear, editar o ver consultas guardadas.

Todos los usuarios con el rol Administrador de Dataform (roles/dataform.admin) tienen acceso de propietario a todas las consultas guardadas creadas en el proyecto.

Para obtener más información sobre Identity and Access Management (IAM) de BigQuery, consulta Control de acceso con IAM.

Permisos para crear consultas guardadas

Para crear y ejecutar consultas guardadas, necesitas los siguientes permisos de IAM:

• dataform.locations.get
• dataform.locations.list
• dataform.repositories.list

• dataform.repositories.create

  Nota: Los usuarios que tienen el permiso dataform.repositories.create pueden ejecutar el código mediante la cuenta de servicio predeterminada de Dataform y todos los permisos otorgados a esa cuenta de servicio. Si deseas obtener más información, consulta Consideraciones de seguridad para los permisos de Dataform.

Puedes obtener estos permisos desde los siguientes roles de IAM:

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
• Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)

• Creador de código (roles/dataform.codeCreator)

  Nota: Los usuarios con el rol Creador de código en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

Permisos para editar las consultas guardadas

Para editar y ejecutar consultas guardadas, necesitas los siguientes roles de IAM:

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

Permisos para ver las consultas guardadas

Para ver y editar consultas guardadas, necesitas los siguientes roles de IAM:

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

Configura la región predeterminada para los elementos de código

Si es la primera vez que creas un elemento de código, configura la región predeterminada para los elementos de código. No puedes cambiar la región de un elemento de código después de crearla.

Nota: Si creas una consulta guardada y eliges una región predeterminada diferente de la que usaste para los elementos de código (por ejemplo, si eliges us-west1, pero antes estuviste usando us-central1), la consulta y todos los elementos de código que crees posteriormente usarán esa nueva región de forma predeterminada. Los elementos de código existentes continúan usando la región a la que se asignaron cuando se crearon.

Crea consultas guardadas

Para crear una consulta guardada, sigue estos pasos:

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

   Ir a BigQuery

2. Haz clic en Redactar una nueva consulta.

3. En el Editor de consultas, ingresa una consulta de SQL válida. Por ejemplo, puedes consultar un conjunto de datos públicos:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;
   

4. Haz clic en Guardar consulta > Guardar consulta.

5. En el cuadro de diálogo Guardar consulta, escribe un nombre para la consulta guardada.

6. Opcional: Para cambiar la región que usa esta consulta guardada y todos los demás elementos de código en el futuro, selecciona una región nueva en Región.

7. Haz clic en Guardar.

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.

Abre una versión de consulta guardada como una consulta nueva

Para abrir cualquier versión de una consulta guardada existente como una consulta nueva, 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. Selecciona una consulta guardada.

3. Selecciona el panel Actividad.

4. Haz clic en Ver acciones junto a una versión de consulta guardada y, luego, en Abrir como consulta nueva.

Actualiza las consultas guardadas

Si actualizas una consulta guardada, puedes guardar los cambios en una versión nueva de la consulta.

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. Modifica la consulta.

4. Para guardar la consulta modificada, haz clic en Guardar consulta > Guardar consulta.

   Se crea una versión nueva de la consulta, que puedes ver en el panel Actividad.

Subir consultas guardadas

Puedes subir una consulta en SQL local para usarla como una consulta guardada en BigQuery Studio. La consulta guardada que se subió también se puede ver en la página de BigQuery de la consola de Google Cloud.

Para subir 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, luego, realiza una de las siguientes acciones:

   • Junto a Consultas, haz clic en Ver acciones > Subir consulta en SQL.
   • Junto al nombre del proyecto de Google Cloud, haz clic en Ver acciones > Subir al proyecto > Consulta en SQL.

3. En el cuadro de diálogo Subir SQL, en el campo SQL, haz clic en Explorar y, luego, selecciona la consulta que deseas subir.

4. En el campo Nombre de SQL, edita el nombre de la consulta (opcional).

5. En el campo Región, selecciona la región en la que deseas subir tu consulta guardada.

6. Haz clic en Subir.

Tu consulta guardada aparecerá en el panel Explorador.

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 crear y actualizar consultas guardadas clásicas. Para obtener más información sobre cómo compartir, migrar y borrar consultas guardadas clásicas, visita 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).

Permisos necesarios para las consultas guardadas clásicas

Se requieren los siguientes permisos de IAM para crear, ver, actualizar y borrar consultas guardadas clásicas:

• Consultas guardadas clásicas privadas:
  • No se requieren permisos especiales para crear consultas guardadas clásicas privadas. Puedes guardar una consulta privada en cualquier proyecto, pero solo tú puedes ver, actualizar o borrar la consulta.
• Consultas guardadas clásicas a nivel de proyecto:
  • Crear una consulta guardada clásica a nivel de proyecto requiere permisos bigquery.savedqueries.create. En la función predefinida bigquery.admin, se incluyen permisos bigquery.savedqueries.create.
  • Ver una consulta guardada clásica a nivel de proyecto requiere permisos bigquery.savedqueries.get y bigquery.savedqueries.list. Para las funciones predefinidas bigquery.admin y bigquery.user, se requieren permisos bigquery.savedqueries.get y bigquery.savedqueries.list.
  • Actualizar una consulta guardada clásica a nivel de proyecto requiere permisos bigquery.savedqueries.update. En la función predefinida bigquery.admin, se incluyen permisos bigquery.savedqueries.update.
  • Borrar una consulta guardada clásica a nivel de proyecto requiere permisos bigquery.savedqueries.delete. En la función predefinida bigquery.admin, se incluyen permisos bigquery.savedqueries.delete.
• Consultas guardadas clásicas públicas:
  • No se requieren permisos especiales para crear consultas guardadas clásicas públicas. Puedes guardar una consulta guardada clásica pública en cualquier proyecto, pero solo tú puedes actualizar o borrar la consulta. Cualquier persona que tenga el vínculo puede ver una consulta guardada clásica pública.

Nota: Los usuarios con el permiso dataform.repository.list a nivel de proyecto pueden ver todas las consultas guardadas creadas en el proyecto.

Para obtener más información sobre las funciones de Cloud IAM en BigQuery, consulta Funciones y permisos predefinidos.

Crea consultas guardadas clásicas

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

   Ir a BigQuery

2. Haz clic en Redactar una nueva consulta.

3. En el Editor de consultas, ingresa una consulta de SQL válida. Por ejemplo, puedes consultar un conjunto de datos públicos:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;
   

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

5. En el diálogo Guardar consulta, ingresa un nombre para tu consulta y, luego, establece la Visibilidad en una de las siguientes opciones:

   • Personal (solo tú puedes editarla) para una consulta compartida clásica privada.
   • Proyecto (las principales con los permisos apropiados pueden editarla) para una consulta guardada clásica a nivel de proyecto.
   • Pública para una consulta guardada clásica pública.

6. Haz clic en Guardar.

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.

Actualiza las 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. Modifica la consulta.

5. Para guardar la consulta modificada, haz clic en Guardar consulta (clásica) > Guardar consulta (clásica).

¿Qué sigue?

• Obtén información sobre cómo administrar consultas guardadas.