En caso de aumentos rápidos del tráfico, el modo Datastore intenta escalarse automáticamente para satisfacer el aumento de la demanda. Cuando el modo Datastore se escala, la latencia empieza a disminuir.
Los puntos de acceso (tasas altas de lectura, escritura y eliminación en un intervalo de entidades reducido) limitan la capacidad de escalado del modo Datastore. Revisa el diseño para la escalabilidad e identifica los puntos de acceso de tu aplicación.
Contención, ya sea por actualizar una sola entidad con demasiada frecuencia o por transacciones.
Lectura y escritura
Reduce la tasa de escritura en entidades individuales.
Por ejemplo, las consultas con varios filtros de igualdad (==) que no estén respaldadas por índices compuestos pueden dar lugar a consultas de combinación lentas.
Para mejorar el rendimiento, añade índices compuestos a estas consultas.
Consulta Optimizar índices.
Se han eliminado demasiados elementos recientemente.
read Esto afecta considerablemente a las operaciones que muestran los tipos de una base de datos.
Si la latencia se debe a que se han eliminado demasiados elementos recientemente,
el problema debería resolverse automáticamente al cabo de un tiempo. Si el problema no se resuelve, póngase en contacto con el servicio de asistencia.
Indexación de salida, especialmente para propiedades de matriz.
write
Revisa los
índices explosivos
y el uso que haces de las propiedades de matriz.
Códigos de error
En esta sección se enumeran los problemas que puede encontrar y se ofrecen sugerencias para solucionarlos.
DEADLINE_EXCEEDED
DEADLINE_EXCEEDED
A deadline was exceeded on the server.
Las siguientes situaciones pueden aumentar los errores ABORTED:
Una entidad que recibe demasiadas actualizaciones por segundo.
Contención de transacciones superpuestas.
Aumentos de tráfico que superen la regla del 500-50-5 o que se produzcan en puntos de acceso.
ABORTED
Too much contention on these datastore entities. Please try again.
O
ABORTED
Aborted due to cross-transaction contention. This occurs when multiple
transactions attempt to access the same data, requiring Datastore mode
to abort at least one in order to enforce serializability.
Para solucionar este problema, sigue estos pasos:
En caso de aumentos rápidos del tráfico, el modo Datastore intenta escalar automáticamente para satisfacer el aumento de la demanda. Cuando el modo Datastore se escala, la latencia empieza a disminuir.
Los puntos de acceso limitan la capacidad del modo Datastore para aumentar la escala. Consulta el artículo sobre diseño para la escalabilidad para identificar los puntos de acceso.
Las siguientes situaciones pueden provocar errores INVALID_ARGUMENT:
Se ha intentado confirmar una entidad con un valor de propiedad indexado superior a 1500 bytes. Este límite se aplica a la codificación UTF-8 del valor de la propiedad.
Se ha intentado confirmar una entidad con valores de propiedad sin indexar superiores a 1.048.487 bytes (1 MiB - 89 bytes). Este límite se aplica a la suma de los valores de las propiedades de una entidad. Por ejemplo, cuatro propiedades de 256 KiB cada una superan el límite.
Los límites de los valores de propiedad son 1500 bytes (indexados) y 1.048.487 bytes (sin indexar). No puedes superar estos límites, que no son cuotas que se puedan ajustar.
INVALID_ARGUMENT: The value of property property-name is longer than 1500 bytes
o
INVALID_ARGUMENT: The value of property property_name is longer than 1048487 bytes
Para solucionar este problema, sigue estos pasos:
En el caso de los valores de propiedades indexados, divide la propiedad en varias propiedades. Si es posible, cree una propiedad sin indexar y mueva los datos que no necesiten indexarse a esa propiedad.
En el caso de los valores de propiedades no indexados, divide la propiedad en varias propiedades o implementa la compresión del valor de la propiedad.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[[["\u003cp\u003eThis guide helps resolve issues with Firestore in Datastore mode, focusing on latency and error codes.\u003c/p\u003e\n"],["\u003cp\u003eIncreased latency can be caused by high traffic, contention, slow queries, large reads, recent deletes, or index fanout, each with specific resolutions.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eABORTED\u003c/code\u003e errors often result from too many updates to a single entity, contention from overlapping transactions, or traffic exceeding the 500-50-5 rule, with solutions that involve scaling and reducing write rates.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eRESOURCE_EXHAUSTED\u003c/code\u003e errors are triggered by exceeding the free tier quota without billing enabled, which can be resolved by waiting for the daily reset or enabling billing.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e errors arise from exceeding property value limits for indexed or un-indexed values, and require splitting the property into multiple properties or implementing compression.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting\n\nThis page shows you how to resolve issues with Firestore in Datastore mode.\n\nLatency\n-------\n\nThe table below describes possible causes of increased latency:\n\nError Codes\n-----------\n\nThis section lists issues that you might encounter and provides suggestions for\nhow to fix each of them.\n\n### DEADLINE_EXCEEDED\n\n```\nDEADLINE_EXCEEDED\n\nA deadline was exceeded on the server.\n```\n\nTo resolve this issue, see the [guide to troubleshooting latency](#latency).\n\n### ABORTED\n\nThe following situations can increase `ABORTED` errors:\n\n- An entity receiving too many updates per second.\n- Contention from overlapping transactions.\n- Traffic increases that exceed the 500-50-5 rule or encounter hot-spots.\n\n```\nABORTED\n\nToo much contention on these datastore entities. Please try again.\n```\n\nOr \n\n```\nABORTED\n\nAborted due to cross-transaction contention. This occurs when multiple\ntransactions attempt to access the same data, requiring Datastore mode\nto abort at least one in order to enforce serializability.\n```\n\nTo resolve this issue:\n\n- For rapid traffic increases, Datastore mode attempts to automatically scale to meet the increased demand. When Datastore mode scales, latency begins to decrease.\n- Hot-spots limit the ability of Datastore mode to scale up, review [designing for scale](./best-practices#designing_for_scale) to identify hot-spots.\n- Review [data contention in transactions](/datastore/docs/concepts/transactions#isolation_and_consistency) and your usage of transactions.\n- Reduce the write rate to individual entities.\n\n### RESOURCE_EXHAUSTED\n\nThe following situations can lead to `RESOURCE_EXHAUSTED` errors:\n\nYou exceeded the [free tier quota](/datastore/pricing#free_quota) and billing is not enabled\nfor your project. \n\n```\nRESOURCE_EXHAUSTED\n\nSome resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.\n```\n\nTo resolve this issue:\n\n- Wait for the daily reset of your free tier quota or [enable billing for\n your project](/billing/docs/how-to/modify-project#enable_billing_for_a_project).\n\n### INVALID_ARGUMENT\n\nThe following situations can cause `INVALID_ARGUMENT` errors:\n\n- Attempting to commit an entity with an **indexed** property value greater than 1500 bytes. This limit applies to the UTF-8 encoding of the property value.\n- Attempting to commit an entity with **un-indexed** property values greater than 1,048,487 bytes (1 MiB - 89 bytes). This limit applies to the sum of the property values in an entity. For example, four properties of 256 KiB each exceed the limit.\n\n1,500 bytes (indexed) and 1,048,487 bytes (un-indexed) are\n[limits](/datastore/docs/concepts/limits) for property values. You cannot\nexceed these limits and they are not quotas that can be adjusted. \n\n```\nINVALID_ARGUMENT: The value of property property-name is longer than 1500 bytes\n```\n\nor \n\n```\nINVALID_ARGUMENT: The value of property property_name is longer than 1048487 bytes\n```\n\nTo resolve this issue:\n\n- For indexed property values, split the property into multiple properties. If possible, create an un-indexed property and move data that doesn't need to be indexed into the un-indexed property.\n- For un-indexed property values, split the property into multiple properties or implement compression for the property value."]]
