Administrar consultas guardadas

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

Consultas guardadas

Usa las siguientes secciones para aprender a administrar consultas guardadas. Las consultas guardadas son elementos de código de BigQuery Studio con tecnología de Dataform.

Antes de comenzar

Para administrar las consultas guardadas de BigQuery Studio y migrar las consultas guardadas clásicas a las consultas guardadas de BigQuery Studio, haz lo siguiente:

  1. Habilita BigQuery Studio en tu proyecto.

  2. Opcional: Para establecer permisos de IAM en las consultas guardadas clásicas públicas o del proyecto migradas durante la migración (versión preliminar), crea o selecciona una consulta guardada de BigQuery Studio y otorga los permisos de Identity and Access Management (IAM) seleccionados a esa consulta guardada.

    1. Durante la migración de consultas guardadas clásicas públicas o de proyectos a las consultas guardadas de BigQuery Studio, selecciona una consulta guardada de BigQuery Studio para copiar los permisos otorgados en ella a las consultas guardadas migradas.

Roles obligatorios

Para obtener los permisos que necesitas para administrar las consultas guardadas, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto en el que deseas administrar las consultas guardadas:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para administrar las consultas guardadas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para administrar las consultas guardadas:

  • Para administrar las consultas guardadas de BigQuery Studio en la consola de Google Cloud, haz lo siguiente: bigquery.config.get, bigquery.jobs.create, dataform.locations., resourcemanager.projects.get, resourcemanager.projects.list, bigquery.readsessions., dataform.repositories., dataform.workspaces.
  • Para administrar las consultas guardadas de BigQuery Studio con la API de BigQuery, haz lo siguiente: dataform.locations., dataform.repositories., dataform.workspaces.*, resourcemanager.projects.get, resourcemanager.projects.list
  • Para migrar las consultas guardadas clásicas del proyecto a las consultas guardadas de BigQuery Studio, haz lo siguiente: bigquery.savedqueries.get, bigquery.savedqueries.list, bigquery.savedqueries.update, resourcemanager.projects.setIamPolicy
  • Para permitir que los usuarios autenticados vean las consultas de acceso público, haz lo siguiente: dataform.locations.*, dataform.repositories.computeAccessTokenStatus, dataform.repositories.fetchHistory, dataform.repositories.fetchRemoteBranches, dataform.repositories.get, dataform.repositories.getIamPolicy, dataform.repositories.list, dataform.repositories.queryDirectoryContents, dataform.repositories.readFile, dataform.workspaces.fetchFileDiff, dataform.workspaces.fetchFileGitStatuses, dataform.workspaces.fetchGitAheadBehind. dataform.workspaces.get, dataform.workspaces.getIamPolicy, dataform.workspaces.list, dataform.workspaces.queryDirectoryContents, dataform.workspaces.readFile, dataform.workspaces.searchFiles, resourcemanager.projects.get, resourcemanager.projects.list

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

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.

Otorga acceso público a una consulta guardada

Para otorgar acceso público a una consulta guardada de BigQuery Studio, otorga el rol de Visualizador de código (roles/dataform.codeViewer) a la principal allAuthenticatedUsers en la consulta guardada.

Cuando asignas un rol de IAM al principal allAuthenticatedUsers, se otorga ese rol a las cuentas de servicio y a todos los usuarios de Internet que se autenticaron con una Cuenta de Google. Esto incluye cuentas que no están conectadas a una cuenta de Google Workspace o a un dominio de Cloud Identity, como Cuentas de Gmail personales. Los usuarios que no están autenticados, como los visitantes anónimos, no están incluidos. Si deseas obtener más información, consulta Todos los usuarios autenticados.

Por ejemplo, cuando otorgas el rol de visor de código a allAuthenticatedUsers en la consulta sales guardada, todas las cuentas de servicio y los usuarios de Internet que se autenticaron con una Cuenta de Google tienen acceso de solo lectura a la consulta sales guardada.

Para otorgar acceso público a una consulta guardada de BigQuery Studio, haz lo siguiente:

  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 público.

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

  6. En la lista Rol, selecciona el rol Visualizador de código.

  7. Haz clic en Guardar.

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

Cómo impedir el acceso público a las consultas guardadas

Para garantizar que no se otorgue acceso público a ninguna consulta guardada de BigQuery Studio, limita el principal de allAuthenticatedUsers en tu proyecto.

Para restringir allAuthenticatedUsers en tu proyecto, puedes establecer la política iam.allowedPolicyMemberDomains y quitar allAuthenticatedUsers de la lista de allowed_values.

Cuando restringes allAuthenticatedUsers en la política iam.allowedPolicyMemberDomains, el principal allAuthenticatedUsers no se puede usar en ninguna política de IAM de tu proyecto, lo que evita otorgar acceso público a todos los recursos, incluidas las consultas guardadas de BigQuery Studio.

Para obtener más información sobre la política iam.allowedPolicyMemberDomains y las instrucciones para configurarla, consulta Restringe identidades por dominio.

Visualiza todas las consultas guardadas

Para ver una lista de todas las consultas guardadas en tu proyecto, haz lo siguiente:

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

    Ir a BigQuery

  2. En el panel Explorador, haz clic en Ver acciones junto a Consultas y, luego, realiza una de las siguientes acciones:

  • Para abrir la lista en la pestaña actual, haz clic en Mostrar todo.
  • Para abrir la lista en una pestaña nueva, haz clic en Mostrar todo en > Nueva pestaña.
  • Para abrir la lista en una pestaña dividida, haz clic en Mostrar todo en > Dividir pestaña.

Visualiza los metadatos de consultas guardadas

Para ver los metadatos de la consulta guardada, haz lo siguiente:

  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 la consulta guardada de la que deseas ver los metadatos.

  3. Mira el panel Resumen para ver información sobre la consulta guardada, como la región que usa y la fecha en la que se modificó por última vez.

Trabaja con versiones de consultas guardadas

Usa las siguientes secciones para aprender a ver, comparar y restablecer versiones de una consulta guardada.

Visualiza versiones de consultas guardadas

Para ver las versiones de las consultas guardadas, haz lo siguiente:

  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 la consulta guardada de la que deseas ver la actividad.

  3. Haz clic en la pestaña Actividad para ver una lista de las versiones de consultas guardadas en orden descendente por fecha.

Compara versiones de consultas guardadas

Para comparar las versiones de las consultas guardadas, haz lo siguiente:

  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 la consulta guardada para la que deseas comparar la información de la versión.

  3. En la pestaña Actividad, haz clic en Ver acciones junto a la versión de una consulta guardada y, luego, en Comparar. Se abrirá el panel de comparación y se comparará la versión de la consulta guardada que seleccionaste con la versión actual de la consulta guardada.

  4. Opcional: Para comparar las versiones intercaladas en lugar de en paneles separados, haz clic en Comparar y, luego, en Intercalado.

Restablece una versión de consulta guardada

Usa una de las siguientes opciones para restablecer una versión de consulta guardada. Restablecer desde el panel de comparación te permite comparar la versión anterior de la consulta guardada con la versión actual antes de decidir si restablecerla.

Panel de actividad

  1. 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 la consulta guardada de la que deseas restablecer una versión anterior.
  2. Selecciona el panel Actividad.
  3. Haz clic en Ver acciones junto a la versión de la consulta guardada que deseas restablecer y, luego, en Restablecer.
  4. Haz clic en Confirmar para confirmar la acción.

Panel de comparación

  1. 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 la consulta guardada de la que deseas restablecer una versión anterior.
  2. Selecciona el panel Actividad.
  3. Haz clic en Ver acciones junto a la versión de la consulta guardada y, luego, en Comparar. Se abrirá el panel de comparación y se comparará la versión de la consulta guardada que seleccionaste con la versión más reciente de la consulta guardada.
  4. Si deseas restablecer la versión anterior de la consulta guardada después de la comparación, haz clic en Restablecer.
  5. Haz clic en Confirmar para confirmar la acción.

Descarga consultas guardadas

Para descargar una consulta guardada, haz lo siguiente:

  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. Haz clic en Descargar.

Borrar las consultas guardadas

Para borrar una consulta guardada, haz lo siguiente:

  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 que deseas borrar.

  3. Haz clic en Ver acciones junto a la consulta guardada y, luego, en Borrar.

  4. Para confirmar la eliminación, escribe delete en el cuadro de diálogo.

  5. Haz clic en Borrar.

Consultas guardadas clásicas

Usa las siguientes secciones para aprender a administrar consultas guardadas clásicas.

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.

Guarda una consulta clásica como una consulta guardada

  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. Haz clic en Guardar consulta (clásica) > Guardar consulta como….

  5. En el cuadro de diálogo Guardar consulta, escribe un nombre y elige la ubicación para la consulta.

  6. Haz clic en Guardar.

Migra consultas guardadas clásicas

Para solicitar asistencia o enviar comentarios sobre esta función, envía un correo electrónico a bigquery-studio-support-alias@google.com.

Para migrar consultas guardadas clásicas por lotes, debes tener los permisos necesarios. Estos permisos determinan el tipo de consultas guardadas clásicas que puedes migrar.

Puedes migrar por lotes las siguientes consultas guardadas clásicas:

Consultas guardadas clásicas personales
Las consultas guardadas clásicas personales son visibles solo para el usuario que las crea. Se identifican con el ícono . Solo los propietarios pueden migrar las consultas guardadas clásicas personales. Es posible que los administradores y los usuarios a los que se les otorgó acceso a las consultas guardadas de BigQuery Studio migradas puedan acceder a las consultas guardadas personales, modificarlas o borrarlas.
Consultas guardadas clásicas públicas:

Las consultas guardadas clásicas públicas son visibles para cualquier persona que tenga un vínculo a la consulta. Se identifican con el ícono . Solo los propietarios pueden migrar las consultas guardadas clásicas públicas.

Los permisos de IAM en las consultas guardadas clásicas públicas no se asignan a los permisos de las consultas guardadas de BigQuery Studio. Esto significa que las consultas guardadas de BigQuery Studio que se migraron de las consultas guardadas clásicas públicas no están disponibles de forma pública de forma predeterminada. Debes configurar los permisos de IAM para las consultas guardadas de BigQuery Studio migradas, ya sea durante o después de la migración.

Para establecer permisos de IAM para las consultas guardadas de BigQuery Studio que se migraron durante la migración, puedes seleccionar una consulta guardada de BigQuery Studio existente que tenga los permisos que deseas aplicar a las consultas guardadas que se migraron. BigQuery copiará los permisos otorgados en la consulta guardada de BigQuery Studio seleccionada y los aplicará a las consultas guardadas migradas. También puedes agregar manualmente usuarios o grupos con los que desees compartir las consultas guardadas migradas.

Si no configuras los permisos de IAM durante la migración, solo tú tendrás acceso a las consultas guardadas de BigQuery Studio migradas.

Consultas guardadas clásicas del proyecto

Las consultas guardadas a nivel de proyecto son visibles para las principales que tienen los permisos necesarios. Se identifican con el ícono . Puedes migrar por lotes todas las consultas guardadas clásicas de tu proyecto.

Los permisos de IAM en las consultas guardadas clásicas del proyecto no se asignan directamente a los permisos de las consultas guardadas de BigQuery Studio. Debes configurar los permisos de IAM para las consultas guardadas de BigQuery Studio migradas, ya sea durante o después de la migración.

Para establecer permisos de IAM para las consultas guardadas de BigQuery Studio que se migraron durante la migración, puedes seleccionar una consulta guardada de BigQuery Studio existente que tenga los permisos que deseas aplicar a las consultas guardadas que se migraron. BigQuery copiará los permisos otorgados en la consulta guardada de BigQuery Studio seleccionada y los aplicará a las consultas guardadas migradas. También puedes agregar manualmente usuarios o grupos con los que desees compartir las consultas guardadas migradas.

Si no configuras los permisos de IAM durante la migración, solo tú tendrás acceso a las consultas guardadas de BigQuery Studio migradas.

Durante la migración por lotes de las consultas guardadas clásicas, BigQuery hace lo siguiente:

  • Guarda todas las consultas guardadas clásicas que se migran como consultas guardadas de BigQuery Studio, que se almacenan en la región seleccionada.
  • Convierte todas las consultas clásicas guardadas que se migran a consultas clásicas guardadas de solo lectura, disponibles hasta 2025.

Después de la migración, puedes acceder a tus consultas clásicas guardadas personales, públicas y de proyectos como consultas guardadas de BigQuery Studio y como consultas clásicas guardadas de solo lectura. Las consultas guardadas clásicas de solo lectura estarán disponibles hasta 2025.

Riesgos de migración

Después de la migración por lotes, no podrás modificar las consultas clásicas guardadas que se hayan migrado. Las consultas guardadas clásicas personales, públicas y de proyectos que hayas migrado se convertirán en de solo lectura. Las consultas guardadas clásicas personales, públicas y de proyectos de solo lectura estarán disponibles hasta 2025.

BigQuery agregará las consultas guardadas de BigQuery Studio migradas a tu proyecto de Google Cloud con la API de Dataform. Para revertir estos cambios, se requiere una limpieza manual.

Migra consultas guardadas clásicas por lotes

Para migrar por lotes las consultas guardadas clásicas de tu proyecto a las consultas guardadas de BigQuery Studio, haz lo siguiente:

  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 haz clic en Ver acciones junto a Consultas (clásicas) y, luego, en Migrar consultas guardadas clásicas.

  3. En el panel Migración de consultas guardadas clásicas, en la sección Verificar estado para la migración, haz clic en Siguiente para confirmar que tienes los permisos necesarios.

    Tus permisos de IAM determinan qué tipo de consultas guardadas clásicas puedes migrar y qué secciones del panel Migración de consultas guardadas clásicas puedes ver.

  4. En la sección Región, en el menú desplegable Región, selecciona una región en la que BigQuery almacenará las consultas guardadas migradas.

    Te recomendamos que selecciones tu región predeterminada para los recursos de código de BigQuery Studio. Para obtener más información, consulta Configura la región predeterminada para los elementos de código.

  5. Para migrar todas tus consultas guardadas clásicas personales, en la sección Migrar consultas personales, selecciona la casilla de verificación Migrar todas las consultas personales y, luego, haz clic en Siguiente.

  6. Para migrar todas las consultas guardadas clásicas públicas de tu proyecto, en la sección Migrar consultas públicas, haz lo siguiente:

    1. Selecciona la casilla de verificación Migrar todas las consultas públicas.
    2. En el menú desplegable SQL, selecciona una consulta guardada de BigQuery Studio que tenga las políticas de IAM que deseas aplicar a las consultas guardadas migradas.
    3. Opcional: Para agregar un usuario o grupo con el que deseas compartir las consultas guardadas migradas, haz clic en Agregar usuario o grupo y Otorgar acceso a las consultas guardadas.

      Para compartir las consultas guardadas migradas de forma pública, configura allAuthenticatedUsers como el principal y asígnale el rol de Visualizador de código. Para obtener más información, consulta Otorga acceso público.

    4. Haz clic en Siguiente.

  7. Para migrar las consultas guardadas clásicas a nivel del proyecto, en la sección Migrar consultas de proyectos, haz lo siguiente:

    1. Selecciona la casilla de verificación Migrate all project queries.
    2. En el menú desplegable SQL, selecciona una consulta guardada de BigQuery Studio que tenga las políticas de IAM que deseas aplicar a las consultas guardadas migradas.
    3. Opcional: Para agregar un usuario o grupo con el que deseas compartir las consultas guardadas migradas, haz clic en Agregar usuario o grupo y Otorgar acceso a las consultas guardadas.
    4. Haz clic en Siguiente.
  8. Para confirmar que comprendes los riesgos de migración y que deseas migrar por lotes las consultas clásicas guardadas, en la sección Confirmar, en el campo Confirmar, ingresa confirm y, luego, haz clic en Siguiente.

  9. Haz clic en Enviar.

La migración puede tardar más de 15 minutos, según la cantidad de consultas que se migren.

Borra 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. Busca la consulta guardada clásica que deseas borrar.

  4. Haz clic en Ver acciones junto a la consulta y, luego, en Borrar.

  5. Para confirmar la eliminación, escribe delete en el cuadro de diálogo.

  6. Haz clic en Borrar.

¿Qué sigue?