6.4 连接器/Python 安装

Connector/Python 可在安装了 Python 的任何平台上运行。Python 预装在大多数 Unix 和类 Unix 系统上,例如 Linux、macOS 和 FreeBSD。在 Microsoft Windows 上,可从Python 下载网站获得 Python 安装程序。如有必要,请在尝试安装连接器/Python 之前下载并安装适用于 Windows 的 Python。

笔记

连接器/Python 要求python在系统中 ,如果找不到pythonPATH,安装将失败 。在 Unix 和类 Unix 系统上,python通常位于默认设置中包含的目录中。在 Windows 上,如果您安装 Python,请在安装过程中 启用Add python.exe to Path ,或者您自己手动添加包含python.exe的目录。 PATH

有关在 Windows 上安装和配置 Python 的更多信息,请参阅 Python 文档中的 在 Windows 上使用 Python 。

Connector/Python 以两种方式实现 MySQL 客户端/服务器协议:

  • 作为纯 Python;用 Python 编写的实现。它的依赖项是 Python 标准库和 Python Protobuf >= 3.11.0,<= 3.20.1。

    笔记

    EL7 和 Ubuntu 16.04 不提供 Python Protobuf 3+,使得纯 Python 版本在这些平台上不可用;在那里使用 C Extension 变体。您可能必须 --force 安装但不能使用 use_pure=True。

  • 作为与 MySQL C 客户端库接口的 C 扩展。该协议的实现依赖于客户端库,但可以使用 MySQL 服务器包提供的库(参见MySQL C API 实现)。

客户端/服务器协议的实现都没有任何第三方依赖性。但是,如果您需要 SSL 支持,请验证您的 Python 安装是否已使用 OpenSSL库进行编译。

TLS 支持

默认情况下,EL8 和 Debian 10 在策略级别设置为 DEFAULT 时支持 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 的安装在每个平台上都是相似的,并遵循标准的 Python Distribution UtilitiesDistutils。对于某些平台,分发以本机格式提供,例如用于 Linux 的 RPM 包。

关于发行版的 Python 术语:

  • Built Distribution:以本机打包格式创建的包,用于给定平台。它包含源代码和独立于平台的字节码。连接器/Python 二进制发行版是构建发行版。

  • Source Distribution:仅包含源文件并且通常与平台无关的发行版。