Nota: os programadores que criam novas aplicações são fortemente aconselhados a usar a biblioteca de cliente NDB, que tem várias vantagens em comparação com esta biblioteca de cliente, como o armazenamento em cache automático de entidades através da API Memcache. Se estiver a usar atualmente a biblioteca cliente DB mais antiga, leia o guia de migração de DB para NDB
O pacote google.appengine.ext.db fornece as seguintes classes de exceções:
- exception Error()
-
Esta é a classe base para todas as exceções neste pacote.
- exceção BadArgumentError()
- Foi fornecido um argumento incorreto a um método de consulta.
- exception BadFilterError()
- Uma string de filtro na consulta é inválida.
- exceção BadKeyError()
- A string de chave fornecida não é uma chave válida.
- exception BadPropertyError()
- Não foi possível criar a propriedade porque o respetivo nome não é uma string.
- exception BadQueryError()
- A cadeia de consulta não é uma consulta válida.
- exception BadRequestError()
- O pedido ao serviço de armazenamento de dados tem uma ou mais propriedades inválidas. Isto é possível se uma subclasse de Model substituir 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 o tipo de propriedade.
- exception ConfigurationError()
- Uma propriedade não está configurada corretamente.
- exception DuplicatePropertyError()
- Uma definição de modelo tem mais do que uma propriedade com o mesmo nome.
- exception InternalError()
- Ocorreu um erro interno no serviço de armazenamento de dados. Esta exceção não significa necessariamente que a operação falhou.
- exceção KindError()
- A aplicação tentou usar uma entidade de dados com uma classe de modelo que não corresponde à entidade.
- exceção NeedIndexError()
- Gerado quando o SDK não encontra um índice correspondente para uma consulta que requer um. Consulte a consola de administração para gerir os seus índices e o ficheiro index.yaml.
- exception NotSavedError()
- Foi realizada uma ação que requer que o objeto tenha sido guardado (colocado) no repositório de dados, mas o objeto não foi guardado.
- exceção PropertyError()
- A propriedade do modelo referenciada não existe no objeto de dados.
- exception ReferencePropertyResolveError()
- O modelo referenciado por uma ReferenceProperty não existe. Consulte as Referências.
- exception ReservedWordError()
- Um modelo define uma propriedade cujo nome não é permitido. Consulte a secção Nomes de propriedades não permitidos.
- exceção Rollback()
- Indica que uma função numa transação quer reverter a transação em vez de a confirmar. Qualquer exceção não capturada numa transação faz com que a transação seja revertida. Esta classe de exceção destina-se a conveniência, quando uma função quer reverter e não se aplica nenhuma outra exceção.
- exceção Timeout()
- Gerado quando a operação da base de dados excede o tempo máximo permitido para operações da base de dados. Esta exceção não significa necessariamente que a operação falhou.
- exceção TransactionFailedError()
- Não foi possível confirmar a transação ou a operação de armazenamento de dados, mesmo após novas tentativas. Normalmente, isto deve-se a uma elevada taxa de contenção: os dados estão a ser atualizados por muitas outras instâncias da aplicação em simultâneo, e esta instância não conseguiu confirmar a respetiva transação num número fixo de novas tentativas. Consulte Transações.
O pacote google.appengine.runtime.apiproxy_errors fornece as seguintes classes de exceções:
- exception CapabilityDisabledError()
-
Indica que não foi feita uma chamada à API datastore porque essa funcionalidade específica do datastore não está disponível.