Nota:gli sviluppatori che creano nuove applicazioni sono fortemente incoraggiati a utilizzare la libreria client NDB, che offre diversi vantaggi rispetto a questa libreria client, ad esempio la memorizzazione automatica nella cache 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 eccezioni:
- eccezione Errore()
-
Questa è la classe base per tutte le eccezioni in questo pacchetto.
- exception 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.
- exception BadPropertyError()
- Impossibile creare la proprietà perché il nome non è una stringa.
- exception BadQueryError()
- La stringa di query non è una query valida.
- eccezione BadRequestError()
- La richiesta al servizio datastore ha una o più proprietà non valide. Ciò è possibile se una sottoclasse di Model esegue l'override di alcuni metodi (ad esempio kind()) con un'implementazione errata.
- exception BadValueError()
- Non è stato possibile assegnare un valore alla proprietà perché non è valido per il tipo di proprietà.
- eccezione ConfigurationError()
- Una proprietà non è configurata correttamente.
- exception DuplicatePropertyError()
- Una definizione del modello ha più di una proprietà con lo stesso nome.
- exception InternalError()
- Si è verificato un errore interno al servizio datastore. Questa eccezione non significa necessariamente che l'operazione non è riuscita.
- eccezione KindError()
- L'applicazione ha tentato di utilizzare un'entità di dati con una classe di modello che non corrisponde all'entità.
- exception NeedIndexError()
- Generato 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.
- exception NotSavedError()
- È stata eseguita un'azione che richiede il salvataggio (inserimento) dell'oggetto nel datastore, ma l'oggetto non è stato salvato.
- eccezione PropertyError()
- La proprietà del modello a cui viene fatto riferimento non esiste nell'oggetto dati.
- exception ReferencePropertyResolveError()
- Il modello a cui fa riferimento una ReferenceProperty non esiste. Consulta la sezione Riferimenti.
- exception ReservedWordError()
- Un modello definisce una proprietà il cui nome non è consentito. Vedi Nomi delle proprietà non consentiti.
- eccezione Rollback()
- Indica che una funzione in una transazione vuole eseguire il rollback della transazione anziché eseguirne il commit. Qualsiasi eccezione non rilevata in una transazione causerà il rollback della transazione. Questa classe di eccezioni è utile quando una funzione vuole eseguire il rollback e non si applica nessun'altra eccezione.
- eccezione Timeout()
- Generato quando l'operazione di datastore supera il tempo massimo consentito per le operazioni di datastore. Questa eccezione non significa necessariamente che l'operazione non è riuscita.
- exception TransactionFailedError()
- Non è stato possibile eseguire il commit dell'operazione di transazione o datastore, anche dopo aver riprovato. Ciò è in genere causato da un elevato tasso di contesa: i dati vengono aggiornati contemporaneamente da molte altre istanze dell'applicazione e questa istanza non è riuscita a eseguire il commit della transazione entro un numero fisso di tentativi. Vedi Transazioni.
Il pacchetto google.appengine.runtime.apiproxy_errors fornisce le seguenti classi di eccezioni:
- exception CapabilityDisabledError()
-
Indica che una chiamata API datastore non è stata eseguita perché la funzionalità datastore specifica non è disponibile.