Compreenda os códigos de erro
Esta página apresenta os códigos de erros que pode encontrar e sugestões sobre como corrigir cada um deles.
DEADLINE_EXCEEDED
O seguinte pode aumentar os erros de DEADLINE_EXCEEDED:
- Um aumento na latência fez com que uma operação demorasse mais do que o prazo (60 segundos por predefinição) a ser concluída.
DEADLINE_EXCEEDED A deadline was exceeded on the server.
Para resolver este problema, consulte o guia de resolução de problemas de latência.
ABORTED
As seguintes situações podem aumentar os erros ABORTED:
- Um documento que recebe demasiadas atualizações por segundo.
- Conflito 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 Firestore to abort at least one in order to enforce serializability.
Para resolver este problema:
- Para aumentos rápidos de tráfego, o Firestore tenta dimensionar automaticamente para satisfazer o aumento da procura. Quando o Firestore é dimensionado, a latência começa a diminuir.
- Os pontos críticos limitam a capacidade de o Firestore ser dimensionado. Reveja o artigo Conceber para dimensionamento para identificar pontos críticos.
- Reveja a contenda de dados nas transações e a sua utilização das transações.
- Reduza a taxa de gravação em documentos individuais.
RESOURCE_EXHAUSTED
As seguintes situações podem originar erros RESOURCE_EXHAUSTED:
Excedeu a quota do nível gratuito e a faturação não está ativada para o seu projeto.
Aumentos de tráfego que não seguem as práticas recomendadas
RESOURCE_EXHAUSTED Some resource has been exhausted, perhaps a per-user quota.
Ou
RESOURCE_EXHAUSTED This database has exceeded their daily quota or the ramp up limit for writes, please retry with exponential backoff. To learn more about limits, see 'Usage and limits' section of the support documentation.
Para resolver este problema:
Se atingiu a quota do nível gratuito, aguarde pela reposição diária da quota do nível gratuito ou ative a faturação para o seu projeto.
Para aumentos rápidos de tráfego, o Firestore tenta dimensionar automaticamente para satisfazer o aumento da procura. Quando o Firestore é dimensionado, os erros podem diminuir.
Os pontos críticos limitam a capacidade de expansão do Firestore. Reveja o artigo sobre como criar designs para escala para identificar pontos críticos.
Para consultas de ouvintes em tempo real, certifique-se de que as consultas não são desnecessariamente amplas. Use filtros para reduzir o número de atualizações.
INVALID_ARGUMENT
As seguintes situações podem causar erros INVALID_ARGUMENT:
- Tentativa de confirmar um documento com um valor de campo indexado superior a 1500 bytes. Este limite aplica-se à codificação UTF-8 do valor do campo.
- Está a tentar confirmar um documento com valores de campo não indexados superiores a 1 048 487 bytes (1 MiB - 89 bytes). Este limite aplica-se à soma dos valores dos campos num documento. Por exemplo, quatro campos 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 dos campos. Não pode exceder estes limites, e estes não são quotas que possam ser ajustadas.
INVALID_ARGUMENT: The value of property field-name is longer than 1500 bytes
ou
INVALID_ARGUMENT: The value of property field_name is longer than 1048487 bytes
Para resolver este problema:
- Para valores de campos indexados, divida o campo em vários campos. Se possível, crie um campo não indexado e mova os dados que não precisam de ser indexados para o campo não indexado.
- Para valores de campos não indexados, divida o campo em vários campos ou implemente a compressão para o valor do campo.