Excepciones
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Nota: Se recomienda enfáticamente a los desarrolladores que compilan aplicaciones nuevas que usen la biblioteca cliente de NDB, ya que tiene muchas ventajas en comparación con esta biblioteca cliente, como el almacenamiento en caché automático de entidades mediante la API de Memcache. Si por el momento usas la biblioteca cliente de DB anterior, lee la Guía de migración de DB a NDB.
El paquete google.appengine.ext.db
proporciona las siguientes clases de excepción:
- exception Error()
-
Esta es la clase básica para todas las excepciones en este paquete.
- exception BadArgumentError()
- Se proporcionó un argumento incorrecto a un método de consulta.
- exception BadFilterError()
- Una string de filtro en la consulta no es válida.
- exception BadKeyError()
- La string de clave proporcionada no es una clave válida.
- exception BadPropertyError()
- La propiedad quizá no se creó porque su nombre no es una string.
- exception BadQueryError()
- La string de consulta no es una consulta válida.
- exception BadRequestError()
- La solicitud al servicio de almacén de datos tiene una o más propiedades no válidas. Esto es posible si una subclase de Model anula algunos métodos (como kind()) con una implementación incorrecta.
- exception BadValueError()
- No se le pudo asignar un valor a la propiedad porque no es válido para el tipo de propiedad.
- exception ConfigurationError()
- Una propiedad no se configuró correctamente.
- exception DuplicatePropertyError()
- Una definición de modelo tiene más de una propiedad con el mismo nombre.
- exception InternalError()
- Hubo un error interno en el servicio de almacén de datos. Esta excepción no necesariamente significa que la operación falló.
- exception KindError()
- La aplicación intentó usar una entidad de datos con una clase de modelo con la que no coincide.
- exception NeedIndexError()
- Se arroja cuando el SDK no encuentra un índice que coincida con una consulta que lo necesita. Verifica la Consola del administrador para administrar los índices y el archivo index.yaml.
- exception NotSavedError()
- Se realizó una acción que requiere que el objeto se guarde (coloque) en el almacén de datos, pero no se guardó.
- exception PropertyError()
- La propiedad de modelo referida no existe en el objeto de datos.
- exception ReferencePropertyResolveError()
- No existe el modelo al que hace referencia una ReferenceProperty. Consulta Referencias.
- exception ReservedWordError()
- Un modelo define una propiedad cuyo nombre no está permitido. Consulta Nombres de propiedad no permitidos.
- exception Rollback()
- Indica que una función en una transacción quiere revertir la transacción en vez de confirmarla. Cualquier excepción no detectada en una transacción provocará que esta se revierta. Esta clase de excepción es por conveniencia, cuando una función quiere revertir y no se aplica otra excepción.
- exception Timeout()
- Se arroja cuando la operación del almacén de datos excede la cantidad máxima de tiempo permitido para estas operaciones. Esta excepción no necesariamente significa que la operación falló.
- exception TransactionFailedError()
- La transacción o la operación del almacén de datos no se confirmó, aun después de reintentar. Usualmente, una tasa de contención alta provoca esto: Muchas otras instancias de aplicaciones actualizan los datos simultáneamente y esta instancia no pudo confirmar la transacción en un número fijo de reintentos. Consulta Transacciones.
El paquete google.appengine.runtime.apiproxy_errors
proporciona las siguientes clases de excepción:
- exception CapabilityDisabledError()
-
Indica que no se realizó una llamada a la API por parte del almacén de datos, ya que esta funcionalidad en particular no está disponible.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-04 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eDevelopers are highly recommended to utilize the NDB Client Library for new applications due to its enhanced features like automatic entity caching.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egoogle.appengine.ext.db\u003c/code\u003e package offers a range of exception classes to handle various errors related to datastore operations, including issues with arguments, filters, keys, properties, and queries.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egoogle.appengine.runtime.apiproxy_errors\u003c/code\u003e package includes the \u003ccode\u003eCapabilityDisabledError\u003c/code\u003e exception, which signals when a specific datastore functionality is not accessible.\u003c/p\u003e\n"],["\u003cp\u003eSeveral exceptions in \u003ccode\u003egoogle.appengine.ext.db\u003c/code\u003e highlight potential issues in model definition and data consistency, such as \u003ccode\u003eDuplicatePropertyError\u003c/code\u003e, \u003ccode\u003eKindError\u003c/code\u003e, \u003ccode\u003ePropertyError\u003c/code\u003e, \u003ccode\u003eReferencePropertyResolveError\u003c/code\u003e, and \u003ccode\u003eReservedWordError\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe package provides specific error handling for transaction-related issues with classes like \u003ccode\u003eRollback\u003c/code\u003e, and \u003ccode\u003eTransactionFailedError\u003c/code\u003e to help in situations where a transaction needs to be rolled back, or a transaction could not be committed.\u003c/p\u003e\n"]]],[],null,["# Exceptions\n\n**Note:**\nDevelopers building new applications are **strongly encouraged** to use the\n[NDB Client Library](/appengine/docs/legacy/standard/python/ndb), which has several benefits\ncompared to this client library, such as automatic entity caching via the Memcache\nAPI. If you are currently using the older DB Client Library, read the\n[DB to NDB Migration Guide](/appengine/docs/legacy/standard/python/ndb/db_to_ndb)\n\nThe `google.appengine.ext.db` package provides the following exception classes:\n\nexception Error()\n\n: This is the base class for all exceptions in this package.\n\nexception BadArgumentError()\n: A bad argument was given to a query method.\n\nexception BadFilterError()\n: A filter string in the query is invalid.\n\nexception BadKeyError()\n: The provided key string is not a valid key.\n\nexception BadPropertyError()\n: The property could not be created because its name is not a string.\n\nexception BadQueryError()\n: The query string is not a valid query.\n\nexception BadRequestError()\n: The request to the datastore service has one or more invalid properties. This is possible if a subclass of [Model](/appengine/docs/legacy/standard/python/datastore/modelclass) overrides some methods (such as [kind()](/appengine/docs/legacy/standard/python/datastore/modelclass#Model_kind)) with an incorrect implementation.\n\nexception BadValueError()\n: The property could not be assigned a value because the value is invalid for the property type.\n\nexception ConfigurationError()\n: A property is not configured correctly.\n\nexception DuplicatePropertyError()\n: A model definition has more than one property with the same name.\n\nexception InternalError()\n: There was an error internal to the datastore service. This exception does not necessarily mean that the operation failed.\n\nexception KindError()\n: The application attempted to use a data entity with a model class that does not match the entity.\n\nexception NeedIndexError()\n: Raised when the SDK does not find a matching index for a query that requires one. Check the [Administration Console](/appengine/docs/adminconsole) to manage your indexes and your [index.yaml](/appengine/docs/legacy/standard/python/config/indexconfig#creating_datastore_indexes) file.\n\nexception NotSavedError()\n: An action was performed that requires the object to have been saved (put) to the datastore, but the object is not saved.\n\nexception PropertyError()\n: The referenced model property does not exist on the data object.\n\nexception ReferencePropertyResolveError()\n: The model referenced by a [ReferenceProperty](/appengine/docs/legacy/standard/python/datastore/typesandpropertyclasses#ReferenceProperty) does not exist. See [References](/appengine/docs/legacy/standard/python/datastore/datamodeling#References).\n\nexception ReservedWordError()\n: A model defines a property whose name is disallowed. See [Disallowed Property Names](/appengine/docs/legacy/standard/python/datastore/modelclass#Disallowed_Property_Names).\n\nexception Rollback()\n: 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.\n\nexception Timeout()\n: 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.\n\nexception TransactionFailedError()\n: 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. See [Transactions](/appengine/docs/legacy/standard/python/datastore/transactions).\n\nThe `google.appengine.runtime.apiproxy_errors` package provides the following exception classes:\n\nexception CapabilityDisabledError()\n\n: Indicates that a datastore api call was not performed as that particular datastore functionality is not available."]]