Administra Firestore con la consola

Administra Firestore con la consola

Puedes administrar Firestore mediante las siguientes acciones en Google Cloud Console:

• Ver, consultar, agregar, editar y borrar datos
• Administrar índices

Nota: Para administrar las reglas de seguridad, usa Firebase console.

Visualiza datos

Puedes ver todos tus datos de Firestore en la consola de Google Cloud. Desde el visualizador de datos de Firestore, haz clic en un documento o una colección para abrir los datos anidados dentro de ese elemento.

1. En la consola de Google Cloud, ve a la página Bases de datos.

   Ir a Bases de datos

2. Selecciona la base de datos requerida de la lista.

3. En el menú de navegación, haz clic en Firestore Studio.

Abre una ruta específica

Para abrir un documento o una colección en una ruta específica, usa el botón Editar ruta :

Documentos principales no existentes

Un documento puede existir incluso si uno o más de sus principales no existen. Por ejemplo, el documento en la ruta /mycoll/mydoc/mysubcoll/mysubdoc puede existir incluso sin el documento principal /mycoll/mydoc. En el visualizador de datos de Firestore, se muestran documentos principales no existentes de la siguiente manera:

• En la lista de documentos de una colección, los ID de los documentos principales no existentes están en cursiva.
• En el panel de información de los documentos principales no existentes, el visualizador de datos señala que el documento no existe.

Advertencia: Aunque los documentos principales no existentes aparecen en la consola, no ocurre lo mismo en las consultas ni en las instantáneas. Debes crear el documento para incluirlo en los resultados de las consultas.

Filtra datos

Puedes filtrar documentos en una colección según el valor del campo y las condiciones ==, !-, >, >=, <, <=, in, not-in, array-contains y array-contains-any. Por ejemplo, solo puedes mostrar documentos en los que el valor del campo firstname sea igual a Sam. Para aplicar un filtro de colección, sigue estos pasos:

1. Haz clic en el botón de filtro junto a un ID de colección:

   

2. En el menú Add filters (Agregar filtros), selecciona un campo de documento, una condición de filtro y un orden de clasificación.

   

3. Haz clic en Aplicar.

Para quitar un filtro de colección, abre el mismo menú y haz clic en Clear filter (Quitar filtro).

Consulta los datos

Puedes consultar los documentos en la pestaña Compilador de consultas de la página Firestore Studio.

1. En la consola de Google Cloud, ve a la página Bases de datos.

   Ir a Bases de datos

2. Selecciona la base de datos requerida de la lista.

3. En el menú de navegación, haz clic en Firestore Studio.

4. Haz clic en la pestaña Compilador de consultas.

5. Selecciona un Alcance de la consulta.

   Selecciona Colección para consultar una sola colección. En el campo de texto, ingresa una ruta a una colección.

   Selecciona Grupo de colecciones para consultar todas las colecciones con el mismo ID. En el campo Grupo de colecciones, ingresa el ID correspondiente.

   La tabla mostrará automáticamente los documentos de la colección o el grupo de colecciones especificados.

6. Haz clic en Agregar a la consulta para filtrar el conjunto de documentos que se muestra. De forma predeterminada, el compilador de consultas agrega una cláusula WHERE. Puedes modificar esta cláusula mediante los menús desplegables y los campos de texto o cambiar a una de las otras cláusulas disponibles. Para continuar compilando consultas más complejas, haz clic en Agregar a la consulta.

   Para quitar una cláusula de consulta, haz clic en su botón . Para quitar todas las cláusulas de consulta, haz clic en Borrar.

   Nota: Las consultas deben cumplir con los requisitos y las limitaciones de Firestore para las consultas. De lo contrario, no se logra realizar la consulta y la página muestra un error que describe por qué falló.

7. Haz clic en Ejecutar para recuperar los resultados de la base de datos.

   

Nota: Las consultas que ejecutas se almacenan en el historial de tu navegador. Durante la sesión, puedes avanzar y retroceder en el navegador para acceder a las consultas recientes. Puedes agregar a favoritos las consultas a las que deseas acceder con frecuencia o compartir con otras personas.

Requisitos y limitaciones de las consultas

Cuando uses el Compilador de consultas, ten en cuenta los siguientes requisitos y limitaciones.

• Todas las consultas deben ser compatibles con uno o más índices. Si la base de datos no puede encontrar un índice que admita la consulta, mostrará un error que contiene un vínculo para compilar el índice requerido.

  

• Las cláusulas ORDER BY deben coincidir con los campos en las cláusulas WHERE y deben estar en el mismo orden. De forma predeterminada, los resultados se ordenan por ID de documento. Si filtras por cualquier otro campo que no sea una cláusula de igualdad (==), agrega una cláusula ORDER BY para ese campo.

  

• Las cláusulas de consulta de rango (<, <=, >, >=) y desigualdad (!=, not-in) deben aplicar filtros en el mismo campo.

Para conocer otras limitaciones, ve a Limitaciones de las consultas.

Administra datos

En Firestore, almacenas datos en documentos y organizas los documentos en colecciones. Antes de comenzar a agregar datos, obtén más información sobre el modelo de datos de Firestore.

En Firebase console, puedes agregar, editar y borrar documentos y colecciones. Para administrar tus datos desde GCP Console, ve a la página Firestore Studio:

1. En la consola de Google Cloud, ve a la página Bases de datos.

   Ir a Bases de datos

2. Selecciona la base de datos requerida de la lista.

3. En el menú de navegación, haz clic en Firestore Studio.

Nota: Las operaciones de lectura, escritura y eliminación que se realizan desde la consola cuentan para el uso de Firestore.

Agregar datos

1. Haz clic en Iniciar colección.
2. Ingresa un ID de colección. Ingresa el ID de un documento. Firestore generará el ID del documento, pero puedes reemplazar por otro. Agrega campos para los datos del documento.
3. Haz clic en Guardar. La colección y el documento nuevos aparecen en el visor de datos.
4. Para agregar más documentos a la colección, haz clic en Agregar documento.

Edita datos

1. Haz clic en una colección para ver sus documentos y, luego, haz clic en un documento para ver sus campos y subcolecciones.
2. Haz clic en un campo para editar su valor.d Para agregar campos o subcolecciones al documento seleccionado, haz clic en Agregar campo o Iniciar colección.

Borra datos

Puedes borrar documentos o colecciones del visor de datos.

Nota: En algunos casos, si borras una gran cantidad de documentos, es posible que el visor de datos se cargue lentamente o muestre un error de tiempo de espera. Esto se aplica a las operaciones de eliminación que se realizan a través del visor de datos y en otros lugares.

Para borrar una colección, sigue estos pasos:

1. Selecciona la colección que deseas borrar.
2. Haz clic en el ícono de menú en la parte superior de la columna de documentos y, a continuación, haz clic en Borrar colección.

Para borrar un documento, sigue estos pasos:

1. Selecciona el documento que quieres borrar.
2. Haz clic en el ícono de menú situado en la parte superior de la columna de detalles del documento. Selecciona Borrar documento o Borrar los campos del documento.

Si borras un documento, se borran todos los datos anidados en él, incluidas las subcolecciones.

Cuando se borran los campos de un documento, no se borra las subcolecciones. Aunque está vacío, el documento aún existe y puede aparecer en los resultados de las consultas.

Para borrar un campo específico de un documento, sigue estos pasos:

1. Selecciona el documento para ver sus campos.
2. Haz clic en el ícono de borrar junto al campo que deseas borrar.

Administra reglas de seguridad de Firestore

Puedes ver las reglas de seguridad de Firestore en Google Cloud Console. Para editar o borrar tu conjunto de reglas, habilita Firebase y usa Firebase CLI o Firebase console.

Habilita Firebase

Para editar las reglas de seguridad de Firestore, debes habilitar Firebase en tu proyecto de Google Cloud. Si Firebase no está habilitado, puedes habilitar Firebase desde la página Reglas de seguridad:

La función de reglas de seguridad de Firestore está estrechamente integrada con Firebase Auth y los SDK de Firebase (plataformas Android, Apple y Web). Para obtener más información sobre Firebase y Firestore, consulta cómo comenzar a usar Firebase.

Visualiza reglas de seguridad

Para ver las reglas de seguridad de Firestore desde la consola de Google Cloud, ve a la página Reglas de seguridad:

1. En la consola de Google Cloud, ve a la página Bases de datos.

   Ir a Bases de datos

2. Selecciona la base de datos requerida de la lista.

3. En el menú de navegación, haz clic en Reglas de seguridad.

Edita reglas de seguridad

Para editar o borrar tus reglas de seguridad de Firestore, usa Firebase CLI o Firebase console. En Firebase console, ve a la pestaña Reglas en la sección Firestore. Obtén más información sobre cómo configurar y personalizar reglas.

Administrar índices

Si quieres crear índices nuevos para tus consultas y administrar los índices existentes en Firebase console, ve a la pestaña Índices de la sección Firestore. Obtén más información sobre la administración de índices.