Connecteur de base de données PostgreSQL

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 PostgreSQL. mindzieDataDesigner est l'outil ETL utilisé par mindzieStudio pour convertir les tables de base de données en journaux d'événements de fouille de processus. L'objectif 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 PostgreSQL offre une connectivité haute performance aux bases de données PostgreSQL en utilisant le fournisseur de données Npgsql. Ce connecteur prend en charge les fonctionnalités avancées de PostgreSQL et est optimisé pour les charges analytiques courantes en fouille de processus.

Configuration requise

  • Système de base de données : PostgreSQL 10 ou plus récent (PostgreSQL 15+ recommandé)
  • Support Cloud : Amazon RDS pour PostgreSQL, Azure Database pour PostgreSQL, Google Cloud SQL
  • Support plateforme : Windows, Linux, macOS
  • Dépendances : Fournisseur de données Npgsql .NET - inclus avec le connecteur

Format de la chaîne de connexion

Format de base

Host=hostname;Port=5432;Database=database_name;Username=username;Password=password;

Paramètres de connexion

Paramètre Description Obligatoire Exemple
Host ou Server Nom d'hôte du serveur PostgreSQL Oui postgres.company.com
Port Numéro de port du serveur Non 5432 (par défaut)
Database Nom de la base de données Oui process_mining
Username ou User ID Nom d'utilisateur PostgreSQL Oui mindzie_user
Password Mot de passe PostgreSQL Oui SecurePassword123
Timeout Délai d'attente de la connexion (secondes) Non 30
Command Timeout Délai d'attente de la commande (secondes) Non 600
Pooling Activer le pooling de connexions Non true
Minimum Pool Size Nombre minimum de connexions dans le pool Non 1
Maximum Pool Size Nombre maximum de connexions dans le pool Non 100
SSL Mode Mode de connexion SSL Non Prefer
Trust Server Certificate Faire confiance au certificat SSL Non false

Exemples de connexion

PostgreSQL local

Host=localhost;Port=5432;Database=process_mining;Username=mindzie_user;Password=password;

PostgreSQL distant avec SSL

Host=postgres.company.com;Port=5432;Database=process_mining;Username=mindzie_user;Password=SecurePassword123;SSL Mode=Require;

Amazon RDS PostgreSQL

Host=myinstance.123456789012.us-east-1.rds.amazonaws.com;Port=5432;Database=process_mining;Username=postgres;Password=RDSPassword123;SSL Mode=Require;

Azure Database pour PostgreSQL

Host=myserver.postgres.database.azure.com;Port=5432;Database=process_mining;Username=mindzie@myserver;Password=AzurePassword123;SSL Mode=Require;

Connexion avec paramètres de pool

Host=postgres-server;Port=5432;Database=process_mining;Username=mindzie_user;Password=password;
Pooling=true;Minimum Pool Size=5;Maximum Pool Size=50;Timeout=30;

Dépannage

Problèmes courants de connexion

Erreur "Connection refused"

  • Vérifiez que PostgreSQL est en cours d'exécution : systemctl status postgresql
  • Vérifiez le nom d'hôte et le numéro de port du serveur
  • Validez la connectivité réseau et le pare-feu
  • Assurez-vous que PostgreSQL accepte les connexions : vérifier listen_addresses

Erreur "Authentication failed"

  • Vérifiez que le nom d'utilisateur et le mot de passe sont corrects
  • Contrôlez la configuration d'authentification dans pg_hba.conf
  • Assurez-vous que l'utilisateur existe : \du dans psql
  • Vérifiez la méthode d'authentification (md5, scram-sha-256)

Erreur "Database does not exist"

  • Vérifiez le nom de la base de données : \l dans psql
  • Vérifiez que l'utilisateur a les privilèges CONNECT sur la base
  • Assurez-vous que le nom de la base est correctement orthographié (sensible à la casse)

Problèmes de connexion SSL

  • Vérifiez la configuration SSL de PostgreSQL
  • Vérifiez les certificats SSL si le mode Require est utilisé
  • Utilisez SSL Mode=Prefer pour une négociation SSL automatique
  • Contrôlez le paramètre Trust Server Certificate

Configurations spécifiques au cloud

Amazon RDS PostgreSQL

  • Utilisez l’endpoint RDS comme nom d'hôte
  • Configurez les groupes de sécurité pour l'accès réseau
  • Activez les connexions SSL pour la protection des données

Azure Database pour PostgreSQL

  • Utilisez les noms de serveur pleinement qualifiés
  • Incluez @servername dans le nom d'utilisateur pour un serveur unique
  • Configurez les règles de pare-feu pour l'accès client
  • Activez les fonctionnalités de sécurité de connexion

Accès serveur mindzie : Pour une sécurité renforcée, vous pouvez configurer votre pare-feu pour n'autoriser les connexions qu'à partir des serveurs mindzie en listant les adresses IP spécifiques. Contactez le support mindzie pour obtenir les adresses IP actuelles des serveurs mindzie que vous utilisez.

Google Cloud SQL PostgreSQL

  • Configurez les réseaux autorisés ou utilisez Cloud SQL Proxy
  • Activez les certificats SSL pour des connexions sécurisées
  • Utilisez l’adresse IP privée pour une sécurité renforcée

Informations complémentaires

💡 Astuce : Profitez des fonctions analytiques avancées de PostgreSQL telles que les fonctions fenêtrées et les CTE pour des requêtes complexes de fouille de processus, qui peuvent être exécutées directement dans la base pour de meilleures performances.