PyMySQL

PyMySQL

Este paquete contiene una biblioteca cliente MySQL y MariaDB pura de Python, basada en PEP 249.

Requisitos

• Python: uno de los siguientes:
  • CPython: 3.7 y más reciente
  • PyPy: última versión 3.x
• Servidor MySQL: uno de los siguientes:
  • MySQL >= 5.7
  • MaríaDB >= 10.4

Instalación

El paquete se carga en PyPI.

Puedes instalarlo con pip:

 $ python3 -m pip install PyMySQL

Para utilizar "sha256_password" o "caching_sha2_password" para la autenticación, necesita instalar una dependencia adicional:

 $ python3 -m pip install PyMySQL[rsa]

Para utilizar el método de autenticación "ed25519" de MariaDB, necesita instalar una dependencia adicional:

 $ python3 -m pip install PyMySQL[ed25519]

Documentación

La documentación está disponible en línea: https://pymysql.readthedocs.io/

Para obtener ayuda, consulte StackOverflow.

Ejemplo

Los siguientes ejemplos utilizan una tabla 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 )

Este ejemplo imprimirá:

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

Recursos

• DB-API 2.0: https://www.python.org/dev/peps/pep-0249/
• Manuales de referencia de MySQL: https://dev.mysql.com/doc/
• Protocolo cliente/servidor MySQL: https://dev.mysql.com/doc/internals/en/client-server-protocol.html
• Canal "Conector" en MySQL Community Slack: https://lefred.be/mysql-community-on-slack/
• Lista de correo de PyMySQL: https://groups.google.com/forum/#!forum/pymysql-users

Licencia

PyMySQL se publica bajo la licencia MIT. Consulte LICENCIA para obtener más información.