Connecteur de base de données MySQL

Catégorie : Connecteurs de bases de données

Introduction

Ce document a été créé pour aider à configurer un connecteur mindzieDataDesigner vers une base de données MySQL. Le mindzieDataDesigner est l'outil ETL utilisé par mindzieStudio pour convertir les tables de base de données en logs d'événements pour le process mining. Le but de ce document est d’aider à créer la chaîne de connexion et à ouvrir les ports sur le pare-feu si nécessaire.

Présentation

Le connecteur MySQL fournit une connectivité native aux instances MySQL Server en utilisant le connecteur officiel MySQL .NET. Ce connecteur supporte toutes les versions de MySQL et tous les scénarios de déploiement, y compris les environnements locaux, cloud et containerisés.

Configuration système requise

  • Système de base de données : MySQL 5.7 ou plus récent (MySQL 8.0 recommandé)
  • Éditions supportées : MySQL Community Server, MySQL Enterprise Edition
  • Support cloud : Amazon RDS pour MySQL, Azure Database for MySQL, Google Cloud SQL
  • Plateformes supportées : Windows, Linux, macOS
  • Dépendances : MySQL .NET Connector (MySql.Data) - inclus avec le connecteur

Format de la chaîne de connexion

Format de base

Server=hostname;Port=3306;Database=database_name;Uid=username;Pwd=password;

Paramètres de connexion

Paramètre Description Obligatoire Exemple
Server ou Host Nom d’hôte/IP du serveur MySQL Oui mysql.company.com
Port Numéro de port du serveur Non 3306 (par défaut)
Database Nom de la base de données Oui process_mining
Uid ou User ID Nom d’utilisateur MySQL Oui mindzie_user
Pwd ou Password Mot de passe MySQL Oui SecurePassword123
Connection Timeout Délai d’attente de connexion (secondes) Non 30
Command Timeout Délai d’attente de commande (secondes) Non 600
Pooling Activer le pool de connexions Non true
Min Pool Size Taille minimale du pool Non 0
Max Pool Size Taille maximale du pool Non 100
SSL Mode Mode de connexion SSL Non Required
CharSet ou Character Set Encodage des caractères Non utf8mb4

Exemples de connexion

Serveur MySQL local

Server=localhost;Port=3306;Database=process_mining;Uid=mindzie_user;Pwd=password;

Serveur MySQL distant avec SSL

Server=mysql.company.com;Port=3306;Database=process_mining;Uid=mindzie_user;Pwd=SecurePassword123;SSL Mode=Required;

Amazon RDS MySQL

Server=myinstance.123456789012.us-east-1.rds.amazonaws.com;Port=3306;Database=process_mining;Uid=admin;Pwd=AWSPassword123;SSL Mode=Required;

Azure Database for MySQL

Server=myserver.mysql.database.azure.com;Port=3306;Database=process_mining;Uid=mindzie@myserver;Pwd=AzurePassword123;SSL Mode=Required;

Connexion avec paramètres avancés

Server=mysql-server;Port=3306;Database=process_mining;Uid=mindzie_user;Pwd=password;
Pooling=true;Min Pool Size=5;Max Pool Size=50;Connection Timeout=30;
Character Set=utf8mb4;SSL Mode=Preferred;

Dépannage

Problèmes courants de connexion

Erreur "Unable to connect to any of the specified MySQL hosts"

  • Vérifiez le nom d’hôte du serveur et le port
  • Contrôlez la connectivité réseau et les règles du pare-feu
  • Assurez-vous que le serveur MySQL est en fonctionnement : systemctl status mysql
  • Vérifiez la configuration bind-address de MySQL

Erreur "Access denied for user"

  • Vérifiez que le nom d’utilisateur et le mot de passe sont corrects
  • Contrôlez que l’utilisateur existe : SELECT User, Host FROM mysql.user;
  • Assurez-vous que l’utilisateur a les privilèges adéquats : SHOW GRANTS FOR 'username'@'host';
  • Vérifiez les permissions d’accès basées sur l’hôte

Erreur "Unknown database"

  • Vérifiez que la base de données existe : SHOW DATABASES;
  • Contrôlez que l’utilisateur a accès à la base de données
  • Assurez-vous de sélectionner la bonne base dans la chaîne de connexion

Erreurs de connexion SSL

  • Vérifiez que le paramètre SSL Mode correspond à la configuration du serveur
  • Contrôlez la configuration des certificats SSL MySQL
  • Utilisez SSL Mode=None pour les tests (non recommandé en production)

Configurations spécifiques au cloud

Amazon RDS

  • Utilisez le point de terminaison RDS comme nom de serveur
  • Activez les connexions SSL
  • Configurez les groupes de sécurité pour l’accès

Azure Database for MySQL

  • Utilisez des noms de serveurs pleinement qualifiés
  • Incluez le nom du serveur dans le nom d’utilisateur : user@servername
  • Configurez les règles de pare-feu pour les adresses IP clients
  • Activez les paramètres de sécurité de connexion

Accès serveur mindzie : Pour renforcer la sécurité, vous pouvez configurer votre pare-feu pour n’autoriser les connexions qu’à partir des serveurs mindzie en inscrivant en liste blanche des adresses IP spécifiques. Contactez le support mindzie pour obtenir les adresses IP actuelles des serveurs mindzie que vous utilisez.

Google Cloud SQL

  • Utilisez les connexions IP publiques ou privées
  • Configurez les réseaux autorisés
  • Activez les certificats SSL pour des connexions sécurisées

Informations connexes

💡 Astuce : Utilisez le jeu de caractères utf8mb4 pour assurer un support complet de l’Unicode, particulièrement important pour les applications de process mining internationales avec des données multilingues.