Загрузка PyMySQL — загрузка исходного кода PyMySQL

PyMySQL

Питон

v1.1.1

Скачать

ПиMySQL

Этот пакет содержит клиентскую библиотеку MySQL и MariaDB на чистом Python, основанную на PEP 249.

Требования

Python — одно из следующих:
- CPython: 3.7 и новее
- PyPy: последняя версия 3.x.
MySQL-сервер — одно из следующих:
- MySQL >= 5,7
- МарияДБ >= 10,4

Установка

Пакет загружается на PyPI.

Вы можете установить его с помощью pip:

 $ python3 -m pip install PyMySQL

Чтобы использовать «sha256_password» или «caching_sha2_password» для аутентификации, вам необходимо установить дополнительную зависимость:

 $ python3 -m pip install PyMySQL[rsa]

Чтобы использовать метод аутентификации MariaDB «ed25519», вам необходимо установить дополнительную зависимость:

 $ python3 -m pip install PyMySQL[ed25519]

Документация

Документация доступна онлайн: https://pymysql.readthedocs.io/.

Для получения поддержки обратитесь к StackOverflow.

Пример

В следующих примерах используется простая таблица.

 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 )

В этом примере будет напечатано:

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

Ресурсы

DB-API 2.0: https://www.python.org/dev/peps/pep-0249/
Справочные руководства по MySQL: https://dev.mysql.com/doc/
Протокол клиента/сервера MySQL: https://dev.mysql.com/doc/internals/en/client-server-protocol.html.
Канал «Коннектор» в MySQL Community Slack: https://lefred.be/mysql-community-on-slack/
Список рассылки PyMySQL: https://groups.google.com/forum/#!forum/pymysql-users.