MySQL :: MySQL Connector/Python 開發人員指南 :: 4.3 從原始碼發行版安裝 Connector/Python

MySQL Connector/Python 開發人員指南 / Connector/Python 安裝 / 從原始碼發行版安裝 Connector/Python

4.3 從原始碼發行版安裝 Connector/Python

Connector/Python 原始碼發行版與平台無關，可在任何平台上使用。原始碼發行版以兩種格式封裝

Zip 壓縮檔格式（.zip 檔案）
壓縮 tar 壓縮檔格式（.tar.gz 檔案）

任何平台都可使用任一種封裝格式，但在 Windows 系統上更常使用 Zip 壓縮檔，而在 Unix 和類 Unix 系統上則使用 tar 壓縮檔。

使用 C 擴充功能編譯 Connector/Python 的先決條件

原始碼發行版包含與 MySQL C 用戶端程式庫介接的 C 擴充功能。您可以使用或不使用此擴充功能支援來建置發行版。若要建置支援 C 擴充功能的 Connector/Python，您必須滿足下列先決條件。

注意

Connector/Python 8.0.24 已移除 Python 2.7 支援，而 Connector/Python 8.1.0 已移除 Python 3.7 支援。

Linux：C/C++ 編譯器，例如 gcc

Windows：最新版本的 Visual Studio
C 擴充功能的 Protobuf C++ (版本 >= 4.21.1,<=4.21.12) 和/或純 Python 實作的 Python protobuf 套件
Python 開發檔案
已安裝 MySQL 伺服器，包括編譯與 MySQL C 用戶端程式庫介接的可選 C 擴充功能的開發檔案

如果您的系統上尚未安裝 MySQL 伺服器，則必須安裝。若要取得，請造訪 MySQL 下載網站。

對於某些平台，MySQL 開發檔案會以個別套件提供。例如，RPM 和 Debian 套件就是如此。

在 Microsoft Windows 上從原始碼安裝 Connector/Python

Connector/Python Zip 壓縮檔（.zip 檔案）可從 Connector/Python 下載網站取得（請參閱第 4.1 節「取得 Connector/Python」）。

若要從 Zip 壓縮檔安裝 Connector/Python，請下載最新版本並依照下列步驟執行

使用 WinZip 或其他可以讀取 .zip 檔案的工具，將 Zip 壓縮檔解壓縮到目標安裝目錄（例如，C:\mysql-connector\）。
啟動主控台視窗，並將位置變更為您解壓縮 Zip 壓縮檔的資料夾
```
$> cd C:\mysql-connector\
```
在 Connector/Python 資料夾中，使用此命令執行安裝
```
$> python setup.py install
```
若要包含 C 擴充功能（自 Connector/Python 2.1.1 起提供），請改用此命令
```
$> python setup.py install --with-mysql-capi="path_name"
```
--with-mysql-capi 的引數是 MySQL 伺服器的安裝目錄路徑。

若要查看 setup.py 支援的所有選項和命令，請使用此命令

$> python setup.py --help

在 Unix 和類 Unix 系統上從原始碼安裝 Connector/Python

對於 Unix 和類 Unix 系統，例如 Linux、Solaris、macOS 和 FreeBSD，Connector/Python tar 壓縮檔（.tar.gz 檔案）可從 Connector/Python 下載網站取得（請參閱第 4.1 節「取得 Connector/Python」）。

若要從 tar 壓縮檔安裝 Connector/Python，請下載最新版本（此處以 VER 表示），並執行這些命令

$> tar xzf mysql-connector-python-VER.tar.gz
$> cd mysql-connector-python-VER

$> sudo python setup.py install \
--with-protobuf-include-dir=/dir/to/protobuf/include \
--with-protobuf-lib-dir=/dir/to/protobuf/lib \
--with-protoc=/path/to/protoc/binary

若要包含與 MySQL C 用戶端程式庫介接的 C 擴充功能（自 Connector/Python 2.1.1 起提供），也請加入 --with-mysql-capi，例如

$> sudo python setup.py install \
  --with-protobuf-include-dir=/dir/to/protobuf/include \
  --with-protobuf-lib-dir=/dir/to/protobuf/lib \
  --with-protoc=/path/to/protoc/binary \
  --with-mysql-capi="path_name

--with-mysql-capi 的引數是 MySQL 伺服器的安裝目錄路徑，或是 mysql_config 命令的路徑。

若要查看 setup.py 支援的所有選項和命令，請使用此命令

$> python setup.py --help