Comprendre les codes d'erreur

Cette page liste les codes d'erreur que vous pouvez rencontrer et fournit des suggestions pour les résoudre.

DEADLINE_EXCEEDED

La situation suivante peut provoquer un nombre plus important d'erreurs DEADLINE_EXCEEDED :

  • Une augmentation de la latence a entraîné un dépassement du délai par l'opération (60 secondes par défaut).
DEADLINE_EXCEEDED

A deadline was exceeded on the server.

Pour résoudre ce problème, consultez le guide de résolution des problèmes de latence.

ABORTED

Les situations suivantes peuvent provoquer un nombre plus important d'erreurs ABORTED :

  • Un document qui reçoit trop de mises à jour par seconde.
  • Contention imputable aux transactions qui se chevauchent
  • Augmentation du trafic dépassant la règle des 500-50-5 ou présence de hotspots
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.

Pour remédier à ce problème :

  • Pour augmenter le trafic rapidement, Firestore tente d'effectuer un scaling automatique afin de répondre à l'accroissement de la demande. Lorsque Firestore effectue un scaling, la latence diminue.
  • Les hotspots limitent la capacité de Firestore à évoluer à la hausse. Consultez la page Concevoir des solutions évolutives pour identifier les hotspots.
  • Examinez la contention des données dans les transactions et votre utilisation des transactions.
  • Réduisez le taux d'écriture sur des documents individuels.

RESOURCE_EXHAUSTED

Les situations suivantes peuvent provoquer des erreurs RESOURCE_EXHAUSTED :

  • Vous avez dépassé le quota sans frais et la facturation n'est pas activée pour votre projet.
RESOURCE_EXHAUSTED

Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.

Pour remédier à ce problème :

INVALID_ARGUMENT

Les situations suivantes peuvent entraîner des erreurs INVALID_ARGUMENT:

  • Tentative de commit d'un document dont la valeur du champ indexed est supérieure à 1 500 octets. Cette limite s'applique à l'encodage UTF-8 de la valeur du champ.
  • Tentative de commit d'un document dont les valeurs de champ non indexées sont supérieures que 1 048 487 octets (1 Mio – 89 octets). Cette limite s'applique à la somme des valeurs des champs d'un document. Par exemple, quatre champs de 256 Kio chacun dépasse la limite.

1 500 octets (indexés) et 1 048 487 octets (non indexés) sont limits pour les valeurs de champ. Vous ne pouvez pas dépassent ces limites, et il ne s'agit pas de quotas ajusté.

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

Pour remédier à ce problème :

  • Pour les valeurs de champ indexées, fractionnez le champ en plusieurs champs. Si possible, créez un champ non indexé et déplacer les données qui n'ont pas besoin d'être indexées dans le dossier .
  • Pour les valeurs de champ non indexées, divisez le champ en plusieurs champs ou implémentez une compression pour la valeur du champ.