Python, un langage de programmation interprété, de haut niveau et à usage général, a gagné en popularité au cours des dernières années. Lancé pour la première fois en 1991, Python en est maintenant à sa troisième version majeure.
Les développeurs ont une affinité pour le langage pour diverses raisons, notamment son haut niveau de lisibilité et une pléthore de fonctionnalités qui permettent d'effectuer des tâches complexes avec une relative facilité. Selon l'enquête Stack Overflow Developer Survey pour 2019, Python s'est positionné parmi les cinq langages de programmation les plus populaires et est le deuxième langage le plus apprécié (derrière Rust) parmi les développeurs.
Présentation de Connecteur/Python
MariaDB a le plaisir d'annoncer la disponibilité immédiate de la version bêta de MariaDB Connector/Python ! Connector/Python permet aux programmes Python d'accéder aux bases de données MariaDB à l'aide d'une API conforme à l'API Python DB 2.0 (PEP-249). Pour optimiser les performances, le nouveau connecteur est écrit en C et exploite la bibliothèque client MariaDB Connector/C pour la communication client-serveur.
Pourquoi un nouveau client ? Bien qu'il existe des clients existants qui peuvent être utilisés pour communiquer avec MariaDB, la motivation derrière la création du connecteur MariaDB Python est de fournir un client léger et très rapide qui prend en charge toutes les fonctionnalités MariaDB au-delà de ce que MySQL offre.
Démarrer
Pour commencer à utiliser Connector/Python, vous devez remplir les conditions préalables suivantes :
- Installez Python 3 (la version minimale prise en charge est 3.6)
- Accéder à une instance MariaDB 10.x
- Installer MariaDB Connector/C version 3.1.5 ou ultérieure
Une fois que vous avez satisfait aux prérequis, vous êtes prêt à installer le connecteur en utilisant :
$ pip3 install --pre mariadb
Avec Connector/Python installé, vous pouvez maintenant l'utiliser dans votre code Python. Commencez par créer un nouveau fichier Python appelé "example.py" à l'emplacement de votre choix.
Ouvrez le fichier et ajoutez ce qui suit à la première ligne pour activer l'utilisation du connecteur :
importer mariadb
Ajoutez les valeurs de configuration pour l'instance de base de données MariaDB à laquelle vous souhaitez vous connecter.
config ={ 'host' :'localhost', 'user' :'root', 'password' :'secret',}
Vous pourrez utiliser cette configuration pour vous connecter à MariaDB en utilisant mariadb.connect :
conn =mariadb.connect(**config)
Pour exécuter des requêtes, vous avez besoin d'un curseur basé sur la connexion :
cur =conn.cursor()
Et vous pouvez fermer la connexion lorsque vous en avez terminé :
conn.close()
Pour tout rassembler, le script suivant se connecte à une base de données locale et exécute quelques requêtes. Consultez notre documentation pour plus d'informations sur les requêtes.
import sysimport mariadbconfig ={ 'host':'localhost', 'user':'root', 'password':'secret',} try:conn =mariadb.connect(**config, database='test' )sauf mariadb.Error as err:print(err, file=sys.stderr) sys.exit(1)cur =conn.cursor()cur.execute("SHOW TABLES")for (tbl,) in cur.fetchall( ):# pré-récupérer toutes les données pour libérer le curseur print("\n===", tbl, "===\n") cur.execute(f"SELECT * FROM `{tbl}`") print ([x[0] for x in cur.description]) # affiche les noms des champs (sous forme de liste) pour la ligne dans cur :# l'utilisation d'un itérateur minimise la mémoire utilisée print(row) # affiche chaque ligne de cette table (chacune comme a tuple)cur.execute("INSERT INTO sample VALUES (?, ?, ?)", (1, "A 'string' with single quotes.", '2020-01-01'))conn.close()
Enregistrez les modifications, ouvrez une fenêtre de terminal, accédez à l'emplacement de "example.py" et exécutez :
$ python3 example.py
Quelle est la prochaine étape
Comme cette version de MariaDB Connector/Python est en version bêta, nous vous déconseillons de l'utiliser en production.
Connector/Python est en développement actif et nous prévoyons de publier bientôt des mises à jour, alors restez à l'écoute ! Si vous avez des questions, rencontrez des problèmes ou souhaitez contribuer au développement de Connector/Python, vous pouvez trouver le code source sur GitHub. La documentation pour MariaDB Connector/Python est disponible dans MariaDB Enterprise Documentation.
