Crea y administra consultas guardadas

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para reutilizar y compartir operaciones de bases de datos comunes en todas las sesiones, puedes crear, organizar y administrar secuencias de comandos de SQL guardadas en Bigtable Studio. Para obtener más información, consulta Descripción general de las consultas guardadas.

La función de consultas guardadas solo está disponible en la consola y no usa APIs.

Roles obligatorios

Para obtener los permisos que necesitas para usar las consultas guardadas, pídele a tu administrador que te otorgue los siguientes roles de Identity and Access Management (IAM) en el proyecto:

• Para ver las consultas guardadas: Lector de Bigtable (roles/bigtable.reader)
• Para ver, crear, modificar y borrar consultas guardadas: Usuario de Bigtable (roles/bigtable.user)
• Para administrar, ver, crear, modificar y borrar consultas guardadas: Administrador de Bigtable (roles/bigtable.admin). Este rol tiene permisos amplios y proporciona acceso completo a Bigtable, solo para que lo usen los administradores.

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 usar las consultas guardadas. Para obtener más información sobre los permisos necesarios, consulta Permisos necesarios.

Permisos necesarios

Para crear, ver, modificar y borrar consultas guardadas, necesitas los siguientes permisos de IAM a nivel del proyecto:

Acción	Permisos de IAM obligatorios
Crea consultas guardadas	databasesconsole.studioQueries.create
Visualiza las consultas guardadas	databasesconsole.studioQueries.search databasesconsole.locations.get databasesconsole.locations.list
Modifica las consultas guardadas	databasesconsole.studioQueries.update
Borrar las consultas guardadas	databasesconsole.studioQueries.delete
Administrar consultas guardadas (solo para uso de los administradores)	databasesConsole.studioQueries.list databasesconsole.locations.list

Nota: Tener acceso a las consultas guardadas no significa automáticamente que tengas permisos para ejecutar la consulta.

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

El rol Usuario de consultas de Studio (roles/databasesconsole.studioQueryUser) proporciona acceso para crear, ver y escribir consultas guardadas. Este rol satisface las necesidades de la mayoría de los usuarios.

Otorga el rol de administrador de consultas de Studio (roles/databasesconsole.studioQueryAdmin) solo a los administradores. Para obtener más información sobre la IAM de Bigtable, consulta Control de acceso de Bigtable con IAM.

Crea una consulta guardada

Para crear una consulta guardada, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Instancias de Bigtable.
   Instancias
2. Selecciona la instancia en la que deseas crear una consulta guardada.

3. En el menú de navegación, haz clic en Bigtable Studio.

   En el panel Explorador, se muestra una lista de tablas, vistas y consultas en la instancia.

4. En la pestaña Editor, ejecuta tu consulta.

   Los resultados aparecen en la tabla Resultados.

5. Si no estás conforme con los resultados, modifica la consulta y vuelve a ejecutarla. Cuando estés conforme con la consulta, haz clic en Guardar.
6. En el cuadro de diálogo Guardar consulta, ingresa un nombre para la consulta guardada.
7. Haz clic en Guardar.

Opcional:

• Para guardar la consulta con un nombre diferente, haz clic en la flecha de expansión Guardar como, elige Guardar como consulta y, luego, ingresa un nombre nuevo en el cuadro de diálogo.
• Para cambiar la región que usa esta consulta guardada, selecciona Mostrar opciones avanzadas. Luego, en la lista Región, selecciona una región.

También puedes guardar la consulta como una vista lógica o una vista materializada continua.

Abre y ejecuta una consulta guardada

Para abrir una consulta guardada como una consulta nueva, sigue estos pasos:

1. En el panel Explorador de la página Bigtable Studio, navega a la sección Consultas.
2. Haz clic en una consulta guardada para abrirla en una pestaña nueva del editor. De manera opcional, puedes hacer clic en Ver acciones junto a una consulta guardada. Luego, haz clic en Abrir consulta para abrirla en una nueva pestaña del editor.
3. Haz clic en Ejecutar.

Actualiza una consulta guardada

Para actualizar una consulta guardada existente, sigue estos pasos:

1. En el panel Explorador de la página Bigtable Studio, navega a la sección Consultas.
2. Haz clic en una consulta guardada para abrirla en una pestaña nueva del editor. De manera opcional, puedes hacer clic en Ver acciones junto a una consulta guardada. Luego, haz clic en Abrir consulta para abrirla en una nueva pestaña del editor.
3. Modifica la consulta.
4. Para guardar la consulta modificada, haz clic en Guardar.

Consulta y administra una lista de todas las consultas guardadas

Para ver una lista de todas las consultas guardadas en tu proyecto, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Instancias de Bigtable.
   Instancias
2. Selecciona una instancia. Debido a que una consulta guardada es un elemento secundario de un proyecto, siempre y cuando tengas el rol requerido, puedes ver todas las consultas guardadas en el proyecto desde cualquier instancia o base de datos.

3. En el panel Explorador de la página Bigtable Studio, navega a la sección Consultas.
4. Haz clic en Ver acciones junto a una consulta guardada. Luego, haz clic en Administrar consultas.

   Se abrirá la página Consultas guardadas. En esta página, se enumeran todas las consultas guardadas en este proyecto, incluidas las consultas guardadas para otros productos de Google Cloud .

Puedes buscar, filtrar, ver y borrar consultas en la página Consultas guardadas. No puedes editar una consulta existente en la página Consultas guardadas.

Borra una consulta guardada

Puedes borrar una consulta guardada desde la página Bigtable Studio o en la página Consultas guardadas de la consola de Google Cloud .

1. En el panel Explorador de la página Bigtable Studio, navega a la sección Consultas.
2. Haz clic en Ver acciones junto a la consulta guardada que deseas borrar. Luego, para borrar la consulta guardada, haz clic en Borrar consulta.
3. En el cuadro de diálogo Borrar consulta, haz clic en Borrar.

También puedes borrar una consulta guardada en la página Consultas guardadas. Para borrar una consulta guardada en la página Consultas guardadas, sigue estos pasos:

1. Navega a la página Consultas guardadas.
2. Haz clic en Ver acciones junto a la consulta guardada que deseas borrar.
3. Haz clic en Borrar consulta para borrar la consulta guardada.
4. En el cuadro de diálogo Borrar consulta, haz clic en Borrar.

¿Qué sigue?

• Obtén más información sobre las consultas guardadas.