Note:Developers building new applications arestrongly encouraged to use theNDB Client Library, which has several benefitscompared to this client library, such as automatic entity caching via the MemcacheAPI. If you are currently using the older DB Client Library, read theDB to NDB Migration Guide

Thegoogle.appengine.ext.db package provides the following exception classes:

exception Error()

This is the base class for all exceptions in this package.

exception BadArgumentError()

A bad argument was given to a query method.

exception BadFilterError()

A filter string in the query is invalid.

exception BadKeyError()

The provided key string is not a valid key.

exception BadPropertyError()

The property could not be created because its name is not a string.

exception BadQueryError()

The query string is not a valid query.

exception BadRequestError()

The request to the datastore service has one or more invalid properties. This is possible if a subclass ofModel overrides some methods (such askind()) with an incorrect implementation.

exception BadValueError()

The property could not be assigned a value because the value is invalid for the property type.

exception ConfigurationError()

A property is not configured correctly.

exception DuplicatePropertyError()

A model definition has more than one property with the same name.

exception InternalError()

There was an error internal to the datastore service. This exception does not necessarily mean that the operation failed.

exception KindError()

The application attempted to use a data entity with a model class that does not match the entity.

exception NeedIndexError()

Raised when the SDK does not find a matching index for a query that requires one. Check theAdministration Console to manage your indexes and yourindex.yaml file.

exception NotSavedError()

An action was performed that requires the object to have been saved (put) to the datastore, but the object is not saved.

exception PropertyError()

The referenced model property does not exist on the data object.

exception ReferencePropertyResolveError()

The model referenced by aReferenceProperty does not exist. SeeReferences.

exception ReservedWordError()

A model defines a property whose name is disallowed. SeeDisallowed Property Names.

exception Rollback()

Indicates that a function in a transaction wants to roll back the transaction instead of committing it. Any uncaught exception in a transaction will cause the transaction to roll back. This exception class is for convenience, when a function wants to roll back and no other exception applies.

exception Timeout()

Raised when the datastore operation exceeds the maximum amount of time allowed for datastore operations. This exception does not necessarily mean that the operation failed.

exception TransactionFailedError()

The transaction or datastore operation could not be committed, even after retrying. This is usually caused by a high rate of contention: The data is being updated by many other application instances simultaneously, and this instance could not commit its transaction within a fixed number of retries. SeeTransactions.

Thegoogle.appengine.runtime.apiproxy_errors package provides the following exception classes:

exception CapabilityDisabledError()

Indicates that a datastore api call was not performed as that particular datastore functionality is not available.