MySQL 连接器/Python 开发人员指南  / 第 4 章连接器/Python 安装  /  4.3 从源分发安装连接器/Python

4.3 从源分发安装连接器/Python

连接器/Python 源代码分发与平台无关，可以在任何平台上使用。源代码分发包有两种格式：

  • Zip 归档格式（.zip文件）

  • 压缩的 tar存档格式（.tar.gz文件）

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

使用 C 扩展编译连接器/Python 的先决条件

从 Connector/Python 2.1.1 开始，源代码分发包括与 MySQL C 客户端库接口的 C 扩展。您可以在支持或不支持此扩展的情况下构建发行版。要构建支持 C 扩展的连接器/Python，您必须满足以下先决条件。

笔记

Connector/Python 8.0.24 中删除了 Python 2.7 支持。

  • Linux：AC/C++编译器，如gcc

    Windows：Visual Studio 的正确版本：Python 2.7 的 VS 2009、Python 3.3 的 VS 2010

  • Protobuf C++（版本 >= 3.11.0，<=3.20.1 和版本 < 3.12.0 在 macOS 上）用于 C 扩展和/或用于纯 Python 实现的 Python 的 protobuf 包

  • Python开发文件

  • 安装了 MySQL 服务器，包括用于编译与 MySQL C 客户端库接口的可选 C 扩展的开发文件

如果您的系统上尚未安装 MySQL 服务器，则必须安装它。要获取它，请访问 MySQL 下载站点。

对于某些平台，MySQL 开发文件在单独的包中提供。例如，RPM 和 Debian 软件包就是如此。

在 Microsoft Windows 上从源安装连接器/Python

连接器/Python Zip 存档（.zip文件）可从连接器/Python 下载站点获得（请参阅 第 4.1 节“获取连接器/Python”）。

要从 Zip 存档安装连接器/Python，请下载最新版本并按照以下步骤操作：

  1. C:\mysql-connector\使用 WinZip或其他可以读取 .zip文件的 工具 将 Zip 存档解压缩到预期的安装目录（例如， ）。

  2. 启动控制台窗口并将位置更改为解压缩 Zip 存档的文件夹： 

    $> cd C:\mysql-connector\

  3. 在 Connector/Python 文件夹中，使用以下命令执行安装： 

    $> python setup.py install

    要包含 C 扩展（从 Connector/Python 2.1.1 开始可用），请改用此命令： 

    $> python setup.py install --with-mysql-capi="path_name"

    to 的参数--with-mysql-capi是MySQL Server 安装目录的路径。

要查看 支持的所有选项和命令 setup.py，请使用此命令： 

$> python setup.py --help

在 Unix 和类 Unix 系统上从源安装连接器/Python

对于 Unix 和类 Unix 系统，例如 Linux、Solaris、macOS 和 FreeBSD，Connector/Python tar存档（.tar.gz文件）可从 Connector/Python 下载站点获得（请参阅第 4.1 节“获取 Connector/Python”）。

要从tar存档安装连接器/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

to的参数--with-mysql-capi是MySQL Server的安装目录路径，或者是 mysql_config命令的路径。

要查看 支持的所有选项和命令 setup.py，请使用此命令： 

$> python setup.py --help