Usa Firestore Studio para la edición Standard

Usa Firestore Studio para la edición Standard

Puedes administrar la edición Standard de Firestore con las siguientes acciones en la Google Cloud consola:

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

Visualiza datos

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

1. En la Google Cloud consola, 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 superiores 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 la edición Standard de Firestore, se muestran documentos superiores no existentes de la siguiente manera:

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

Advertencia: Aunque los documentos superiores 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 ==, !-, >, >=, <, <=, in, not-in, array-contains, array-contains-any condiciones. Por ejemplo, puedes mostrar solo los 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 Google Cloud consola, 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 la edición Standard 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.

   

Sugerencia: 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 marcar las consultas a las que deseas acceder con frecuencia o compartirlas 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 para admitir 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 la edición Standard de 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 la edición Standard 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 Google Cloud consola, 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 la edición Standard de Firestore.

Agregar datos

1. Haz clic en Iniciar colección.
2. Ingresa un ID de colección. Ingresa el ID de un documento. La edición Standard de 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 visualizador de datos.

Nota: En algunos casos, borrar una gran cantidad de documentos puede hacer que el visualizador 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 visualizador 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 administrar e implementar reglas de seguridad de Firestore directamente en la Google Cloud consola. El editor de reglas está disponible para Firestore en modo nativo en las ediciones Standard y Enterprise.

Usa la Google Cloud consola

Nota: La Google Cloud consola no admite la implementación de reglas de seguridad de Firestore en la base de datos (default). Para administrar las reglas de la base de datos (default), usa Firebase console o Firebase CLI.

Permisos necesarios

Para administrar e implementar reglas de seguridad en la Google Cloud consola, necesitas los siguientes permisos de IAM:

• firebaserules.releases.create
• firebaserules.releases.delete
• firebaserules.releases.update
• firebaserules.rulesets.create
• firebaserules.rulesets.delete
• firebaserules.rulesets.list
• firebaserules.rulesets.test (necesario para usar el simulador de reglas)

Para implementar reglas en la Google Cloud consola, sigue estos pasos:

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

   Ir a Bases de datos

2. Haz clic en el ID de la base de datos que deseas administrar.

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

4. Haz clic en la pestaña Reglas de Firestore.

5. En el editor de reglas, consulta tus reglas. Para editar, haz clic en New ruleset o Clone ruleset y, luego, modifica tus reglas.

6. Haz clic en Publish para implementar los cambios.

También puedes ver los conjuntos de reglas anteriores en la línea de tiempo y clonarlos o restaurarlos.

Habilita Firebase

Para editar las reglas de seguridad de Firestore de tu base de datos (default) con el Firebase console o Firebase CLI, debes habilitar Firebase para tu Google Cloud proyecto. Si Firebase no está habilitado, puedes habilitarlo desde la página Seguridad en la Google Cloud consola:

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.

Administra índices

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