Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Uso y límites

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Utilice esta guía para comprender los límites de Cloud Firestore y consulte los precios de Cloud Firestore para obtener una explicación completa y detallada de los costos de Cloud Firestore, incluidas las cosas que debe tener en cuenta.

Supervise su uso

Para monitorear su uso de Cloud Firestore, abra la pestaña Uso de Cloud Firestore en la consola de Firebase. Use el tablero para medir su uso durante diferentes períodos de tiempo.

Uso detallado en Google Cloud Console

Cuando crea un proyecto de Firebase, también está creando un proyecto de Google Cloud. Las páginas Cuotas de API de Cloud Firestore y Cuotas de App Engine en Google Cloud Console rastrean el uso de Cloud Firestore y la información de cuotas.

cupo gratis

Cloud Firestore ofrece una cuota gratuita que le permite comenzar sin costo alguno. Los montos de las cuotas gratuitas se enumeran a continuación. Si necesita más cuota, debe habilitar la facturación para su proyecto de Cloud Platform .

Las cuotas se aplican diariamente y se restablecen alrededor de la medianoche, hora del Pacífico.

Nivel gratuito Cuota
Datos almacenados 1 GiB
Lecturas de documentos 50.000 por día
Escrituras de documentos 20.000 por día
Eliminaciones de documentos 20.000 por día
salida de red 10 GiB por mes

Límites estándar

Las siguientes tablas muestran los límites que se aplican a Cloud Firestore. Estos son límites estrictos a menos que se indique lo contrario.

Colecciones, documentos y campos

Límite Detalles
Restricciones en los ID de colección
  • Deben ser caracteres UTF-8 válidos
  • No debe tener más de 1500 bytes
  • No puede contener una barra diagonal ( / )
  • No puede constar únicamente de un solo punto ( . ) o puntos dobles ( .. )
  • No se puede hacer coincidir la expresión regular __.*__
Profundidad máxima de subcolecciones 100
Restricciones en los ID de documentos
  • Deben ser caracteres UTF-8 válidos
  • No debe tener más de 1500 bytes
  • No puede contener una barra diagonal ( / )
  • No puede constar únicamente de un solo punto ( . ) o puntos dobles ( .. )
  • No se puede hacer coincidir la expresión regular __.*__
  • Si importa entidades de Datastore a una base de datos de Firestore, los ID de entidad numéricos se exponen como __id[0-9]+__
Tamaño máximo para un nombre de documento 6 KiB
Tamaño máximo de un documento 1 MiB (1.048.576 bytes)
Restricciones en los nombres de campo Deben ser caracteres UTF-8 válidos
Tamaño máximo de un nombre de campo 1500 bytes
Restricciones en las rutas de campo
  • Debe separar los nombres de los campos con un solo punto ( . )
  • Puede pasarse como una cadena cuando todos los nombres de campo en la ruta son simples; de lo contrario, debe pasarse como un objeto FieldPath ( por ejemplo, JavaScript FieldPath )
Un nombre de campo simple es aquel en el que todo lo siguiente es verdadero:
  • Contiene solo los caracteres az , AZ , 0-9 y guión bajo ( _ )
  • No comienza con 0-9
Tamaño máximo de una ruta de campo 1500 bytes
Tamaño máximo de un valor de campo 1 MiB - 89 bytes (1 048 487 bytes)
Profundidad máxima de campos en un mapa o matriz 20

Escrituras y transacciones

Límite Detalles
Tamaño máximo de solicitud de API 10 MB
Número máximo de escrituras que se pueden pasar a una operación Commit o realizar en una transacción 500
Número máximo de transformaciones de campo que se pueden realizar en un solo documento en una operación de Commit o en una transacción 500
Límite de tiempo para una transacción 270 segundos, con un tiempo de caducidad inactivo de 60 segundos

Límites blandos

Cloud Firestore no le impide exceder los umbrales a continuación, pero hacerlo afecta el rendimiento.

límite suave Detalles
Tasa de escritura máxima en una colección en la que los documentos contienen valores secuenciales en un campo indexado 500 por segundo

índices

Los siguientes límites se aplican a los índices de un solo campo y a los índices compuestos :

Límite Detalles
Número máximo de índices compuestos para una base de datos 200
Número máximo de configuraciones de un solo campo para una base de datos

200

Se permiten un total de 200 configuraciones a nivel de campo. Una configuración de campo puede contener varias configuraciones para el mismo campo. Por ejemplo, una exención de indexación de un solo campo y una política TTL en el mismo campo cuentan como una configuración de campo hacia el límite.

Número máximo de entradas de índice para cada documento

40.000

El número de entradas de índice es la suma de lo siguiente para un documento:

  • El número de entradas de índice de un solo campo
  • El número de entradas de índice compuesto

Para ver cómo Cloud Firestore convierte un documento y un conjunto de índices en entradas de índice, consulte este ejemplo de recuento de entradas de índice .

Número máximo de campos en un índice compuesto 100
Tamaño máximo de una entrada de índice

7,5 KiB

Para ver cómo Cloud Firestore calcula el tamaño de la entrada de índice, consulte tamaño de entrada de índice .

Suma máxima de los tamaños de las entradas de índice de un documento

8 MB

El tamaño total es la suma de lo siguiente para un documento:

  • La suma del tamaño de las entradas de índice de un solo campo de un documento
  • La suma del tamaño de las entradas de índice compuesto de un documento
  • Tamaño máximo de un valor de campo indexado

    1500 bytes

    Los valores de campo de más de 1500 bytes se truncan. Las consultas que implican valores de campo truncados pueden devolver resultados incoherentes.

    Tiempo de vida (TTL)

    Límite Detalles
    Número máximo de configuraciones de un solo campo para una base de datos

    200

    Se permiten un total de 200 configuraciones a nivel de campo. Una configuración de campo puede contener varias configuraciones para el mismo campo. Por ejemplo, una exención de indexación de un solo campo y una política TTL en el mismo campo cuentan como una configuración de campo hacia el límite.

    Exportar importar

    Los siguientes límites se aplican a las operaciones de importación y exportación gestionadas :

    Límite Detalles
    Número total máximo de solicitudes de exportación e importación para un proyecto permitidas por minuto 20
    Número máximo de exportaciones e importaciones simultáneas 50
    Número máximo de filtros de ID de colección para solicitudes de exportación e importación 100

    Reglas de seguridad

    Límite Detalles
    Número máximo de llamadas a exist( exists() , get() y getAfter() por solicitud
    • 10 para solicitudes de un solo documento y solicitudes de consulta.
    • 20 para lecturas, transacciones y escrituras por lotes de múltiples documentos. El límite anterior de 10 también se aplica a cada operación.

      Por ejemplo, imagine que crea una solicitud de escritura por lotes con 3 operaciones de escritura y que sus reglas de seguridad usan 2 llamadas de acceso a documentos para validar cada escritura. En este caso, cada escritura usa 2 de sus 10 llamadas de acceso y la solicitud de escritura por lotes usa 6 de sus 20 llamadas de acceso.

    Exceder cualquiera de los límites da como resultado un error de permiso denegado.

    Algunas llamadas de acceso a documentos pueden almacenarse en caché y las llamadas almacenadas en caché no cuentan para los límites.

    Profundidad máxima de declaración match anidada 10
    Longitud máxima de ruta, en segmentos de ruta, permitida dentro de un conjunto de sentencias de match anidadas 100
    Número máximo de variables de captura de ruta permitidas dentro de un conjunto de declaraciones de match anidadas 20
    Profundidad máxima de llamada de función 20
    Número máximo de argumentos de función 7
    Número máximo de enlaces de variables let por función 10
    Número máximo de llamadas a funciones recursivas o cíclicas 0 (no permitido)
    Número máximo de expresiones evaluadas por solicitud 1,000
    Tamaño máximo de un conjunto de reglas Los conjuntos de reglas deben obedecer dos límites de tamaño:
    • un límite de 256 KB en el tamaño de la fuente de texto del conjunto de reglas publicado desde Firebase console o desde la CLI mediante firebase deploy .
    • un límite de 250 KB en el tamaño del conjunto de reglas compilado que resulta cuando Firebase procesa la fuente y la activa en el back-end.

    Administrar gastos

    Para ayudar a evitar cargos inesperados en su factura, establezca presupuestos y alertas mensuales.

    Establecer un presupuesto mensual

    Para realizar un seguimiento de los costos de Cloud Firestore, cree un presupuesto mensual en Google Cloud Console. Los presupuestos no limitarán su uso, pero puede configurar alertas para que le notifiquen cuando se acerque o supere sus costos planificados para el mes.

    Para establecer un presupuesto, vaya a la sección Facturación en Google Cloud Console y cree un presupuesto para su cuenta de Facturación en la nube. Puede usar la configuración de alerta predeterminada o modificar las alertas para enviar notificaciones en diferentes porcentajes de su presupuesto mensual.

    Obtenga más información sobre cómo configurar presupuestos y alertas de presupuesto .

    Establecer un límite de gasto diario

    Para limitar su uso de Cloud Firestore, establezca un límite de gasto diario a través de App Engine. App Engine le permite establecer un límite de gasto diario en los recursos asociados de App Engine, incluido Cloud Firestore. El límite de App Engine no se aplica a ningún otro producto de Firebase.