Crea consultas guardadas

Cuando escribes SQL en el editor de consultas, puedes guardar tu consulta y compartirla con otras personas. 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 Cómo administrar consultas guardadas.

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 dataform.repositories.create permiso 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)

Advertencia: La visibilidad de los elementos de código se rige por los permisos de Dataform a nivel del proyecto. Los usuarios con el dataform.repositories.list permiso, que se incluye en los roles estándar de BigQuery, como Usuario de trabajo de BigQuery, Usuario de BigQuery Studio, y Usuario de BigQuery, pueden ver todos los elementos de código en el panel Explorador del Google Cloud proyecto, independientemente de si crearon estos elementos o si se compartieron con ellos. Para restringir la visibilidad, puedes crear roles personalizados que excluyan el permiso dataform.repositories.list.

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.

Nota: Cuando creas una consulta guardada, BigQuery te otorga el rol Administrador de Dataform (roles/dataform.admin) en esa consulta guardada. Todos los usuarios con el rol Administrador de Dataform otorgado en el Google Cloud proyecto tienen acceso de propietario a todas las consultas guardadas creadas en el proyecto. Para anular este comportamiento, consulta Otorga un rol específico cuando se crea un recurso.

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

Todos los elementos de código nuevos de tu Google Cloud proyecto usan una región predeterminada. Después de crear el elemento, no puedes cambiar su región.

Importante: Si cambias la región mientras creas un elemento de código, esa región se convierte en la predeterminada para todos los elementos de código posteriores. Los elementos de código existentes no se ven afectados.

Para configurar la región predeterminada de los elementos de código nuevos, haz lo siguiente:

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el navegador de archivos:

   

3. Junto al nombre del proyecto, haz clic en Ver acciones del panel de archivos > Cambiar región de código.

4. Selecciona la región de código que deseas usar como predeterminada.

5. Haz clic en Guardar.

Para obtener una lista de las regiones compatibles, consulta Ubicaciones de BigQuery Studio.

Crea consultas guardadas

Para crear una consulta guardada, sigue estos pasos:

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

   Ir a BigQuery

2. Haz clic en Consulta en SQL.

3. En el editor de consultas, ingresa una consulta en 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;

   Como alternativa, puedes usar el panel Referencia para crear consultas nuevas.

4. Haz clic en Guardar > Guardar consulta o presiona Control+S (o Command+S en macOS).

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 el campo Región.

7. Haz clic en Guardar.

   Se crea la primera versión de la consulta guardada.

8. Opcional: Después de guardar la consulta, usa la siguiente barra de herramientas para ver los detalles de la consulta o el historial de versiones, agregar comentarios nuevos o responder a un comentario existente o obtener un vínculo a él:

   

   La función de barra de herramientas Comentarios está en versión preliminar. Para enviar comentarios o solicitar asistencia para esta función, envía un correo electrónico a [e-mail].

Comparte consultas guardadas

Para compartir una consulta guardada con un usuario, primero le otorgas acceso a la consulta guardada y lo agregas a un rol de IAM adecuado. Luego, generas un vínculo a la consulta guardada y lo compartes con el usuario.

Los usuarios con los que compartes una consulta solo ven la versión más reciente de una consulta. Los cambios guardados automáticamente que no guardaste de forma explícita no aparecen en la consulta compartida.

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

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Explorador:

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. En el panel Explorador, expande tu proyecto y haz clic en Consultas.

4. Busca y haz clic en la consulta guardada a la que deseas otorgar acceso. Puedes usar la función de búsqueda o los filtros para encontrar tu consulta.

5. Haz clic en Compartir y, luego, en Administrar permisos.

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

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

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

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

10. Haz clic en Guardar.

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

12. Para generar un vínculo a la consulta guardada, haz clic en Compartir, y, luego, en Obtener vínculo.

    El vínculo se copió en el portapapeles.

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 Google Cloud consola de, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Explorador:

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. En el panel Explorador, expande tu proyecto y haz clic en Consultas.

4. Selecciona una consulta guardada. Puedes usar la función de búsqueda o los filtros para encontrar tu consulta.

5. Haz clic en Historial de versiones.

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

Actualiza las consultas guardadas

Los cambios que realices en el texto de una consulta guardada se guardan automáticamente dos segundos después de que dejas de escribir y aparecen en tu Historial de versiones como Tus cambios. Los cambios guardados automáticamente no son una versión nueva de la consulta. Los cambios guardados automáticamente vuelven a aparecer cada vez que abres la consulta, pero no son visibles para nadie más, a menos que los guardes de forma explícita como una versión nueva de la consulta. Las consultas guardadas automáticamente están en versión preliminar.

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

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Explorador:

   

3. En el panel Explorador, expande tu proyecto y haz clic en Consultas.

4. Selecciona una consulta guardada. Puedes usar la función de búsqueda o los filtros para encontrar tu consulta.

5. Modifica la consulta.

6. Para guardar la consulta modificada, haz clic en Guardar consulta > Guardar consulta o presiona Control+S (o Comando+S en macOS).

   Se crea una versión nueva de la consulta.

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 Google Cloud consola de.

Para subir una consulta guardada, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Explorador:

   

3. 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 Google Cloud nombre del proyecto, haz clic en Ver acciones > Subir al proyecto > Consulta en SQL.

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

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

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

7. Haz clic en Subir.

Se puede acceder a tu consulta guardada a través del panel Explorador.

Consultas guardadas clásicas

Obsoleto: Las consultas guardadas, disponibles en BigQuery Studio, reemplazarán por completo las consultas guardadas clásicas en el futuro. Se está revisando el cronograma de baja. 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, consulta 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 clásico 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 Google Cloud consola de, ve a la página BigQuery.

   Ir a BigQuery

2. Haz clic en Consulta en SQL.

3. En el editor de consultas, ingresa una consulta en 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 guardada 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 de la izquierda, haz clic en category Explorador clásico:

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

2. En el panel Explorador clásico, expande tu proyecto, haz clic en Consultas(clásicas) y, luego, busca la consulta guardada clásica que deseas compartir.

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

4. 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 Google Cloud consola de, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en category Explorador clásico:

   

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

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

5. Modifica la consulta.

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