本節描述版本發佈,例如 8.0.34,以及針對兩種實作方式(C 擴充和純 Python)的特定注意事項。
下表摘要說明了可用的 Connector/Python 版本。對於已達到正式發行 (GA) 狀態的系列,GA 版本之前的系列開發版本不再受支援。
MySQL 連接器和其他 MySQL 用戶端工具和應用程式現在將其版本號的第一位數字與其支援的(最高)MySQL 伺服器版本同步。例如,MySQL Connector/Python 8.0.12 將設計為支援 MySQL 伺服器版本 8(或更低版本)的所有功能。此變更可以輕鬆且直觀地決定哪個客戶端版本適用於哪個伺服器版本。
Connector/Python 8.0.4 是第一個使用新編號的版本。它是 Connector/Python 2.2.3 的後續版本。
表 3.1 Connector/Python 版本參考
Connector/Python 版本 | MySQL 伺服器版本 | Python 版本 | 連接器狀態 |
---|---|---|---|
9.1.0 | 8.0 及更高版本 | 3.13, 3.12, 3.11, 3.10, 3.9, 3.8 | 正式發行 |
8.4.0 和 9.0.0 | 8.0 及更高版本 | 3.12, 3.11, 3.10, 3.9, 3.8 | 正式發行 |
8.1.0 到 8.3.0 | 5.7 及更高版本 | 3.12 (8.2.0+), 3.11, 3.10, 3.9, 3.8 | 正式發行 |
8.0 | 8.0, 5.7, 5.6, 5.5 | 3.11、3.10、3.9、3.8、3.7、(8.0.29 之前的 3.6)、(8.0.24 之前的 2.7 和 3.5) | 正式發行 |
2.2 (繼續為 8.0) | 5.7, 5.6, 5.5 | 3.5, 3.4, 2.7 | 開發人員里程碑,無發佈版本 |
2.1 | 5.7, 5.6, 5.5 | 3.5, 3.4, 2.7, 2.6 | 正式發行 |
2.0 | 5.7, 5.6, 5.5 | 3.5, 3.4, 2.7, 2.6 | GA,於 2016-10-26 發佈最終版本 |
1.2 | 5.7, 5.6, 5.5 (5.1, 5.0, 4.1) | 3.4, 3.3, 3.2, 3.1, 2.7, 2.6 | GA,於 2014-08-22 發佈最終版本 |
已知括號內的 MySQL 伺服器和 Python 版本可與 Connector/Python 搭配使用,但未正式支援。這些版本的錯誤可能不會被修正。
Connector/Python 不支援舊的 MySQL 伺服器驗證方法,這表示 4.1 之前的 MySQL 版本無法運作。
在 macOS x86_64 ARM 上:C 擴充實作不支援 Python 3.7;請注意,這是 macOS 上非預設的 Python 版本。
Connector/Python 以兩種方式實作 MySQL 用戶端/伺服器協定
-
以純 Python 方式實作;以 Python 編寫的實作。它取決於 Python 標準函式庫。
連接器的 X DevAPI 變體需要 Python Protobuf。所需的版本為 4.25.3,在 Connector/Python 9.0.0 之前為 >= 4.21.1, <= 4.21.12。
作為與 MySQL C 用戶端函式庫介面的 C 擴充。此協定的實作取決於用戶端函式庫,但可以使用 MySQL 伺服器套件提供的函式庫(請參閱MySQL C API 實作)。
用戶端/伺服器協定的兩種實作方式都沒有任何第三方依賴項。但是,如果您需要 SSL 支援,請確認您的 Python 安裝已使用 OpenSSL 函式庫編譯。
預設情況下,當策略層級設定為 DEFAULT 時,EL8 和 Debian 10 支援 TLSv1.2 及更高版本。若要支援 TLSv1 和 TLSv1.1,則需要將策略變更為 LEGACY。這表示預設的 EL8/DEB10 設定無法使用 C 擴充與 TLSv1 和 TLSv1.1 建立連線。其他平台未來可能會變更其預設行為。
TLSv1.0 和 TLSv1.1 連線協定已在 Connector/Python 8.0.26 中棄用,並且在 Connector/Python 8.0.28 中移除了對它們的支援。
Connector/Python 8.0.32 中移除了對 distutils 的支援。
關於發佈的 Python 術語
已建置發佈:以指定平台的原生封裝格式建立的套件。它包含來源和平台獨立位元組碼。Connector/Python 二進位發佈是已建置發佈。
來源發佈:僅包含來源檔案且通常與平台無關的發佈。