Eccezioni

Nota: gli sviluppatori che creano nuove applicazioni sono vivamente consigliati per l'utilizzo della libreria client di NDB, che presenta diversi vantaggi rispetto a questa libreria client, come la memorizzazione automatica delle cache tramite l'API Memcache. Se attualmente utilizzi la libreria client DB precedente, leggi la Guida alla migrazione da database a NDB

Il pacchetto google.appengine.ext.db fornisce le seguenti classi di eccezioni:

exception Errore()

Questa è la classe base per tutte le eccezioni in questo pacchetto.

exception BadArgumentError()
È stato fornito un argomento errato a un metodo di query.
exception BadFilterError()
Una stringa filtro nella query non è valida.
exception BadKeyError()
La stringa della chiave fornita non è una chiave valida.
exception BadPropertyError()
Non è stato possibile creare la proprietà perché il nome non è una stringa.
exception BadQueryError()
La stringa di query non è una query valida.
exception BadRequestError()
La richiesta al servizio di datastore ha una o più proprietà non valide. Ciò è possibile se una sottoclasse di Model sostituisce alcuni metodi (ad esempio kind()) con un'implementazione errata.
exception BadValueError()
Non è stato possibile assegnare un valore alla proprietà perché il valore non è valido per il tipo di proprietà.
exception ConfigurationError()
Una proprietà non è configurata correttamente.
exception DuplicaPropertyError()
Una definizione di modello ha più di una proprietà con lo stesso nome.
exception InternalError()
Si è verificato un errore interno al servizio di datastore. Questa eccezione non significa necessariamente che l'operazione non sia riuscita.
exception KindError()
L'applicazione ha tentato di utilizzare un'entità dati con una classe modello che non corrisponde all'entità.
exception NeedIndexError()
Aumentato quando l'SDK non trova un indice corrispondente per una query che richiede un indice. Controlla la Console di amministrazione per gestire gli indici e il file index.yaml.
exception NotSavedError()
È stata eseguita un'azione che richiede il salvataggio dell'oggetto (put) nell'archivio dati, ma l'oggetto non viene salvato.
exception ProprietàError()
La proprietà del modello a cui si fa riferimento non esiste nell'oggetto dati.
exception referencePropertySolveError()
Il modello a cui si fa riferimento in una Property di riferimento non esiste. Consulta la sezione Riferimenti.
exception PrenotaWordError()
Un modello definisce una proprietà il cui nome non è consentito. Consulta la sezione Nomi delle proprietà non consentiti.
eccezione Rollback()
Indica che una funzione in una transazione vuole eseguire il rollback della transazione anziché eseguirne il commit. Eventuali eccezioni non rilevate in una transazione comportano il rollback della transazione. Questa classe di eccezione è utile per quando una funzione vuole eseguire il rollback e non sono applicabili altre eccezioni.
eccezione Timeout()
Aumentato quando l'operazione di datastore supera il tempo massimo consentito per le operazioni del datastore. Questa eccezione non significa necessariamente che l'operazione non sia riuscita.
exception TransactionFailedError()
Non è stato possibile eseguire l'operazione di transazione o datastore anche dopo un nuovo tentativo. Questo di solito è causato da un'elevata frequenza di contese: i dati vengono aggiornati da molte altre istanze dell'applicazione contemporaneamente e questa istanza non può eseguire il commit della relativa transazione entro un numero fisso di nuovi tentativi. Consulta Transazioni.

Il pacchetto google.appengine.runtime.apiproxy_errors fornisce le seguenti classi di eccezioni:

exception FunzionalitàDisabledError()

Indica che una chiamata API datastore non è stata eseguita perché quella funzionalità datastore non è disponibile.