En esta página, se describe cómo crear y administrar consultas guardadas. Cuando escribes consultas en Cloud Firestore Studio , puedes guardarlas y administrarlas. 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 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 Identity and Access Management (IAM) en el proyecto:
- Para ver las consultas guardadas:
Visualizador de Cloud Datastore (
roles/datastore.viewer) - Para ver, crear, modificar y borrar consultas guardadas:
Usuario de Cloud Datastore (
roles/datastore.user) - Para administrar, ver, crear, modificar y borrar consultas guardadas:
Propietario de Cloud Datastore (
roles/datastore.owner). Este rol tiene permisos amplios y proporciona acceso completo a Cloud Firestore, solo para uso de 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 |
|
| Ver las búsquedas guardadas |
|
| Modifica las consultas guardadas |
|
| Borra las consultas guardadas |
|
| Administra las consultas guardadas (solo para uso de los administradores) |
|
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
Cloud Firestore IAM, consulta Identity and Access Management
.
Crear una consulta guardada
Para crear una consulta guardada, sigue estos pasos:
- Ve a la página Todas las bases de datos en la consola de Google Cloud.
Todas las bases de datos - Selecciona una base de datos Cloud Firestore en la que deseas crear una consulta guardada.
- En el menú de navegación, haz clic en Cloud Firestore Studio.
- En el panel Explorador de la página de Cloud Firestore Studio, navega a la sección Colecciones.
- Haz clic en una colección para abrir una pestaña nueva del editor. De manera opcional, puedes hacer clic Ver acciones junto a una colección. Luego, haz clic en Consultar colección para abrir una pestaña nueva del editor.
- En el editor de consultas, escribe una consulta.
- Haz clic en Guardar.
- En el diálogo Guardar consulta, ingresa un nombre para la consulta guardada.
- Haz clic en Guardar.
Abre y ejecuta una consulta guardada
Para abrir una consulta guardada como una consulta nueva, sigue estos pasos:
- En el panel Explorador de la página Cloud Firestore Studio, navega a la sección Consultas.
- Haz clic en una consulta guardada para abrirla en una pestaña nueva del editor. De manera opcional, puedes hacer clic Ver acciones junto a una consulta guardada. Luego, haz clic en Abrir consulta para abrirla en una pestaña nueva del editor.
- Haz clic en Ejecutar.
Actualiza una consulta guardada
Para actualizar una consulta guardada existente, sigue estos pasos:
- En el panel Explorador de la página Cloud Firestore Studio, navega a la sección Consultas.
- Haz clic en una consulta guardada para abrirla en una pestaña nueva del editor. De manera opcional, puedes hacer clic Ver acciones junto a una consulta guardada. Luego, haz clic en Abrir consulta para abrirla en una pestaña nueva del editor.
- Modifica la consulta.
- 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:
- Ve a la página Todas las bases de datos en la consola de Google Cloud.
Todas las bases de datos - Selecciona cualquier base de datos. Debido a que una consulta guardada es un elemento secundario de un proyecto, siempre que tengas el rol necesario, puedes ver todas las consultas guardadas en el proyecto desde cualquier base de datos.
- Selecciona cualquier base de datos.
- En el panel Explorador de la página Cloud Firestore Studio, 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 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 Cloud Firestore Studio o en la página Consultas guardadas en la consola de Google Cloud.
- En el panel Explorador de la página Cloud Firestore Studio, navega a la sección Consultas.
- Haz clic en Ver acciones junto a la consulta guardada que deseas borrar. Luego, para borrar la consulta guardada, haz clic en Borrar consulta.
- En el 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:
- Navega a la página Consultas guardadas.
- Haz clic en Ver acciones junto a la consulta guardada que deseas borrar.
- Haz clic en Borrar consulta para borrar la consulta guardada.
- En el diálogo Borrar consulta, haz clic en Borrar.
¿Qué sigue?
- Obtén información sobre las consultas guardadas.