Crea y administra consultas guardadas

En esta página, se describe cómo crear y administrar consultas guardadas. Cuando escribes secuencias de comandos de SQL en Spanner Studio, puedes guardarlas y administrarlas. Para obtener más información, consulta la Descripción general de las consultas guardadas.

La función de consultas guardadas solo está disponible en la Google Cloud consola.

Roles requeridos

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 crear, editar y borrar consultas guardadas: Usuario de Studio Query (roles/databasesconsole.studioQueryUser)
  • Para administrar todas las consultas guardadas en un proyecto, incluido el acceso a la página Consultas guardadas: Administrador de consultas de Studio (roles/databasesconsole.studioQueryAdmin)

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
Ver las búsquedas guardadas
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Cómo modificar las búsquedas guardadas
  • databasesconsole.studioQueries.update
Borrar las consultas guardadas
  • databasesconsole.studioQueries.delete
Administrar consultas guardadas
(solo para uso de administradores)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

El rol de 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 IAM de Spanner, consulta la Descripción general de IAM.

Ingresar un nombre para la consulta

Para crear una consulta guardada, sigue estos pasos:

  1. Ve a la página Instancias de Spanner en la consola de Google Cloud .
    Instancias
  2. Selecciona la instancia en la que deseas crear una consulta guardada.
  3. Selecciona la base de datos en la que deseas crear una consulta guardada.
  4. En el menú de navegación, haz clic en Spanner Studio.
  5. En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
  6. En el editor de consultas, ingresa una consulta en SQL.
  7. Haz clic en Guardar.
  8. En el cuadro de diálogo Guardar consulta, ingresa un nombre para la consulta guardada.
  9. Haz clic en Guardar.

Cómo abrir y ejecutar una consulta guardada

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

  1. En el panel Explorador de la página Spanner Studio, navega a la sección Consultas.
  2. Haz clic en una consulta guardada para abrirla en una nueva pestaña 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 Spanner Studio, navega a la sección Consultas.
  2. Haz clic en una consulta guardada para abrirla en una nueva pestaña 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 búsquedas guardadas

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

  1. Ve a la página Instancias de Spanner en la consola de Google Cloud .
    Instancias
  2. Selecciona cualquier instancia. Como una consulta guardada es secundaria a un proyecto, siempre que tengas el rol requerido, puedes ver todas las consultas guardadas en el proyecto desde cualquier instancia o base de datos.
  1. Selecciona cualquier base de datos.
  2. En el panel Explorador de la página Spanner Studio, navega a la sección Consultas.
  3. 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 Google Cloud productos.

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 Spanner Studio o en la página Consultas guardadas de la consola de Google Cloud .

  1. En el panel del Explorador de la página Spanner Studio, navega a la sección Queries.
  2. Haz clic en Ver acciones junto a la consulta guardada que deseas borrar. Luego, haz clic en Borrar consulta para borrar la consulta guardada.
  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?