Guarda y comparte consultas

Esta página describe cómo guardar y compartir consultas. Las consultas guardadas o compartidas solo contienen la consulta, lo que significa lo siguiente:

  • Una consulta compartida proporciona solo el texto de la consulta. Aún necesitas tener un acceso apropiado para consultar los datos. Una ventaja de guardar solo el texto de la consulta es que puedes compartir una consulta que está incompleta, incluso si no es una consulta válida, y usarla como una plantilla que otros usuarios pueden completar o personalizar.

  • La única opción de consulta retenida por una consulta guardada es la "Versión de SQL", que determina si la consulta usa SQL heredado o SQL estándar.

Hay 3 tipos de consultas guardadas:

  • Privadas: Las consultas privadas guardadas son visibles solo para el usuario que las crea.
  • Nivel de proyecto: Las consultas guardadas a nivel de proyecto son visibles para los miembros de las funciones IAM de BigQuery predefinidos con los permisos necesarios.
  • Públicas: Las consultas públicas guardadas son visibles para cualquier persona con el vínculo de consulta.

Permisos

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

  • Consultas privadas guardadas:
    • La creación de consultas privadas guardadas no requiere permisos especiales. Puedes guardar una consulta privada en la IU web de BigQuery en cualquier proyecto, pero solo puedes ver, actualizar o borrar la consulta.
  • Consultas guardadas a nivel de proyecto:
    • Crear una consulta guardada a nivel de proyecto requiere permisos de bigquery.savedqueries.create. El bigquery.admin predefinido incluye permisos de función IAM a nivel de proyecto bigquery.savedqueries.create.
    • Ver una consulta guardada a nivel de proyecto requiere los bigquery.savedqueries.get y permisos bigquery.savedqueries.list. El bigquery.admin y el bigquery.user predefinido, las funciones de IAM a nivel proyecto incluyen bigquery.savedqueries.get y permisos bigquery.savedqueries.list.
    • Actualizar una consulta guardada a nivel de proyecto requiere permisos bigquery.savedqueries.update. El bigquery.admin predefinido incluye permisos de función IAM a nivel de proyecto bigquery.savedqueries.update.
    • Borrar una consulta guardada a nivel de proyecto requiere permisos bigquery.savedqueries.delete. El bigquery.admin predefinido incluye permisos de función IAM a nivel de proyecto bigquery.savedqueries.delete.
  • Consultas públicas guardadas:
    • Crear consultas públicas no requiere permisos especiales. Puedes guardar una consulta pública en la IU web de BigQuery en cualquier proyecto, pero solo puedes actualizar o borrar la consulta. Cualquier persona que tenga el vínculo puede ver una consulta pública guardada.

A fin de obtener más información sobre las funciones IAM en BigQuery, consulta Control de acceso.

Crea una consulta privada guardada

Cuando guardas una consulta y configuras la visibilidad en privado, la consulta puede ser vista, actualizada o borrada solo por ti.

Para guardar una consulta privada en la IU web de BigQuery:

  1. Ve a la IU web de BigQuery.
    Ir a la IU web de BigQuery

  2. Haz clic en Redactar consulta.

  3. Ingresa una consulta nueva de SQL de BigQuery en el área de texto de consulta nueva. Por ejemplo, puedes usar la consulta desde el inicio rápido de IU web.

    #standardSQL
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. Haz clic en Guardar consulta para abrir el cuadro de diálogo Consulta guardada.

  5. En el cuadro de diálogo Consulta guardada, asígnale un nombre a tu consulta guardada, deja la Visibilidad configurada en Privada (solo visible para mi), y, luego, haz clic en Aceptar.

    Cuadro de diálogo Guardar consulta

  6. Para ver tu consulta guardada, asegúrate de que el Historial de consultas esté seleccionado en la navegación de la izquierda y haz clic en Consultas guardadas en la sección Consultas.

    Guardar lista de consultas

Comparte una consulta guardada

Para compartir una consulta, cuando guardes la consulta configura la visibilidad en Proyecto o Público. La visibilidad del proyecto permite a los miembros de las funciones IAM de BigQuery predefinidas tener los permisos necesarios para ver, actualizar o borrar la consulta.

La visibilidad pública permite que cualquier persona con el vínculo de la consulta vea, pero no actualice o borre la consulta. Para ejecutar la consulta, los usuarios deben tener acceso a los datos a los que accede la consulta. Para obtener más información, consulta Controlar el acceso a los conjuntos de datos.

Cuando compartes una consulta, considera incluir un comentario que describa la consulta como se muestra en el ejemplo que sigue.

Crea una consulta guardada a nivel de proyecto

Sigue los pasos a continuación para compartir una consulta con otro miembro de tu proyecto:

  1. Ve a la IU web de BigQuery.
    Ir a la IU web de BigQuery

  2. Haz clic en Redactar consulta.

  3. Ingresa una consulta nueva de SQL de BigQuery en el área de texto de consulta nueva. Por ejemplo, puedes usar la consulta desde el inicio rápido de IU web.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. Haz clic en Guardar consulta para abrir el cuadro de diálogo Consulta guardada.

  5. En el cuadro de diálogo Guardar consulta ingresa un nombre para tu consulta, configura la Visibilidad en Proyecto (los miembros del Proyecto pueden ver y editar), y luego haz clic en Aceptar.

    Compartir consultas de proyecto

  6. Para ver tu consulta guardada asegúrate de que el Historial de consultas esté seleccionado en la navegación de la izquierda y haz clic en Consultas de proyecto en la sección Consultas.

    Lista de consultas de proyectos

  7. Haz clic en el nombre de tu consulta guardada para expandirla.

    Consulta de proyecto expandida

  8. Haz clic en Compartir vínculo para acceder al vínculo que se puede compartir y copiar el vínculo en el portapapeles.

    Compartir vínculo de consulta de proyecto

    De otro modo, puedes acceder al vínculo a través del ícono de vínculo que se encuentra sobre el área de texto de la consulta nueva.

    Ícono de vínculo de consulta

  9. Comparte el vínculo con otro miembro de tu equipo.

Crea una consulta pública guardada

Sigue los pasos a continuación para compartir una consulta con cualquier persona:

  1. Ve a la IU web de BigQuery.
    Ir a la IU web de BigQuery

  2. Haz clic en Redactar consulta.

  3. Ingresa una consulta nueva de SQL de BigQuery en el área de texto de consulta nueva. Por ejemplo, puedes usar la consulta desde el inicio rápido de IU web.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. Haz clic en Guardar consulta para abrir el cuadro de diálogo Consulta guardada.

  5. En el cuadro de diálogo Guardar consulta ingresa un nombre para tu consulta, establece la Visibilidad en Pública (cualquier persona con el vínculo puede ver, pero no editar), y luego haz clic en Aceptar.

    Compartir consulta pública

  6. Para ver tu consulta guardada, asegúrate de que el Historial de consultas esté seleccionado en la navegación de la izquierda y haz clic en Consultas guardadas en la sección Consultas.

    Lista de consultas públicas guardadas

  7. Haz clic en el nombre de tu consulta pública guardada para expandirla.

    Consulta pública expandida

  8. Haz clic en Compartir vínculo para acceder al vínculo que se puede compartir y copiar el vínculo en el portapapeles.

    Compartir vínculo de consulta pública

    De otro modo, puedes acceder al vínculo a través del ícono de vínculo que se encuentra sobre el área de texto de la consulta nueva.

    Ícono de vínculo de consulta pública

  9. Comparte el vínculo

Actualiza consultas guardadas

Para actualizar una consulta guardada:

  1. Ve a la IU web de BigQuery.
    Ir a la IU web de BigQuery

  2. Haz clic en Historial de consultas en la barra de navegación izquierda y en la sección Consultas, haz clic en Consultas guardadas (para editar una consulta privada) o en Consultas de proyecto (para editar una consulta pública o de nivel de proyecto).

    Lista de consultas de proyectos

  3. A la derecha de la consulta, haz clic en Editar consulta.

    Botón editar consulta

  4. Modifica la consulta.

  5. Haz clic en Guardar consulta para abrir el cuadro de diálogo Consulta guardada.

  6. En el cuadro de diálogo de Guardar consulta no cambies el nombre y haz clic en Aceptar.

Borra consultas guardadas

Para borrar una consulta guardada:

  1. Ve a la IU web de BigQuery.
    Ir a la IU web de BigQuery

  2. Haz clic en Historial de consultas en la barra de navegación izquierda.

  3. A la derecha de la consulta, haz clic en el botón (X) Borrar consulta guardada.

  4. Cuando se te solicite, haz clic en Aceptar para confirmar.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.