文件首頁
MySQL Connector/Python 開發人員指南
相關文件 下載本手冊
PDF (US Ltr) - 0.7Mb
PDF (A4) - 0.7Mb


10.12 錯誤與例外

mysql.connector.errors 模組定義了 MySQL Connector/Python 引發的錯誤和警告的例外類別。當您匯入 mysql.connector 時,這個模組中定義的大部分類別都可用。

此模組中定義的例外類別大多遵循 Python 資料庫 API 規範 v2.0 (PEP 249)。對於某些 MySQL 客戶端或伺服器錯誤,並不總是清楚應該引發哪個例外。最好透過開啟錯誤報告來討論是否應該對錯誤進行重新分類。

MySQL 伺服器錯誤會根據其 SQLSTATE 值映射到 Python 例外 (請參閱伺服器錯誤訊息參考)。下表顯示了 SQLSTATE 類別以及 Connector/Python 引發的例外。但是,可以重新定義每個伺服器錯誤引發哪個例外。預設的例外是 DatabaseError

表 10.1:伺服器錯誤到 Python 例外的映射

SQLSTATE 類別 Connector/Python 例外
02 DataError
02 DataError
07 DatabaseError
08 OperationalError
0A NotSupportedError
21 DataError
22 DataError
23 IntegrityError
24 ProgrammingError
25 ProgrammingError
26 ProgrammingError
27 ProgrammingError
28 ProgrammingError
2A ProgrammingError
2B DatabaseError
2C ProgrammingError
2D DatabaseError
2E DatabaseError
33 DatabaseError
34 ProgrammingError
35 ProgrammingError
37 ProgrammingError
3C ProgrammingError
3D ProgrammingError
3F ProgrammingError
40 InternalError
42 ProgrammingError
44 InternalError
HZ OperationalError
XA IntegrityError
0K OperationalError
HY DatabaseError