PyMySQL

PyMySQL

Ce package contient une bibliothèque client MySQL et MariaDB purement Python, basée sur PEP 249.

Exigences

• Python -- l'un des éléments suivants :
  • CPython : 3.7 et plus récent
  • PyPy : Dernière version 3.x
• Serveur MySQL - un des éléments suivants :
  • MySQL >= 5.7
  • MariaDB >= 10,4

Installation

Le package est téléchargé sur PyPI.

Vous pouvez l'installer avec pip :

 $ python3 -m pip install PyMySQL

Pour utiliser "sha256_password" ou "caching_sha2_password" pour l'authentification, vous devez installer une dépendance supplémentaire :

 $ python3 -m pip install PyMySQL[rsa]

Pour utiliser la méthode d'authentification "ed25519" de MariaDB, vous devez installer une dépendance supplémentaire :

 $ python3 -m pip install PyMySQL[ed25519]

Documentation

La documentation est disponible en ligne : https://pymysql.readthedocs.io/

Pour obtenir de l'aide, veuillez vous référer à StackOverflow.

Exemple

Les exemples suivants utilisent un tableau simple

 CREATE TABLE ` users ` (
    ` id ` int ( 11 ) NOT NULL AUTO_INCREMENT,
    ` email ` varchar ( 255 ) COLLATE utf8_bin NOT NULL ,
    ` password ` varchar ( 255 ) COLLATE utf8_bin NOT NULL ,
    PRIMARY KEY ( ` id ` )
) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_bin
AUTO_INCREMENT = 1 ;

 import pymysql . cursors

# Connect to the database
connection = pymysql . connect ( host = 'localhost' ,
                             user = 'user' ,
                             password = 'passwd' ,
                             database = 'db' ,
                             cursorclass = pymysql . cursors . DictCursor )

with connection :
    with connection . cursor () as cursor :
        # Create a new record
        sql = "INSERT INTO `users` (`email`, `password`) VALUES (%s, %s)"
        cursor . execute ( sql , ( '[email protected]' , 'very-secret' ))

    # connection is not autocommit by default. So you must commit to save
    # your changes.
    connection . commit ()

    with connection . cursor () as cursor :
        # Read a single record
        sql = "SELECT `id`, `password` FROM `users` WHERE `email`=%s"
        cursor . execute ( sql , ( '[email protected]' ,))
        result = cursor . fetchone ()
        print ( result )

Cet exemple imprimera :

{ 'password' : 'very-secret' , 'id' : 1 }

Ressources

• DB-API 2.0 : https://www.python.org/dev/peps/pep-0249/
• Manuels de référence MySQL : https://dev.mysql.com/doc/
• Protocole client/serveur MySQL : https://dev.mysql.com/doc/internals/en/client-server-protocol.html
• Canal "Connecteur" dans MySQL Community Slack : https://lefred.be/mysql-community-on-slack/
• Liste de diffusion PyMySQL : https://groups.google.com/forum/#!forum/pymysql-users

Licence

PyMySQL est publié sous la licence MIT. Voir LICENCE pour plus d’informations.