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 predefinidas de Cloud IAM de BigQuery que cuentan con los permisos necesarios.
  • Público: Las consultas públicas guardadas 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 privadas guardadas:
    • La creación de consultas privadas guardadas no requiere permisos especiales. Puedes guardar una consulta privada 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 bigquery.savedqueries.create. La función predefinida bigquery.admin incluye los permisos bigquery.savedqueries.create.
    • Ver una consulta guardada a nivel de proyecto requiere permisos bigquery.savedqueries.get y bigquery.savedqueries.list. Las funciones predefinidas bigquery.admin y bigquery.user incluyen los permisos bigquery.savedqueries.get y bigquery.savedqueries.list.
    • Actualizar una consulta guardada a nivel de proyecto requiere permisos bigquery.savedqueries.update. La función predefinida bigquery.admin incluye los permisos bigquery.savedqueries.update.
    • Borrar una consulta guardada a nivel de proyecto requiere permisos bigquery.savedqueries.delete. La función predefinida bigquery.admin incluye los permisos bigquery.savedqueries.delete.
  • Consultas públicas guardadas:
    • Crear consultas públicas no requiere permisos especiales. Puedes guardar una consulta pública 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.

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

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 crear una consulta compartida privada:

Console

  1. Abre la IU web de BigQuery en GCP Console.
    Ir a GCP 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 desde el inicio rápido de IU web.

    # 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) en 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 de 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 para acceder al vínculo con el fin de compartirlo y copiarlo al portapapeles. De manera alternativa, puedes acceder al vínculo a través del ícono de botón Uso compartido de vínculos que se encuentra sobre el á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 desde el inicio rápido de la IU web clásica.

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

    Guardar lista de consultas

Comparte una consulta guardada

Para compartir una consulta, configura la visibilidad en Proyecto o Público cuando guardes la consulta. La visibilidad del proyecto les permite a los miembros de las funciones predefinidas de Cloud IAM de 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 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 Controla 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:

Console

  1. Abre la IU web de BigQuery en GCP Console.
    Ir a GCP 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 desde el inicio rápido de IU web.

    # 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) en 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 para acceder al vínculo con el fin de compartirlo y copiarlo al portapapeles. De manera alternativa, puedes acceder al vínculo a través del ícono de botón Uso compartido de vínculos que se encuentra sobre el á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 desde el inicio rápido de la IU web clásica.

    #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 copiarlo 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:

Console

Por el momento, no es posible crear una consulta guardada pública con GCP 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 desde el inicio rápido de la IU web clásica.

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

Console

  1. Abre la IU web de BigQuery en GCP Console.
    Ir a GCP 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 cambiar el nombre. Si deseas cambiar el nombre, haz clic en la flecha hacia abajo junto a Guardar consulta, selecciona Guardar como y haz las 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 de 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 Consulta guardada.

  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:

Console

  1. Abre la IU web de BigQuery en GCP Console.
    Ir a GCP 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.