Exceções

Observação: os desenvolvedores que criam novos aplicativos são bastante incentivados a usar a Biblioteca de cliente NDB, que oferece diversos benefícios em comparação com esta biblioteca de cliente, como armazenamento em cache automático de entidades por meio da API Memcache. Se você estiver usando a antiga biblioteca de cliente DB, leia o Guia de migração de DB para NDB.

O pacote google.appengine.ext.db oferece as seguintes classes de exceção:

exception Error()

Classe básica de todas as exceções neste pacote.

exception BadArgumentError()

Foi fornecido um argumento inválido a um método de consulta.

exception BadFilterError()

Uma string de filtro da consulta é inválida.

exception BadKeyError()

A string de chave fornecida não é uma chave válida.

exception BadPropertyError()

Não foi possível criar a propriedade porque o respectivo nome não é uma string.

exception BadQueryError()

A string de consulta não é uma consulta válida.

exception BadRequestError()

A solicitação ao serviço do armazenamento de dados apresenta uma ou mais propriedades inválidas. Isso é possível quando uma subclasse de Modelo substitui alguns métodos (como kind()) por uma implementação incorreta.

exception BadValueError()

Não foi possível atribuir um valor à propriedade porque o valor é inválido para esse tipo de propriedade.

exception ConfigurationError()

Uma propriedade não está configurada corretamente.

exception DuplicatePropertyError()

Uma definição de modelo apresenta mais de uma propriedade com o mesmo nome.

exception InternalError()

Ocorreu um erro interno no serviço do armazenamento de dados. Esta exceção não significa necessariamente que a operação falhou.

exception KindError()

O aplicativo tentou usar uma entidade de dados com uma classe de modelo que não corresponde à entidade.

exception NeedIndexError()

Gerado quando o SDK não encontra um índice correspondente para uma consulta que requer um. Verifique o Console de administração para gerenciar os índices e o arquivo index.yaml.

exception NotSavedError()

Foi realizada uma ação que exige que o objeto tenha sido salvo (put) no armazenamento de dados, mas o objeto não está salvo.

exception PropertyError()

A propriedade do modelo referida não existe no objeto de dados.

exception ReferencePropertyResolveError()

O modelo referenciado por um ReferenceProperty não existe. Consulte Referências.

exception ReservedWordError()

Um modelo define uma propriedade com nome não permitido. Consulte Nomes de propriedade não permitidos.

exception Rollback()

Indica que uma função de uma transação quer reverter a transação em vez de executá-la. Qualquer exceção não percebida em uma transação fará com que esta seja revertida. Esta classe de exceção é conveniente quando uma função quer reverter e não há nenhuma outra exceção aplicável.

exception Timeout()

Emitido quando a operação do armazenamento de dados excede o período máximo de tempo permitido para operações do armazenamento de dados. Esta exceção não significa necessariamente que a operação falhou.

exception TransactionFailedError()

A transação ou operação com o armazenamento de dados não pode ser executada, mesmo após uma nova tentativa. Isto normalmente é causado por uma alta taxa de contenção. Os dados estão sendo atualizados simultaneamente por diversas outras instâncias de aplicativos e esta instância não conseguiu executar sua transação dentro de um número fixo de tentativas. Consulte Transações.

O pacote google.appengine.runtime.apiproxy_errors oferece as seguintes classes de exceção:

exception CapabilityDisabledError()

Indica que uma chamada à API de armazenamento de dados não foi realizada, porque esta funcionalidade específica de armazenamento de dados não está disponível.