Crea consultas guardadas

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

Consultas guardadas

Para obtener asistencia durante la vista previa, envía un correo electrónico a bigquery-notebooks-support@google.com.

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.

Permisos necesarios

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

Todos los usuarios con la función de 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

Puedes obtener estos permisos desde los siguientes roles de IAM:

Permisos para editar consultas guardadas

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

Permisos para ver las consultas guardadas

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

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.

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:

  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

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.

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.

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?