PyMySQL

PyMySQL

Dieses Paket enthält eine reine Python-MySQL- und MariaDB-Clientbibliothek, basierend auf PEP 249.

Anforderungen

• Python – eines der folgenden:
  • CPython: 3.7 und neuer
  • PyPy: Neueste 3.x-Version
• MySQL-Server – einer der folgenden:
  • MySQL >= 5.7
  • MariaDB >= 10.4

Installation

Paket wird auf PyPI hochgeladen.

Sie können es mit pip installieren:

 $ python3 -m pip install PyMySQL

Um „sha256_password“ oder „caching_sha2_password“ zur Authentifizierung zu verwenden, müssen Sie eine zusätzliche Abhängigkeit installieren:

 $ python3 -m pip install PyMySQL[rsa]

Um die Authentifizierungsmethode „ed25519“ von MariaDB zu verwenden, müssen Sie eine zusätzliche Abhängigkeit installieren:

 $ python3 -m pip install PyMySQL[ed25519]

Dokumentation

Die Dokumentation ist online verfügbar: https://pymysql.readthedocs.io/

Für Unterstützung wenden Sie sich bitte an StackOverflow.

Beispiel

Die folgenden Beispiele verwenden eine einfache Tabelle

 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 )

In diesem Beispiel wird Folgendes gedruckt:

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

Ressourcen

• DB-API 2.0: https://www.python.org/dev/peps/pep-0249/
• MySQL-Referenzhandbücher: https://dev.mysql.com/doc/
• MySQL-Client/Server-Protokoll: https://dev.mysql.com/doc/internals/en/client-server-protocol.html
• „Connector“-Kanal in MySQL Community Slack: https://lefred.be/mysql-community-on-slack/
• PyMySQL-Mailingliste: https://groups.google.com/forum/#!forum/pymysql-users

Lizenz

PyMySQL wird unter der MIT-Lizenz veröffentlicht. Weitere Informationen finden Sie unter LIZENZ.