Exceptions

Remarque : Les développeurs qui créent des applications sont vivement encouragés à utiliser la bibliothèque cliente NDB qui présente plusieurs avantages supplémentaires par rapport à cette bibliothèque cliente, tels que la mise en cache automatique des entités via l'API Memcache. Si vous utilisez actuellement l'ancienne bibliothèque cliente DB, consultez le guide de migration de DB vers NDB.

Le package google.appengine.ext.db fournit les classes d'exceptions suivantes :

exception Error()

Il s'agit de la classe de base destinée à toutes les exceptions de ce package.

exception BadArgumentError()
Vous avez fourni un argument incorrect à une méthode de requête.
exception BadFilterError()
Une chaîne de filtre contenue dans la requête n'est pas valide.
exception BadKeyError()
La chaîne de clé fournie n'est pas une clé valide.
exception BadPropertyError()
Impossible de créer la propriété, car son nom n'est pas une chaîne.
exception BadQueryError()
La chaîne de requête n'est pas une requête valide.
exception BadRequestError()
La requête envoyée au service Datastore contient une ou plusieurs propriétés non valides. Cela peut se produire si une sous-classe de Model remplace certaines méthodes (telles que kind()) par une mise en œuvre incorrecte.
exception BadValueError()
Une valeur n'a pas pu être attribuée à la propriété, car cette valeur n'est pas valide pour le type de propriété.
exception ConfigurationError()
Une propriété n'est pas configurée correctement.
exception DuplicatePropertyError()
Une définition de modèle contient plusieurs propriétés du même nom.
exception InternalError()
Une erreur interne au service Datastore s'est produite. Cette exception ne signifie pas nécessairement que l'opération a échoué.
exception KindError()
L'application a tenté d'utiliser une entité de données avec une classe Model qui ne correspond pas à l'entité.
exception NeedIndexError()
Exception générée lorsque le SDK ne trouve pas d'index correspondant pour une requête qui en nécessite un. Consultez la Console d'administration pour gérer les index et le fichier index.yaml.
exception NotSavedError()
Vous avez effectué une action qui nécessite que l'objet ait été enregistré (put) dans le datastore, mais il ne l'est pas.
exception PropertyError()
La propriété de modèle référencée n'existe pas sur l'objet de données.
exception ReferencePropertyResolveError()
Le modèle référencé par une classe ReferenceProperty n'existe pas. Consultez la section Références.
exception ReservedWordError()
Un modèle définit une propriété dont le nom n'est pas autorisé. Consultez la section Noms de propriétés non autorisés.
exception Rollback()
Indique qu'une fonction contenue dans une transaction veut effectuer un rollback de la transaction au lieu d'un commit. Toute exception non détectée dans une transaction engendre l'annulation de la transaction. Cette classe d'exception s'utilise par commodité, lorsqu'une fonction veut annuler la transaction et qu'il n'existe aucune autre exception applicable.
exception Timeout()
Exception générée lorsque l'opération de datastore dépasse le délai maximal autorisé pour ce type d'opérations. Cette exception ne signifie pas nécessairement que l'opération a échoué.
exception TransactionFailedError()
Impossible d'effectuer un commit de la transaction ou de l'opération de datastore, même après une nouvelle tentative. Cet échec s'explique habituellement par un taux élevé de contention : les données sont mises à jour simultanément par de nombreuses autres instances, et cette instance n'a pas réussi à valider (commit) sa transaction après un nombre fixe de tentatives. Pour en savoir plus, consultez la page Transactions.

Le package google.appengine.runtime.apiproxy_errors fournit les classes d'exceptions suivantes :

exception CapabilityDisabledError()

Indique qu'un appel d'API Datastore n'a pas été effectué, car cette fonctionnalité de magasin de données en particulier n'est pas disponible.