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 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 di base per tutte le eccezioni in questo pacchetto.
- Eccezione BadArgumentError()
- È stato assegnato un argomento non valido a un metodo di query.
- exception BadFilterError()
- Una stringa di filtro nella query non è valida.
- Eccezione BadKeyError()
- La stringa di chiave fornita non è una chiave valida.
- eccezione BadPropertyError()
- Impossibile creare la proprietà perché il nome non è una stringa.
- exception BadQueryError()
- La stringa di query non è 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.
- exception 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à.
- exception 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 (inserito) nel data store, ma l'oggetto non è stato salvato.
- exception PropertyError()
- La proprietà del modello a cui si fa riferimento non esiste nell'oggetto dati.
- exception 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 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 è per comodità, quando una funzione vuole eseguire il rollback e non si applicano altre eccezioni.
- 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. Consulta la sezione Transazioni.
Il pacchetto google.appengine.runtime.apiproxy_errors fornisce le seguenti classi di eccezione:
- exception CapabilityDisabledError()
-
Indica che non è stata eseguita una chiamata all'API del data store perché la funzionalità del data store in questione non è disponibile.