附註:我們強烈建議建構新應用程式的開發人員使用 NDB 用戶端程式庫,因為 NDB 用戶端程式庫與本用戶端程式庫相較之下有幾個優點,例如能透過 Memcache API 自動將實體加入快取。如果您目前使用的是舊版的 DB 用戶端程式庫,請參閱從 DB 遷移至 NDB 的指南。
google.appengine.ext.db
套件提供下列的例外狀況類別:
- exception Error()
這是本套件中所有例外狀況的基底類別。
- exception BadArgumentError()
- 提供查詢方法不正確的引數。
- exception BadFilterError()
- 查詢中的篩選器字串無效。
- exception BadKeyError()
- 提供的金鑰字串不是有效的金鑰。
- exception BadPropertyError()
- 無法建立屬性,因為屬型名稱不是字串。
- exception BadQueryError()
- 查詢字串不是有效的查詢。
- exception BadRequestError()
- 對資料儲存庫服務的要求有一或多個無效的屬性。當 Model 的子類別以錯誤的方式覆寫某些方法 (例如 kind()) 時,就可能會發生這種例外狀況。
- exception BadValueError()
- 無法將值指派給屬性,因為這個值對該屬性類型而言是無效的。
- exception ConfigurationError()
- 屬性設定不正確。
- exception DuplicatePropertyError()
- 模型定義有一個以上名稱相同的屬性。
- exception InternalError()
- 資料儲存庫服務發生內部錯誤。此異常並不代表作業失敗。
- exception KindError()
- 應用程式嘗試使用之資料實體的模型類別與該實體不相符。
- exception NeedIndexError()
- 當 SDK 沒有為需要索引的查詢找到相符的索引時,就會發生這種例外狀況。請查看「Administration Console」(管理控制台) 以管理您的索引和 index.yaml 檔案。
- exception NotSavedError()
- 執行的動作需要已儲存 (放置) 在資料儲存庫中的物件,但該物件並未儲存。
- exception PropertyError()
- 受參考的模型屬性並不在資料物件中。
- exception ReferencePropertyResolveError()
- ReferenceProperty 所參考的模型並不存在。請參閱參考資料。
- exception ReservedWordError()
- 模型定義之屬性的名稱是不受允許的。詳情請參閱不允許的屬性名稱。
- exception Rollback()
- 代表交易中的某個函式想要復原交易,而非提交交易。任何交易中未偵測到的異常都會導致交易復原。此異常類別發生於函式將復原且沒有其他異常產生時,為了方便起見而設。
- exception Timeout()
- 當資料儲存庫作業的執行時間超出允許的時間上限時,就會出現這種例外狀況。此異常並不代表作業失敗。
- exception TransactionFailedError()
- 無法提交交易或資料儲存庫的作業,即使在重試過也不行。這通常是由於高爭用率導致,資料正在同時經其他應用程式執行個體更新,且此執行個體無法在固定的重試次數中提交其交易。請參閱交易。
google.appengine.runtime.apiproxy_errors
套件提供下列的例外狀況類別:
- exception CapabilityDisabledError()
代表某個資料儲存庫 API 呼叫沒有執行,因為特定的資料儲存庫功能無法使用。