Crear y gestionar consultas guardadas

En esta página se describe cómo crear y gestionar consultas guardadas. Cuando escribes consultas en Firestore Studio, puedes guardarlas y gestionarlas. Para obtener más información, consulta el artículo Descripción general de las consultas guardadas.

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

Roles obligatorios

Para obtener los permisos que necesitas para usar las consultas guardadas, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos (IAM) en el proyecto:

  • Para ver las consultas guardadas, haz lo siguiente: Lector de Cloud Datastore (roles/datastore.viewer)
  • Para ver, crear, modificar y eliminar consultas guardadas, necesitas el rol Usuario de Cloud Datastore (roles/datastore.user).
  • Para administrar, ver, crear, modificar y eliminar consultas guardadas: Propietario de Cloud Datastore (roles/datastore.owner). Este rol tiene permisos amplios y proporciona acceso completo a Firestore con compatibilidad con MongoDB. Solo lo pueden usar los administradores.

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar 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 obligatorios

Para crear, ver, modificar y eliminar consultas guardadas, necesitas los siguientes permisos de gestión de identidades y accesos a nivel de proyecto:

Acción Permisos de gestión de identidades y accesos necesarios
Crear consultas guardadas
  • databasesconsole.studioQueries.create
Ver consultas guardadas
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Modificar consultas guardadas
  • databasesconsole.studioQueries.update
Eliminar consultas guardadas
  • databasesconsole.studioQueries.delete
Administrar consultas guardadas
(solo para administradores)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

También puedes obtener estos permisos con roles personalizados u 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.

Asigna el rol Administrador de consultas de Studio (roles/databasesconsole.studioQueryAdmin) solo a los administradores. Para obtener más información sobre la gestión de identidades y accesos de Firestore con compatibilidad con MongoDB, consulta el artículo Gestión de identidades y accesos.

Crear una consulta guardada

Para crear una consulta guardada, sigue estos pasos:

  1. Ve a la página Todas las bases de datos de la consola de Google Cloud .
    Todas las bases de datos
  2. Selecciona una base de datos de Firestore con compatibilidad con MongoDB en la que quieras crear una consulta guardada.
  3. En el menú de navegación, haz clic en Firestore Studio.
  4. En el panel Explorador de la página Firestore Studio, ve a la sección Colecciones.
  5. Haz clic en una colección para abrir una nueva pestaña del editor. También puedes hacer lo siguiente: Haz clic en . Selecciona Ver acciones junto a una colección. A continuación, haz clic en Colección de consultas para abrir una nueva pestaña del editor.
  6. En el editor de consultas, escribe una consulta.
  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.

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 Firestore Studio, ve a la sección Consultas.
  2. Haz clic en una consulta guardada para abrirla en una nueva pestaña del editor. También puedes hacer lo siguiente: Haz clic en Ver acciones junto a una consulta guardada. A continuación, haz clic en Abrir consulta para abrirla en una nueva pestaña del editor.
  3. Haz clic en Ejecutar.

Actualizar una consulta guardada

Para actualizar una consulta guardada, sigue estos pasos:

  1. En el panel Explorador de la página Firestore Studio, ve a la sección Consultas.
  2. Haz clic en una consulta guardada para abrirla en una nueva pestaña del editor. También puedes hacer lo siguiente: Haz clic en Ver acciones junto a una consulta guardada. A continuación, 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.

Ver y gestionar una lista de todas las consultas guardadas

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

  1. Ve a la página Todas las bases de datos de la consola de Google Cloud .
    Todas las bases de datos
  2. Selecciona cualquier base de datos. Como una consulta guardada es un elemento secundario de un proyecto, siempre que tengas el rol necesario, puedes ver todas las consultas guardadas del proyecto desde cualquier base de datos.
  1. Selecciona cualquier base de datos.
  2. En el panel Explorador de la página Firestore Studio, ve a la sección Consultas.
  3. Haz clic en Ver acciones junto a una consulta guardada. A continuación, haz clic en Gestionar consultas.

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

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

Eliminar una consulta guardada

Puedes eliminar una consulta guardada desde la página Firestore Studio o desde la página Consultas guardadas de la Google Cloud consola.

  1. En el panel Explorador de la página Firestore Studio, ve a la sección Consultas.
  2. Haz clic en Ver acciones junto a la consulta guardada que quieras eliminar. A continuación, haz clic en Eliminar consulta para eliminar la consulta guardada.
  3. En el cuadro de diálogo Eliminar consulta, haga clic en Eliminar.

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

  1. Vaya a la página Consultas guardadas.
  2. Haz clic en Ver acciones junto a la consulta guardada que quieras eliminar.
  3. Haz clic en Eliminar consulta para eliminar la consulta guardada.
  4. En el cuadro de diálogo Eliminar consulta, haga clic en Eliminar.

Siguientes pasos