Guarda y comparte consultas

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

  • En una consulta compartida, se proporciona solo el texto de la consulta. Tambié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 conservada por una consulta guardada es la “Versión de SQL”, que determina si la consulta usa SQL heredado o SQL estándar.

Existen 3 tipos de consultas guardadas:

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

Permisos

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

  • Consultas guardadas privadas:
    • No se requieren permisos especiales para crear consultas guardadas privadas. Puedes guardar una consulta privada en cualquier proyecto, pero solo tú puedes ver, actualizar o borrar la consulta.
  • Consultas guardadas a nivel del proyecto:
    • Crear una consulta guardada a nivel del proyecto requiere permisos bigquery.savedqueries.create. En la función predefinida bigquery.admin, se incluyen permisos bigquery.savedqueries.create.
    • Ver una consulta guardada a nivel del 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 a nivel del proyecto requiere permisos bigquery.savedqueries.update. En la función predefinida bigquery.admin, se incluyen permisos bigquery.savedqueries.update.
    • Borrar una consulta guardada a nivel del proyecto requiere permisos bigquery.savedqueries.delete. En la función predefinida bigquery.admin, se incluyen permisos bigquery.savedqueries.delete.
  • Consultas guardadas públicas:
    • No se requieren permisos especiales para crear consultas públicas. Puedes guardar una consulta 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 pública.

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

Crea una consulta privada guardada

Cuando guardas una consulta y configuras la visibilidad como Privada, solo tú puedes ver, actualizar o borrar la consulta.

Para crear una consulta privada compartida, sigue estos pasos:

Console

  1. Abre la IU web de BigQuery en Cloud Console.
    Ir a Cloud Console

  2. Haz clic en Redactar consulta nueva.

  3. Ingresa una consulta de SQL válida en el área de texto del Editor de consultas. Por ejemplo, puedes usar la consulta que se incluye en la Guía de inicio rápido con la IU web en GCP Console.

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

  5. En el cuadro de diálogo Guardar consulta (Save query), ingresa un nombre para tu consulta, configura la Visibilidad (Visibility) como Personal (solo tú puedes editarla) (Personal [editable only by you]) y, luego, haz clic en Guardar (Save).

    Guardar consulta privada

  6. Para ver tu consulta guardada, haz clic en Consultas guardadas. La página Consultas personales debería estar abierta de manera predeterminada.

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

  8. Haz clic en Compartir URL de consulta a fin de acceder al vínculo para compartir y copia el vínculo en el portapapeles. De manera alternativa, puedes acceder al vínculo a través del ícono del botón Uso compartido de vínculos que se encuentra arriba del área de texto del Editor de consultas.

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

IU clásica

  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 de SQL en el área de texto Consulta nueva. Por ejemplo, puedes usar la consulta que se incluye en la Guía de inicio rápido con la IU web en GCP Console.

    #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 Guardar consulta (Save Query), ingresa el nombre de tu consulta guardada, deja Visibilidad (Visibility) configurada como Privada (Solo visible para mi) (Private [Visible only to you]) y, luego, haz clic en Aceptar (OK).

    Cuadro de diálogo Guardar consulta

  6. Para ver la consulta guardada, asegúrate de que Historial de consultas (Query History) esté seleccionado en la navegación de la izquierda y haz clic en Consultas guardadas (Saved Queries) en la sección Consultas (Queries).

    Lista Guardar consultas

Comparte una consulta guardada

Para compartir una consulta, configura la visibilidad como Proyecto o Pública cuando guardes la consulta. La visibilidad del proyecto les permite a los miembros de las funciones predefinidas de Cloud IAM en BigQuery 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 pueda verla, pero no actualizarla ni borrarla. 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 Controla el acceso a los conjuntos de datos.

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

Crea una consulta guardada a nivel del proyecto

Sigue los pasos para compartir una consulta con otro miembro de tu proyecto:

Console

  1. Abre la IU web de BigQuery en Cloud Console.
    Ir a Cloud Console

  2. Haz clic en Redactar consulta nueva.

  3. Ingresa una consulta válida de SQL en BigQuery en el área de texto Editor de consulta. Por ejemplo, puedes usar la consulta que se incluye en la Guía de inicio rápido con la IU web en GCP Console.

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

  5. En el cuadro de diálogo Guardar consulta (Save query), ingresa un nombre para tu consulta, configura la Visibilidad (Visibility) como Proyecto (editable por los miembros del proyecto) (Project [editable by project members]) y, luego, haz clic en Guardar (Save).

    Guardar proyecto de consulta

  6. Para ver tu consulta guardada, haz clic en Consultas guardadas (Saved queries) en el panel de navegación de la izquierda y en Consultas del proyecto (Project queries).

    Pestaña de consultas del proyecto

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

  8. Haz clic en Compartir URL de consulta a fin de acceder al vínculo para compartir y copia el vínculo en el portapapeles. De manera alternativa, puedes acceder al vínculo a través del ícono del botón Uso compartido de vínculos que se encuentra arriba del área de texto del Editor de consultas.

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

IU clásica

  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 de SQL en el área de texto Consulta nueva. Por ejemplo, puedes usar la consulta que se incluye en la Guía de inicio rápido con la IU web en GCP Console.

    #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 (Save Query) ingresa un nombre para la consulta, configura Visibilidad (Visibility) como Proyecto (Los miembros del proyecto pueden ver y editar) (Project [Project members can view and edit]) y, luego, haz clic en Aceptar (OK).

    Compartir proyecto de consultas

  6. Para ver la consulta guardada asegúrate de que Historial de consultas (Query History) esté seleccionado en la navegación de la izquierda y haz clic en Consultas de proyecto (Project Queries) en la sección Consultas (Queries).

    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 (Share Link) a fin de acceder al vínculo para compartirlo y cópialo en el portapapeles.

    Vínculo compartir consulta de proyecto

    De manera alternativa, puedes acceder al vínculo a través del ícono de vínculo que se encuentra sobre el área de texto de Consulta nueva.

    Ícono de vínculo de consulta

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

Crea una consulta guardada pública

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

Console

Por el momento, no es posible crear una consulta guardada pública con Cloud Console.

IU clásica

  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 de SQL en el área de texto Consulta nueva. Por ejemplo, puedes usar la consulta que se incluye en la Guía de inicio rápido con la IU web en GCP Console.

    #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 (Save Query) ingresa un nombre para la consulta, configura Visibilidad (Visibility) como Pública (cualquier persona con el vínculo puede ver, pero no editar) (Public [Anyone with the link can view, but not edit]) y, luego, haz clic en Aceptar (OK).

    Compartir consulta pública

  6. Para ver la consulta guardada, asegúrate de que Historial de consultas (Query History) esté seleccionado en la navegación de la izquierda y haz clic en Consultas guardadas (Saved Queries) en la sección Consultas (Queries).

    Lista de consultas guardadas públicas

  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 (Share Link) a fin de acceder al vínculo para compartir y cópialo en el portapapeles.

    Vínculo para compartir de consulta pública

    De manera alternativa, puedes acceder al vínculo a través del ícono de vínculo que se encuentra sobre el área de texto de Consulta nueva.

    Ícono de vínculo de consulta pública

  9. Comparte el vínculo.

Actualiza consultas guardadas

Para actualizar una consulta guardada, sigue estos pasos:

Console

  1. Abre la IU web de BigQuery en Cloud Console.
    Ir a Cloud Console

  2. Haz clic en Consultas guardadas, en el panel de navegación de la izquierda, y en Consultas personales (Personal queries) para editar una consulta privada o en Consultas del proyecto (Project Queries) para editar una consulta a nivel del proyecto. Haz clic en tu consulta para expandirla.

  3. A la derecha de tu consulta, haz clic en Abrir consulta en el editor (Open query in editor).

    Actualizar consulta

  4. Modifica la consulta.

  5. Haz clic en Guardar consulta para actualizar la consulta sin cambiarle el nombre. Si deseas cambiar el nombre, haz clic en la flecha hacia abajo junto a Guardar consulta, selecciona Guardar como y haz actualizaciones en el cuadro de diálogo según sea necesario.

IU clásica

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

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

    Lista de consultas de proyectos

  3. A la derecha de la consulta, haz clic en Editar consulta (Edit Query).

    Botón Editar consulta

  4. Modifica la consulta.

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

  6. En el cuadro de diálogo de Guardar consulta, deja el nombre sin modificar y haz clic en Aceptar.

Borra consultas guardadas

Para borrar una consulta guardada, sigue estos pasos:

Console

  1. Abre la IU web de BigQuery en Cloud Console.
    Ir a Cloud Console

  2. Haz clic en Consultas guardadas, en el panel de navegación de la izquierda, y en Consultas personales (Personal queries) para borrar una consulta privada o en Consultas del proyecto (Project Queries) para borrar una consulta a nivel del proyecto. Haz clic en tu consulta para expandirla.

  3. Haz clic en Borrar (Delete) a la derecha de la consulta.

    Borrar consulta

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

IU clásica

  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 ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.