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 consola de Google Cloud.

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 IAM en el proyecto:

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 ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para usar las consultas guardadas:

  • Para crear y borrar consultas guardadas, sigue estos pasos:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
  • Para administrar todas las consultas guardadas en un proyecto, haz lo siguiente:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
    • databasesConsole.studioQuery.list
    • databasesConsole.studioQuery.get

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. Es suficiente para la mayoría de los usuarios.

El rol de Administrador de consultas de Studio (roles/databasesConsole.studioQueryAdmin) solo se debe otorgar a los administradores. Para obtener más información sobre la administración de identidades y accesos (IAM) de Spanner, consulta Descripción general de IAM.

Permisos

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

  • databasesConsole.locations.get
  • databasesConsole.locations.list
  • databasesConsole.studioQueries.create

Para ver las consultas guardadas, necesitas el siguiente permiso a nivel del proyecto:

  • databasesConsole.studioQueries.search

Para modificar y borrar consultas guardadas, necesitas el siguiente permiso a nivel del proyecto:

  • databasesConsole.studioQueries.update

Los permisos para ejecutar consultas se heredan de la base de datos. Es posible que tengas permisos para ver, pero no para ejecutar una consulta.

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.

    1. En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.

  5. En el Editor de consultas, ingresa una consulta de SQL válida.

  6. Haz clic en Guardar.

  7. En el cuadro de diálogo Guardar consulta, escribe un nombre para la consulta guardada.

  8. Haz clic en Guardar.

Abre y ejecuta una consulta guardada

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

  1. En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
  2. En el panel Explorador, navega a la sección Consultas. Haz clic en una consulta guardada para abrirla en una nueva pestaña del editor. Como alternativa, haz 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 la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
  2. En el panel Explorador, navega a la sección Consultas. Haz clic en una consulta guardada para abrirla en una nueva pestaña del editor. Como alternativa, haz 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. Ve a la página Instancias de Spanner en la consola de Google Cloud.

    Instancias

  2. Selecciona cualquier instancia. (Dado que una consulta guardada es un elemento secundario de un proyecto, siempre que tengas el rol requerido, podrás ver todas las consultas guardadas en el proyecto desde cualquier instancia o base de datos).

  3. Selecciona cualquier base de datos.

  4. En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.

  5. En el panel Explorador, navega a la sección Consultas. Haz clic en Ver acciones junto a una consulta guardada. Luego, haz clic en Administrar consultas.

    Se abrirá la página Consultas guardadas. En ella, se enumeran todas las consultas guardadas en este proyecto (incluidas las consultas guardadas para otros productos 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.

Para borrar una consulta guardada en la página Consultas guardadas, sigue estos pasos:

  1. Haz clic en Ver acciones junto a la consulta guardada que deseas borrar.
  2. Haz clic en Borrar consulta para borrar la consulta guardada.
  3. En el diálogo Borrar consulta, haz clic en Borrar.

Borra una consulta guardada

  1. En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
  2. En el panel Explorador, expande la carpeta Consultas. 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 diálogo Borrar consulta, haz clic en Borrar.

¿Qué sigue?