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 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, haz lo siguiente:
    • 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 Identity and Access Management (IAM) de Spanner, consulta la 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 permiso 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 laGoogle Cloud consola.

    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 de SQL válida.

  7. Haz clic en Guardar.

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

  9. Haz clic en Guardar.

Cómo abrir y ejecutar una consulta guardada

Para abrir una consulta guardada existente como una consulta 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. También 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 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 pestaña nueva del editor. También 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 laGoogle Cloud consola.

    Instancias

  2. Selecciona cualquier instancia. (Dado que una consulta guardada es secundaria de un proyecto, siempre que tengas el rol requerido, puedes 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 búsquedas guardadas en este proyecto (incluidas las búsquedas 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.

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 cuadro de 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 cuadro de diálogo Borrar consulta, haz clic en Borrar.

¿Qué sigue?