Connexion de programmes à la base de données Python MariaDB

Python et MariaDB permettent de connecter avec efficacité des applications à une base de données et de traiter des informations. La combinaison Python MariaDB est particulièrement adaptée aux applications Internet, à l’analyse de données et à l’automatisation de rapports.

Quelles sont les conditions préalables requises ?

Avant de pouvoir connecter des programmes Python à MariaDB, les conditions suivantes doivent être réunies :

• Installation de Python : vous devez avoir installé Python sur votre système. Assurez-vous d’utiliser une version compatible.
• Base de données MariaDB : nécessité d’une base de données MariaDB fonctionnelle. Vous pouvez soit utiliser une installation locale de MariaDB, soit vous connecter à une base de données distante.
• Données d’accès à la base de données : pour vous connecter à la base de données MariaDB, vous avez besoin d’informations telles que le nom d’hôte, le port, le nom de la base de données, le nom d’utilisateur et le mot de passe.
• Module Python : il convient d’installer le module Python/Connector pour la connexion à la base de données MariaDB.

Préparation et installation

Il y a deux façons d’accéder à un serveur MariaDB. Vous pouvez soit installer un serveur MariaDB sur votre propre ordinateur ou serveur, soit utiliser la plateforme MariaDB dans le Cloud.

Variante 1 : installer un serveur MariaDB sur son équipement

Il est assez simple de télécharger le pack MariaDB et de l’installer sur votre propre équipement. En voici les instructions détaillées :

Étape 1 : vérifier la configuration requise

Vérifiez la configuration nécessaire à l’installation de MariaDB sur votre système. Assurez-vous que votre matériel répond bien aux exigences minimales, telles que suffisamment de capacité et de mémoire vive.

Étape 2 : télécharger MariaDB

Visitez le site Internet officiel de MariaDB et sélectionnez le type de téléchargement souhaité en fonction de votre système d’exploitation (Windows, Linux ou macOS). Veillez à choisir la version adaptée à votre système.

Étape 3 : installer le pack

Téléchargez le fichier d’installation adapté à votre système d’exploitation et à votre architecture (32 bits ou 64 bits). Une fois le téléchargement terminé, effectuez l’installation conformément à votre système d’exploitation. Par exemple, pour installer MariaDB sous Ubuntu 20.04, saisissez la commande sudo apt install mariadb-server.

Étape 4 : configurer la base de données

Lorsque l’installation est terminée, configurez le serveur MariaDB. Cela consiste à définir les données d’accès, les paramètres de sécurité et d’autres paramètres de la base de données.

Étape 5 : lancer MariaDB

Démarrez le gestionnaire de base de données MariaDB. Sous Windows, faites-le via le Gestionnaire de services. Sous Linux et macOS, cela se fait via la ligne de commande sudo systemctl start mariadb ou sudo service mariadb start.

Étape 6 : procéder à la configuration initiale

Après le démarrage, configurez MariaDB en exécutant la commande mysql_secure_installation. Cette commande vous aide à effectuer des réglages de sécurité essentiels tels que la définition de mots de passe et la suppression de comptes test.

Étape 7 : tester l’accès à la base de données

Vérifiez si vous pouvez bien vous connecter à la base de données. Connectez-vous en tant qu’utilisateur root (super utilisateur) avec mysql -u root -p. Saisissez votre mot de passe et testez la connexion en exécutant quelques requêtes.

Variante 2 : utiliser MariaDB SkySQL

MariaDB SkySQL est une plateforme de base de données dans le Cloud qui vous permet d’exploiter facilement et efficacement des bases de données MariaDB dans le Cloud. La plateforme comprend le serveur MariaDB Enterprise Server et offre de nombreux avantages tels qu’une évolutivité automatique, une haute disponibilité et des fonctions de sécurité intégrées.

Étape 1 : s’enregistrer et se connecter

Visitez le site officiel de MariaDB SkySQL et enregistrez-vous pour obtenir un compte si vous n’en avez pas encore un, puis connectez-vous avec vos identifiants.

Étape 2 : créer un nouveau service

Une fois connecté, vous serez redirigé vers la page d’accueil de SkySQL. Cliquez sur l’option de création d’un nouveau service pour lancer un tel service de base de données. Sélectionnez le type de service souhaité. Vous pouvez choisir entre différentes plateformes MariaDB, y compris MariaDB Enterprise Server et d’autres services de base de données.

Étape 3 : configurer le service

Adaptez la configuration du service, notamment en définissant la version de MariaDB, la capacité de la base de données et d’autres paramètres de ressources. Vous pouvez également utiliser des options de haute disponibilité et d’évolutivité automatique. Définissez aussi les paramètres d’authentification et de sécurité. Cela inclut la configuration des noms d’utilisateur et des mots de passe, ainsi que la gestion des droits d’accès à la base de données.

Étape 4 : se connecter à la base de données

Lorsque le service est deployé, vous recevrez des informations sur le nom d’hôte, le port, le nom d’utilisateur et le mot de passe. Utilisez ces informations pour vous connecter à votre base de données. Exécutez quelques requêtes simples pour vérifier le bon fonctionnement du service.

Étape 5 : surveiller et gérer la base de données

MariaDB SkySQL propose des outils de surveillance et d’analyse qui vous permettent de contrôler les performances de votre base de données. Utilisez ces outils pour vous assurer que votre base de données fonctionne de façon optimale. Vous pouvez gérer et faire évoluer votre base de données selon vos besoins en ajustant les paramètres des ressources ou en activant des fonctionnalités supplémentaires.

Connexion au serveur MariaDB

La bibliothèque MariaDB pour Python vous permet de vous connecter à une base de données MariaDB et d’effectuer diverses opérations sur la base de données, telles que des requêtes, des saisies ou des mises à jour de données. Installez la bibliothèque à l’aide du gestionnaire de paquets pip :

pip3 install mariadb

Vous pouvez ensuite vous connecter à MariaDB via Python.

Étape 1 : établir la connexion

Tout d’abord, il convient d’importer la bibliothèque et d’établir la connexion avec votre base de données MariaDB. Pour cela, vous avez besoin d’informations telles que le nom d’hôte, le port, le nom de la base de données, le nom d’utilisateur et le mot de passe.

import mariadb
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Port standard pour MariaDB
}
# Établir la connexion
conn = mariadb.connect(**db_config)
# Création d'un curseur pour l'exécution des requêtes
cursor = conn.cursor()

cursor est un objet d’accès aux données que vous pouvez utiliser pour effectuer des opérations de base de données dans une base de données relationnelle comme MariaDB. Il s’agit, par exemple, de requêtes SQL et du traitement de données. En Python, vous obtenez un curseur (cursor) après avoir établi une connexion à la base de données. Il est alors appelé par la méthode cursor().

Étape 2 : consulter les données

Dans ce qui suit, nous utilisons le curseur pour exécuter des requêtes SQL et récupérer des données dans la base de données.

# Définition de la requête SQL
sql_query = "SELECT * FROM your_table"
# Exécution de la requête
cursor.execute(sql_query)
# Récupération des résultats
results = cursor.fetchall()
# Affichage des données
for row in results:
    print(row)

Étape 3 : ajouter des données

Pour insérer des données dans une table, définissez une requête SQL INSERT et exécutez-la avec le curseur.

# Définition de la requête SQL
insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
# Définir et insérer les valeurs dans la table
values = ('value1', 'value2')
# Exécution de la requête d'insertion
cursor.execute(insert_query, values)
# Confirmer la transaction pour enregistrer les modifications
conn.commit()

L’instruction INSERT SQL indique dans quelle table (your_table) et dans quelles colonnes (column1 et column2) vous allez insérer des données. Les caractères de remplacement comme %s représentent les valeurs qui doivent être insérées. Le tuple values contient les valeurs correspondantes que vous souhaitez insérer dans la base de données. Le curseur exécute la requête INSERT avec les valeurs indiquées. La méthode conn.commit() confirme ensuite la transmission afin de s’assurer que les modifications sont enregistrées de façon permanente dans la base de données.

Étape 4 : terminer la connexion

Une fois les opérations sur la base de données effectuées, fermez le curseur et la connexion pour libérer des ressources.

# Fermeture du curseur et de la connexion
cursor.close()
conn.close()

Étape 5 : traiter les erreurs

Il est important d’intégrer une gestion des erreurs afin d’intercepter les éventuelles exceptions lors de l’établissement de la connexion ou de l’exécution des requêtes.

try:
        # Établir la connexion
        conn = mariadb.connect(**db_config)
        # Création d'un curseur
        cursor = conn.cursor()
        # Exécution de la requête
        cursor.execute(sql_query)
        # Récupération des résultats
        results = cursor.fetchall()
        for row in results:
            print(row)
    except mariadb.Error as err:
        print(f"Error: {err}")
    finally:
        # Fermeture du curseur et de la connexion
        if cursor:
            cursor.close()
        if conn:
            conn.close()

Vous pouvez adapter cette structure de base aux besoins spécifiques de votre application afin de mettre en œuvre différentes opérations de base de données.

Voici le code complet :

import mariadb
# Détails de la connexion à la base de données
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Port standard pour MariaDB
}
try:
    # Établir la connexion
    conn = mariadb.connect(**db_config)
    # Création d’un curseur pour exécuter les requêtes
    cursor = conn.cursor()
    # Définition de la requête SQL
    sql_query = "SELECT * FROM your_table"
    # Exécution de la requête
    cursor.execute(sql_query)
    # Récupération des résultats
    results = cursor.fetchall()
    # Affichage des données
    for row in results:
        print(row)
    # Définition de la requête SQL
    insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
    # Définir et insérer les valeurs dans la table
    values = ('value1', 'value2')
    # Exécution de la requête
    cursor.execute(insert_query, values)
    # Confirmer la transaction pour enregistrer les modifications
    conn.commit()
except mariadb.Error as err:
    print(f"Error: {err}")
finally:
    # Fermeture du curseur et de la connexion
    if cursor:
        cursor.close()
    if conn:
        conn.close()