Eccezioni

Nota: Gli sviluppatori che creano nuove applicazioni sono vivamente incoraggiati a utilizzare il Libreria client NDB, che offre numerosi vantaggi rispetto a questa libreria client, come la memorizzazione automatica nella cache delle entità tramite tramite Google Cloud CLI o tramite l'API Compute Engine. Se al momento utilizzi la libreria client DB precedente, leggi il 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.
exception BadArgumentError(): È stato assegnato un argomento non valido a un metodo di query.
exception BadFilterError(): Una stringa di filtro nella query non è valida.
exception BadKeyError(): La stringa di chiave fornita non è una chiave valida.
exception BadPropertyError(): Impossibile 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 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.
exception BadValueError(): Impossibile assegnare un valore alla proprietà perché non è valido per il tipo di proprietà.
exception 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 indica necessariamente che l'operazione non sia riuscita.
exception 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 si fa riferimento in 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.
exception 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 nel datastore superano il tempo massimo consentito per le operazioni nel datastore. Questa eccezione non significa necessariamente che l'operazione non sia riuscita.
exception 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:

exception CapabilityDisabledError(): Indica che non è stata eseguita una chiamata all'API datastore perché questa particolare funzionalità del datastore non è disponibile.