MySQL Connector/Python 开发者指南（正在努力翻译中）

本篇文章长期更新

本文翻译自：https://dev.mysql.com/doc/connector-python/en/

如本文哪里有翻译不妥，请在本文下方评论处指出 ^_^

版权声明：原创作品，允许转载，转载时请务必以超链接形式标明文章原始出处，作者信息。否则将追究法律责任。

摘要

这篇手册描述了怎么来安装和配置 MySQL Connector/Python，MySQL Connector/Python 是 Python 和 MySQL 服务进行通信的一个独立驱动程序，本篇手册还将阐述如何利用它来开发数据库应用程序。

获取 Connector/Python 的每一次发布版本的改动细节，请参阅 MySQL Connector/Python Release Notes 。

获取合法信息，请参阅 Legal Notices 。

获取 MySQL 使用帮助，请访问 MySQL Forums 或者 MySQL Mailing Lists，在那里你可以和其他 MySQL 用户进行讨论交流。

获取 MySQL 其他产品的文档，包括其他语言的翻译文档和可供下载各种格式的版本，这包括 HTML 和 PDF 格式，具体参看 MySQL Documentation Library

关于许可信息的一些说明：MySQL 产品可能包含第三方软件，使用许可信息，如果你正在使用 MySQL Connector/Python 的商业发布版本，请点击 this document 获取许可信息，里面包括了关于包含了商业发布版本的第三方软件的许可信息。。如果你正在使用 MySQL Connector/Python 的社区发布版本，请点击 this document 获取许可信息，里面包括了关于包含了社区发布版本的第三方软件的许可信息。

文档生成日期：2017-06-01（修订代号：52416）

1 MySQL Connector/Python 介绍

MySQL Connector/Python 能够让你的 Python 程序和 MySQL 数据库进行通信，它使用了符合 Python Database API Specification v2.0（PEP 249）规范的 API 。这个 API 除了 Python Standard Library 外其它的都是用纯 Python 写的并且没有任何依赖关系。

获取 Connector/Python 每个发布版本的详细改变，请参阅 MySQL Connector/Python Release Notes 。

MySQL Connector/Python 支持包括如下：

几乎所有的功能都由 MySQL Server（包括 MySQL Server 5.7 版本）提供。
Python 和 MySQL 两者的数据类型可以来回转换其对应的参数值，例如 Python 的 datetime 和 MySQL 的 DATETIME，为了方便起见，你可以选择自动转换，或者关闭最佳性能。
所有的 MySQL 扩展到了标准的 SQL 语法。
压缩协议能够在客户端和服务端之间进行对数据流的压缩。
使用 TCP/IP 套接字和在 Unix 上使用 Unix 套接字进行连接。
使用 SSL 连接可以使 TCP/IP 更安全。
在标准库外，独立的 Connector/Python 驱动不需要 MySQL 客户端库或者其他一些 Python 的模块。

获取每个 MySQL Connector/Python 版本能适用哪些 Python 版本的信息，请参阅 3 Connector/Python Versions

注：Connector/Python 不支持老版本的 MySQL Server 验证方法，这意味着 4.1 之前版本的 MySQL 不会工作

2 MySQL Connector/Python 开发者指南

下面这个涵盖了 MySQL 应用方面的指南对于一个有着 Python 开发背景的人员来说不会显得那么难：

为了安全

3 Connector/Python 版本

下面这张表总结了可用的 Connector/Python 版本，对于一些待发布的正式版本来说，在它之前的开发版本就不再长久支持了。

Connector/Python 版本	MySQL Server 版本	Python 版本	Connector 状态
2.2	5.7、5.6、5.5	3.3 或更高、2.7	开发者里程碑
2.1	5.7、5.6、5.5	3.3 或更高、2.7、2.6	推荐版本
2.0	5.7、5.6、5.5	3.3 或更高、2.7、2.6	正式版，支持
1.2	5.7、5.6、5.5（5.1、5.0、4.1）	3.1 或更高、2.7、2.6	正式版，支持

注：众所周知，MySQL server 和 Python 版本两者要协同工作，那么必须要 Connector/Python 作为一个桥梁将两者连在一起

注：Connector/Python 不支持老版本的 MySQL Server 验证方法，这意味着 4.1 之前版本的 MySQL 不会工作

4 Connector/Python 安装

Connector/Python 能够在任何安装了 Python 的平台上运行，Unix 和类 Unix 系统上都预装了 Python，比如 Linux，OS X 和 FreeBSD。在微软的操作系统中，你可以在 Python Download website 上下载 Python 安装包进行安装，如果有必要，请在您尝试安装 Connector/Python 之前先下载和安装 Python 。

注：Connector/Python 需要你的系统路径下有 Python，因为当 Python 没有被加载时，Connector/Python 会安装失败

4.1 获取 Connector/Python

4.2 Connector/Python 二进制文件安装

4.3 Connector/Python 源代码安装

4.4 验证 Connector/Python 是否安装成功

5 Connector/Python 代码例子

这些代码例子说明了如何使用 MySQL Connector/Python 来连接 MySQL Server 并开发出 Python 应用程序和脚本。

5.1 使用 Connector/Python 连接 MySQL

构造函数 connect() 创建了一个连接 MySQL 的服务并返回一个 MySQLConnection 对象。

下面这个例子展示了怎么来连接 MySQL server：

import mysql.connector

cnx = mysql.connector.connect(user='scott', password='tiger',
                              host='127.0.0.1',
                              database='employees')
cnx.close()

翻译未完 ......