MySQL 连接器/Python 开发人员指南  / 第 4 章连接器/Python 安装  /  4.2 从二进制分发安装连接器/Python

4.2 从二进制分发安装连接器/Python

本机包格式的连接器/Python 安装程序可用于 Windows 以及 Unix 和类 Unix 系统：

  • Windows：MSI 安装包

  • Linux：用于 EL7 和 EL8 以及 Fedora 的 Yum 存储库；适用于 Oracle Linux、Red Hat 和 SuSE 的 RPM 包；Debian 和 Ubuntu 的 Debian 软件包

  • macOS：带有 PKG 安装程序的磁盘映像包

您可能需要root管理员权限才能执行安装操作。

笔记

在 Connector/Python 8.0.22 之前，C 扩展和纯 Python 实现是使用两个单独的二进制发行版安装的；除了它们总是结合用于 Windows 和 macOS。C 扩展实现的包名中有“ cext ”。

提供 C 扩展链接的二进制发行版，该链接指向由 MySQL 服务器安装提供的已安装的 C 客户端库。对于那些非静态链接的发行版，如果您的系统上尚未安装 MySQL 服务器，则必须安装它。要获取它，请访问 MySQL 下载站点。

使用 pip 安装连接器/Python

使用pip在大多数操作系统上安装连接器/Python： 

$> pip install mysql-connector-python

在 Microsoft Windows 上安装连接器/Python

推荐使用 MySQL Installer 管理所有 MySQL 产品，包括 MySQL Connector/Python。它处理所有要求和先决条件、配置和升级。

先决条件。 必须在您的系统上安装 Microsoft Visual C++ 2015 Redistributable 。

  • MySQL Installer（推荐）：执行 MySQL Installer时，选择 MySQL Connector/Python 作为要安装的产品之一。MySQL 安装程序安装本文档中描述的 Windows MSI 安装程序。

  • Windows MSI 安装程序（.msi文件）：要使用 MSI 安装程序，请启动它并按照它显示的屏幕中的提示在您选择的位置安装连接器/Python。

    与 MySQL 安装程序一样，连接器/Python MSI 的后续执行使您能够修复或删除现有的连接器/Python 安装。

    连接器/Python Windows MSI 安装程序（.msi文件）可从连接器/Python 下载站点获得（请参阅 第 4.1 节“获取连接器/Python”）。选择适合您系统上安装的 Python 版本的安装程序。从 Connector/Python 2.1.1 开始，MSI 安装程序包括 C 扩展；它不需要单独安装。

或者，要从命令行运行安装程序，请在控制台窗口中使用此命令，其中 VER和 PYVER是安装程序文件名中相应的连接器/Python 和 Python 版本号： 

$> msiexec /i mysql-connector-python-VER-pyPYVER.msi

使用 MSI 安装程序的连接器/Python 的后续执行允许您修复或删除现有的连接器/Python 安装。

使用 MySQL Yum 存储库在 Linux 上安装连接器/Python

对于基于 EL7 或 EL8 的平台和 Fedora，您可以使用 MySQL Yum 存储库安装连接器/Python（请参阅使用 Yum 安装其他 MySQL 产品和组件）。您的系统存储库列表中必须有 MySQL Yum 存储库（有关详细信息，请参阅 添加 MySQL Yum 存储库）。要确保您的 Yum 存储库是最新的，请使用以下命令： 

$> sudo yum update mysql-community-release

先决条件

  • 在 EL7、EL8 和 SUSE 上：python3-protobuf RPM 包在这些平台上不适用于 Python 3.8，因此依赖项不是 RPM 规范的一部分；相反，它必须与pip install protobuf. 从 v8.0.29 开始，这是必需的。

  • 虽然是可选的，但该 mysql-community-client-plugins包需要使用更新的身份验证方法，例如 caching_sha2_passwordMySQL 8.0 的默认身份验证方法。 

$> sudo yum install mysql-community-client-plugins

然后按如下方式安装连接器/Python： 

$> sudo yum install mysql-connector-python

使用 RPM 包在 Linux 上安装连接器/Python

连接器/Python Linux RPM 包（.rpm文件）可从连接器/Python 下载站点获得（请参阅 第 4.1 节“获取连接器/Python”）。

要安装连接器/Python RPM 包（此处表示为 PACKAGE.rpm），请使用以下命令： 

$> rpm -i PACKAGE.rpm

先决条件

  • 在 EL7、EL8 和 SUSE 上：python3-protobuf RPM 包在这些平台上不适用于 Python 3.8，因此依赖项不是 RPM 规范的一部分；相反，它必须与pip install protobuf. 从 v8.0.29 开始，这是必需的。

  • 虽然是可选的，但该 mysql-community-client-plugins包需要使用更新的身份验证方法，例如 caching_sha2_passwordMySQL 8.0 的默认身份验证方法。

笔记

在 Connector/Python 8.0.22 之前，C 扩展实现是一个单独的 RPM 包，名称中包含“ cext ”。

RPM 提供了在安装包之前验证包的完整性和真实性的功能。要了解更多信息，请参阅 使用 MD5 校验和或 GnuPG 验证包完整性。

使用 Debian 软件包在 Linux 上安装连接器/Python

Connector/Python Debian 软件包（.deb文件）可用于 Debian 或类似 Debian 的 Linux 系统，可从 Connector/Python 下载站点获取（请参阅第 4.1 节“获取连接器/Python”）。

先决条件。  虽然是可选的，但该 mysql-community-client-plugins包需要使用更新的身份验证方法，例如 caching_sha2_passwordMySQL 8.0 的默认身份验证方法。

要安装 Connector/Python Debian 软件包（此处表示为 PACKAGE.deb），请使用以下命令： 

$> dpkg -i PACKAGE.deb
笔记

在 Connector/Python 8.0.22 之前，C 扩展实现是一个单独的 DEB 包，名称中包含“ cext ”。

使用磁盘映像在 macOS 上安装连接器/Python

连接器/Python macOS 磁盘映像（.dmg文件）可从连接器/Python 下载站点获得（请参阅 第 4.1 节“获取连接器/Python”）。从 Connector/Python 2.1.1 开始，macOS 磁盘映像包括 C 扩展；它不需要单独安装。

下载该.dmg文件并通过打开它并双击生成 的.pkg文件来安装 Connector/Python。