Python 2.7 telah mencapai akhir dukungan
dan akan
dihentikan penggunaannya
pada 31 Januari 2026. Setelah penghentian penggunaan, Anda tidak akan dapat men-deploy aplikasi Python 2.7, meskipun organisasi Anda sebelumnya menggunakan kebijakan organisasi untuk mengaktifkan kembali deployment runtime lama. Aplikasi Python 2.7 yang ada akan terus berjalan dan menerima traffic setelah
tanggal penghentiannya. Sebaiknya Anda
bermigrasi ke versi Python terbaru yang didukung.
Pengecualian
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Catatan:
Developer yang membuat aplikasi baru sangat dianjurkan untuk menggunakan
Library Klien NDB, yang memiliki beberapa manfaat
dibandingkan dengan library klien ini, seperti menyimpan entity dalam cache secara otomatis melalui Memcache API. Jika saat ini Anda menggunakan Library Klien DB versi lama, baca
Panduan Migrasi DB ke NDB
Paket google.appengine.ext.db
menyediakan class pengecualian berikut:
- exception Error()
-
Ini adalah class dasar untuk semua pengecualian dalam paket ini.
- exception BadArgumentError()
- Argumen yang buruk diberikan ke metode kueri.
- exception BadFilterError()
- String filter dalam kueri tidak valid.
- exception BadKeyError()
- String kunci yang diberikan bukan kunci yang valid.
- exception BadPropertyError()
- Properti tidak dapat dibuat karena namanya bukan berupa string.
- exception BadQueryError()
- String kueri bukan kueri yang valid.
- exception BadRequestError()
- Permintaan ke layanan datastore memiliki satu atau beberapa properti yang tidak valid. Hal ini mungkin terjadi jika subclass Model mengganti beberapa metode (seperti jenis()) dengan implementasi yang salah.
- exception BadValueError()
- Properti tidak dapat diberi nilai karena nilai tidak valid untuk jenis properti tersebut.
- exception ConfigurationError()
- Properti tidak dikonfigurasi dengan benar.
- exception DuplicatePropertyError()
- Definisi model memiliki lebih dari satu properti dengan nama yang sama.
- exception InternalError()
- Terjadi error internal pada layanan datastore. Pengecualian ini tidak selalu berarti operasi gagal.
- exception KindError()
- Aplikasi mencoba menggunakan entity data dengan class model yang tidak cocok dengan entity.
- exception NeedIndexError()
- Diajukan saat SDK tidak menemukan indeks yang cocok untuk kueri yang memerlukannya. Periksa Administration Console untuk mengelola indeks dan file index.yaml Anda.
- exception NotSavedError()
- Tindakan yang dilakukan mengharuskan objek telah disimpan (dimasukkan) ke datastore, tetapi objek tidak disimpan.
- exception PropertyError()
- Properti model yang direferensikan tidak ada di objek data.
- exception ReferencePropertyResolveError()
- Model yang dirujuk oleh ReferenceProperty tidak ada. Lihat Referensi.
- exception ReservedWordError()
- Model menentukan properti yang namanya tidak diizinkan. Lihat Nama Properti yang Tidak Diizinkan.
- exception Rollback()
- Menunjukkan bahwa suatu fungsi dalam transaksi ingin me-roll back transaksi, bukan melakukan commit. Setiap pengecualian yang tidak tertangkap dalam transaksi akan menyebabkan transaksi di-roll back. Class pengecualian ini ditujukan untuk memudahkan saat suatu fungsi ingin melakukan roll back dan tidak ada pengecualian lain yang berlaku.
- exception Timeout()
- Terjadi saat operasi datastore melebihi jumlah waktu maksimum yang diizinkan untuk operasi datastore. Pengecualian ini tidak selalu berarti operasi gagal.
- exception TransactionFailedError()
- Operasi transaksi atau datastore tidak dapat di-commit, bahkan setelah mencoba lagi. Hal ini biasanya disebabkan oleh tingkat contention yang tinggi: Data sedang diperbarui oleh banyak instance aplikasi lain secara bersamaan, dan instance ini tidak dapat meng-commit transaksinya dalam jumlah percobaan ulang yang tetap. Lihat Transaksi.
Paket google.appengine.runtime.apiproxy_errors
menyediakan class pengecualian berikut:
- exception CapabilityDisabledError()
-
Menunjukkan bahwa panggilan API datastore tidak dijalankan karena fungsi datastore tertentu tidak tersedia.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-09-04 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]