Para aumentos rápidos de tráfego, o modo Datastore tenta dimensionar automaticamente
para satisfazer o aumento da procura. Quando o modo Datastore
é dimensionado, a latência começa a diminuir.
Os pontos críticos (taxas de leitura, escrita e eliminação elevadas para um intervalo de entidades restrito)
limitam a capacidade de escalabilidade do modo Datastore. Reveja o
design para escalabilidade
e identifique pontos críticos na sua aplicação.
Conflito, quer seja devido à atualização de uma única entidade com demasiada frequência ou devido a transações.
ler, escrever
Reduza a taxa de gravação em entidades individuais.
Por exemplo, as consultas com vários filtros de igualdade (==),
mas não suportadas por índices compostos, podem resultar em consultas de junção de união lentas.
Para melhorar o desempenho, adicione índices compostos para estas consultas.
Consulte o artigo
Otimizar índices.
read Isto afeta significativamente as operações que listam tipos numa base de dados.
Se a latência for causada por demasiadas eliminações recentes, o problema deve resolver-se automaticamente após algum tempo. Se o problema não ficar resolvido, contacte o apoio técnico.
Indexação de fanout, especialmente para propriedades de matriz.
As seguintes situações podem aumentar os erros ABORTED:
Uma entidade que recebe demasiadas atualizações por segundo.
Concorrência de transações sobrepostas.
Aumentos de tráfego que excedam a regra 500-50-5 ou encontrem pontos críticos.
ABORTED
Too much contention on these datastore entities. Please try again.
Ou
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 resolver este problema:
Para aumentos rápidos do tráfego, o modo Datastore tenta dimensionar automaticamente
para satisfazer o aumento da procura. Quando o modo Datastore
é dimensionado, a latência começa a diminuir.
Os pontos críticos limitam a capacidade de expansão do modo Datastore. Reveja o artigo Conceber para expansão para identificar pontos críticos.
As seguintes situações podem causar erros INVALID_ARGUMENT:
Está a tentar confirmar uma entidade com um valor de propriedade indexado superior a 1500 bytes. Este limite aplica-se à codificação UTF-8 do valor da propriedade.
Está a tentar confirmar uma entidade com valores de propriedades não indexados superiores a 1 048 487 bytes (1 MiB - 89 bytes). Este limite aplica-se à soma dos valores das propriedades numa entidade. Por exemplo, quatro propriedades de 256 KiB cada excedem o limite.
1500 bytes (indexados) e 1 048 487 bytes (não indexados) são os limites para os valores das propriedades. Não pode exceder estes limites, e estes não são quotas que podem ser ajustadas.
INVALID_ARGUMENT: The value of property property-name is longer than 1500 bytes
ou
INVALID_ARGUMENT: The value of property property_name is longer than 1048487 bytes
Para resolver este problema:
Para valores de propriedades indexados, divida a propriedade em várias propriedades. Se possível, crie uma propriedade não indexada
e mova os dados que não precisam de ser indexados para a propriedade
não indexada.
Para valores de propriedades não indexados, divida a propriedade em várias propriedades ou implemente a compressão para o valor da propriedade.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
