Eccezioni

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, ad esempio la memorizzazione nella cache automatica delle entità tramite l'API Memcache. Se al momento utilizzi la libreria client DB precedente, leggi la guida alla migrazione da DB a NDB

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

eccezione Error()

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

Eccezione BadArgumentError()

È stato fornito un argomento non valido a un metodo di query.

Eccezione BadFilterError()

Una stringa di filtro nella query non è valida.

Eccezione BadKeyError()

La stringa della chiave fornita non è una chiave valida.

eccezione BadPropertyError()

Impossibile creare la proprietà perché il nome non è una stringa.

eccezione BadQueryError()

La stringa di query non è valida.

Eccezione BadRequestError()

La richiesta al servizio di datastore contiene una o più proprietà non valide. Ciò è possibile se una sottoclasse di Model sostituisce alcuni metodi (ad esempio kind()) con un'implementazione errata.

eccezione BadValueError()

Non è stato possibile assegnare un valore alla proprietà perché non è valido per il tipo di proprietà.

eccezione ConfigurationError()

Una proprietà non è configurata correttamente.

eccezione DuplicatePropertyError()

Una definizione del modello ha più di una proprietà con lo stesso nome.

eccezione InternalError()

Si è verificato un errore interno al servizio del data store. 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 di modello non corrispondente all'entità.

Eccezione NeedIndexError()

Rilevato 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 (inserito) nel data store, ma l'oggetto non è stato salvato.

Eccezione PropertyError()

La proprietà del modello a cui si fa riferimento non esiste nell'oggetto dati.

eccezione ReferencePropertyResolveError()

Il modello a cui fa riferimento una ReferenceProperty non esiste. Consulta la sezione Riferimenti.

Eccezione ReservedWordError()

Un modello definisce una proprietà il cui nome non è consentito. Consulta Nomi 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 ne causeranno il rollback. Questa classe di eccezione è per comodità, quando una funzione vuole eseguire il rollback e non si applicano altre eccezioni.

eccezione Timeout()

Eccede quando l'operazione del datastore supera il tempo massimo consentito per le operazioni del datastore. Questa eccezione non significa necessariamente che l'operazione non sia riuscita.

eccezione TransactionFailedError()

Non è stato possibile eseguire il commit della transazione o dell'operazione del data store, anche dopo aver riprovato. Questo problema è in genere causato da un tasso elevato di contesa: i dati vengono aggiornati contemporaneamente da molte altre istanze dell'applicazione e questa istanza non è riuscita a eseguire l'commit della transazione entro un numero fisso di tentativi. Vedi Transazioni.

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

eccezione CapabilityDisabledError()

Indica che non è stata eseguita una chiamata all'API del data store perché la funzionalità del data store in questione non è disponibile.