mysql的python API

具体内容可以参见官方文档。这里仅对其中的部分内容进行整理。

1. 安装

官网上对debian安装包的介绍仅限于dpkg安装，下载网址：

    # 这里以ubuntu15.04_amd64为例
    wget http://cdn.mysql.com//Downloads/Connector-Python/mysql-connector-python-cext_2.1.3-1ubuntu15.04_amd64.deb
    dpkg -i PACKAGE.deb

    # 另外一种方法是使用apt-get，默认安装的版本为1.1.6-1
    sudo apt-get install python-mysql.connector

    # 或者使用pip
    sudo pip install mysql-connector-python-rf

目前python-mysql.connector对python3.4的支持似乎不是很好。使用python2.7.6时没问题。
由于使用后面两种方法安装的有时候会导致版本问题，推荐使用第一种方法来安装。

2. 连接到mysql服务器

    import mysql.connector
    cnx = mysql.connector.connect(user='joe', database='test')
    或者
    from mysql.connector import connection
    cnx = connection.MySQLConnection(user='joe', database='test')

这里常用的登录参数可以选择：
user (username), password (passwd), database (db), host(默认为127.0.0.1), port(默认为3306), charset, collation, buffered(默认为False)等等，参数的更多信息可以参照官网

若要修改配置，重新连接：

    cnx.config(**kwargs)
    
    # 例如：
    cnx = mysql.connector.connect(user='joe', database='test')
    # Connected as 'joe'
    cnx.config(user='jane')
    cnx.reconnect()
    # Now connected as 'jane'

3. 提交

Connector/Python默认不会自动提交。所以每次通过事务修改数据后都需要提交。

    cursor.execute("INSERT INTO employees (first_name) VALUES (%s)", ('Jane'))
    cnx.commit()

4. python API中的模块和类

mysql.connector模块： 提供top-level方法和性质
connection.MySQLConnection类：用于打开和管理与mysql服务器的连接，发送命令，sql语句，以及读取结果
pooling.MySQLConnectionPool类：建立和管理连接池
pooling.PooledMySQLConnection：被MySQLConnectionPool用来返回一个加入连接池的连接
cursor.MySQLCursor：实例化一个可以执行sql语句的对象实例，通过MySQLConnection对象与mysql服务器交互
cursor.MySQLCursor的子类：这些cursor的获得都通过创建时的具体参数来实现

• cursor.MySQLCursorBuffered：执行完sql语句后， MySQLCursorBuffered cursor 获取所有的结果和缓冲的行内容。
• cursor.MySQLCursorRaw：执行完sql语句后直接返回mysql数据类型而不转化为python类型，这通常用于获得更高的性能或者希望自己对执行结果进行转化。
• cursor.MySQLCursorBufferedRaw
• cursor.MySQLCursorDict：执行完sql语句后，将每一行以字典形式传回
• cursor.MySQLCursorBufferedDict
• cursor.MySQLCursorNamedTuple：执行完后将每一行以有名称的元组返回
• cursor.MySQLCursorBufferedNamedTuple
• cursor.MySQLCursorPrepared

constants.ClientFlag：
constants.FieldType
constants.SQLMode
constants.CharacterSet
constants.RefreshOption
Errors and Exceptions