Connexion de pro­grammes à la base de données Python MariaDB

Python et MariaDB per­met­tent de connecter avec ef­fi­ca­cité des ap­pli­ca­tions à une base de données et de traiter des in­for­ma­tions. La com­bi­nai­son Python MariaDB est par­ti­cu­liè­re­ment adaptée aux ap­pli­ca­tions Internet, à l’analyse de données et à l’au­to­ma­ti­sa­tion de rapports.

Quelles sont les con­di­tions préa­lables requises ?

Avant de pouvoir connecter des pro­grammes Python à MariaDB, les con­di­tions suivantes doivent être réunies :

• Ins­tal­la­tion de Python : vous devez avoir installé Python sur votre système. Assurez-vous d’utiliser une version com­pa­tible.
• Base de données MariaDB : nécessité d’une base de données MariaDB fonc­tion­nelle. Vous pouvez soit utiliser une ins­tal­la­tion 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’in­for­ma­tions telles que le nom d’hôte, le port, le nom de la base de données, le nom d’uti­li­sa­teur 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é­pa­ra­tion et ins­tal­la­tion

Il y a deux façons d’accéder à un serveur MariaDB. Vous pouvez soit installer un serveur MariaDB sur votre propre or­di­na­teur ou serveur, soit utiliser la pla­te­forme MariaDB dans le Cloud.

Variante 1 : installer un serveur MariaDB sur son équi­pe­ment

Il est assez simple de té­lé­char­ger le pack MariaDB et de l’installer sur votre propre équi­pe­ment. En voici les ins­truc­tions dé­tail­lées :

Étape 1 : vérifier la con­fi­gu­ra­tion requise

Vérifiez la con­fi­gu­ra­tion né­ces­saire à l’ins­tal­la­tion de MariaDB sur votre système. Assurez-vous que votre matériel répond bien aux exigences minimales, telles que suf­fi­sam­ment de capacité et de mémoire vive.

Étape 2 : té­lé­char­ger MariaDB

Visitez le site Internet officiel de MariaDB et sé­lec­tion­nez le type de té­lé­char­ge­ment souhaité en fonction de votre système d’ex­ploi­ta­tion (Windows, Linux ou macOS). Veillez à choisir la version adaptée à votre système.

Étape 3 : installer le pack

Té­lé­char­gez le fichier d’ins­tal­la­tion adapté à votre système d’ex­ploi­ta­tion et à votre ar­chi­tec­ture (32 bits ou 64 bits). Une fois le té­lé­char­ge­ment terminé, effectuez l’ins­tal­la­tion con­for­mé­ment à votre système d’ex­ploi­ta­tion. Par exemple, pour installer MariaDB sous Ubuntu 20.04, saisissez la commande sudo apt install mariadb-server.

Étape 4 : con­fi­gu­rer la base de données

Lorsque l’ins­tal­la­tion est terminée, con­fi­gu­rez le serveur MariaDB. Cela consiste à définir les données d’accès, les pa­ra­mètres de sécurité et d’autres pa­ra­mètres de la base de données.

Étape 5 : lancer MariaDB

Démarrez le ges­tion­naire de base de données MariaDB. Sous Windows, faites-le via le Ges­tion­naire 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 con­fi­gu­ra­tion initiale

Après le démarrage, con­fi­gu­rez MariaDB en exécutant la commande mysql_secure_installation. Cette commande vous aide à effectuer des réglages de sécurité es­sen­tiels tels que la dé­fi­ni­tion de mots de passe et la sup­pres­sion 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’uti­li­sa­teur root (super uti­li­sa­teur) 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 pla­te­forme de base de données dans le Cloud qui vous permet d’exploiter fa­ci­le­ment et ef­fi­ca­ce­ment des bases de données MariaDB dans le Cloud. La pla­te­forme comprend le serveur MariaDB En­ter­prise Server et offre de nombreux avantages tels qu’une évo­lu­ti­vité au­to­ma­tique, une haute dis­po­ni­bi­lité et des fonctions de sécurité intégrées.

Étape 1 : s’en­re­gis­trer et se connecter

Visitez le site officiel de MariaDB SkySQL et en­re­gis­trez-vous pour obtenir un compte si vous n’en avez pas encore un, puis connectez-vous avec vos iden­ti­fiants.

É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é­lec­tion­nez le type de service souhaité. Vous pouvez choisir entre dif­fé­rentes pla­te­formes MariaDB, y compris MariaDB En­ter­prise Server et d’autres services de base de données.

Étape 3 : con­fi­gu­rer le service

Adaptez la con­fi­gu­ra­tion du service, notamment en dé­fi­nis­sant la version de MariaDB, la capacité de la base de données et d’autres pa­ra­mètres de res­sources. Vous pouvez également utiliser des options de haute dis­po­ni­bi­lité et d’évo­lu­ti­vité au­to­ma­tique. Dé­fi­nis­sez aussi les pa­ra­mètres d’au­then­ti­fi­ca­tion et de sécurité. Cela inclut la con­fi­gu­ra­tion des noms d’uti­li­sa­teur 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 in­for­ma­tions sur le nom d’hôte, le port, le nom d’uti­li­sa­teur et le mot de passe. Utilisez ces in­for­ma­tions pour vous connecter à votre base de données. Exécutez quelques requêtes simples pour vérifier le bon fonc­tion­ne­ment du service.

Étape 5 : sur­veil­ler et gérer la base de données

MariaDB SkySQL propose des outils de sur­veil­lance et d’analyse qui vous per­met­tent de contrôler les per­for­mances de votre base de données. Utilisez ces outils pour vous assurer que votre base de données fonc­tionne de façon optimale. Vous pouvez gérer et faire évoluer votre base de données selon vos besoins en ajustant les pa­ra­mètres des res­sources ou en activant des fonc­tion­na­li­tés sup­plé­men­taires.

Connexion au serveur MariaDB

La bi­blio­thèque MariaDB pour Python vous permet de vous connecter à une base de données MariaDB et d’effectuer diverses opé­ra­tions sur la base de données, telles que des requêtes, des saisies ou des mises à jour de données. Installez la bi­blio­thèque à l’aide du ges­tion­naire 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 bi­blio­thèque et d’établir la connexion avec votre base de données MariaDB. Pour cela, vous avez besoin d’in­for­ma­tions telles que le nom d’hôte, le port, le nom de la base de données, le nom d’uti­li­sa­teur et le mot de passe.

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
}
# É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é­ra­tions de base de données dans une base de données re­la­tion­nelle comme MariaDB. Il s’agit, par exemple, de requêtes SQL et du trai­te­ment 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é­fi­nis­sez 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’ins­truc­tion INSERT SQL indique dans quelle table (your_table) et dans quelles colonnes (column1 et column2) vous allez insérer des données. Les ca­rac­tères de rem­pla­ce­ment comme %s re­pré­sen­tent les valeurs qui doivent être insérées. Le tuple values contient les valeurs cor­res­pon­dantes 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 trans­mis­sion afin de s’assurer que les mo­di­fi­ca­tions sont en­re­gis­trées de façon per­ma­nente dans la base de données.

Étape 4 : terminer la connexion

Une fois les opé­ra­tions sur la base de données ef­fec­tuées, fermez le curseur et la connexion pour libérer des res­sources.

# 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’in­ter­cep­ter les éven­tuelles ex­cep­tions lors de l’éta­blis­se­ment 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é­ci­fiques de votre ap­pli­ca­tion afin de mettre en œuvre dif­fé­rentes opé­ra­tions 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()