Nota: gli sviluppatori che creano nuove applicazioni sono vivamente incoraggiati a utilizzare la libreria client NDB, che offre diversi vantaggi rispetto a questa libreria client, come la memorizzazione automatica nella cache delle entità tramite l'API Memcache. Se attualmente utilizzi la libreria client di DB precedente, leggi la guida alla migrazione da DB a NDB
Il pacchetto google.appengine.ext.db fornisce le seguenti classi di eccezioni:
- eccezione Errore()
-
Questa è la classe base per tutte le eccezioni in questo pacchetto.
- eccezione BadArgumentError()
- È stato assegnato un argomento non valido a un metodo di query.
- eccezione BadFilterError()
- Una stringa di filtro nella query non è valida.
- eccezione BadKeyError()
- La stringa di chiave fornita non è una chiave valida.
- exception BadPropertyError()
- Impossibile creare la proprietà perché il nome non è una stringa.
- eccezione BadQueryError()
- La stringa di query non è una query valida.
- eccezione BadRequestError()
- La richiesta al servizio datastore ha una o più proprietà non valide. Questo è possibile se una sottoclasse di Model esegue l'override di alcuni metodi (ad esempio kind()) con un'implementazione errata.
- eccezione BadValueError()
- Impossibile assegnare un valore alla proprietà perché non è valido per il tipo di proprietà.
- eccezione ConfigurationError()
- Una proprietà non è configurata correttamente.
- exception DuplicatePropertyError()
- Una definizione di modello ha più proprietà con lo stesso nome.
- eccezione InternalError()
- Si è verificato un errore interno al servizio datastore. Questa eccezione non significa necessariamente che l'operazione non sia riuscita.
- eccezione KindError()
- L'applicazione ha tentato di utilizzare un'entità di dati con una classe del modello che non corrisponde all'entità.
- eccezione NeedIndexError()
- Aumentato quando l'SDK non trova un indice corrispondente per una query che ne richiede uno. Controlla la console di amministrazione per gestire gli indici e il file index.yaml.
- eccezione NotSavedError()
- È stata eseguita un'azione che richiede che l'oggetto sia stato salvato (put) nel datastore, ma che l'oggetto non venga salvato.
- exception PropertyError()
- La proprietà del modello di riferimento non esiste nell'oggetto dati.
- exception ReferencePropertyResolveError()
- Il modello a cui fa riferimento un valore ReferenceProperty non esiste. Consulta la sezione Riferimenti.
- exception ReservedWordError()
- 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 invece di eseguirne il commit. Qualsiasi eccezione non rilevata in una transazione comporterà il rollback della transazione. Questa classe di eccezione è utile quando è necessario eseguire il rollback di una funzione e non si applica nessun'altra eccezione.
- eccezione Timeout()
- Aumentato quando le operazioni del datastore superano il tempo massimo consentito per le operazioni nel datastore. Questa eccezione non significa necessariamente che l'operazione non sia riuscita.
- eccezione TransactionFailedError()
- Impossibile eseguire il commit dell'operazione di transazione o datastore, anche dopo aver riprovato. Questo è causato di solito da un'elevata percentuale di conflitti: i dati vengono aggiornati contemporaneamente da molte altre istanze di applicazione e questa istanza non è riuscita a eseguire il commit della transazione entro un numero fisso di nuovi tentativi. Vedi Transazioni.
Il pacchetto google.appengine.runtime.apiproxy_errors fornisce le seguenti classi di eccezioni:
- eccezione CapabilityDisabledError()
-
Indica che non è stata eseguita una chiamata all'API datastore perché questa particolare funzionalità del datastore non è disponibile.