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()
翻译未完 ......