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 文件）

任何平台都可以使用这两种打包格式，但 Zip 存档更常用于 Windows 系统，而 tar 存档更常用于 Unix 和类 Unix 系统。

使用 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 下载站点获取 Connector/Python Zip 存档（.zip 文件）（请参阅第 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

对于 Linux、Solaris、macOS 和 FreeBSD 等 Unix 和类 Unix 系统，可以从 Connector/Python 下载站点获取 Connector/Python tar 存档（.tar.gz 文件）（请参阅第 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