PostgreSQL Database Connector

Kategorie: Datenbank-Connectoren

Einführung

Dieses Dokument wurde erstellt, um beim Einrichten eines mindzieDataDesigner-Connectors für eine PostgreSQL-Datenbank zu helfen. Der mindzieDataDesigner ist das ETL-Tool, das von mindzieStudio verwendet wird, um Datenbanktabellen in Process-Mining-Event-Logs umzuwandeln. Zweck dieses Dokuments ist es, bei der Erstellung der Verbindungszeichenfolge und beim Öffnen von Ports in der Firewall zu unterstützen, falls erforderlich.

Übersicht

Der PostgreSQL-Connector stellt eine leistungsstarke Verbindung zu PostgreSQL-Datenbanken über den Npgsql-Datenanbieter bereit. Dieser Connector unterstützt erweiterte PostgreSQL-Funktionen und ist für analytische Workloads optimiert, die im Process Mining üblich sind.

Systemvoraussetzungen

  • Datenbanksystem: PostgreSQL 10 oder neuer (PostgreSQL 15+ empfohlen)
  • Cloud-Unterstützung: Amazon RDS für PostgreSQL, Azure Database für PostgreSQL, Google Cloud SQL
  • Plattformunterstützung: Windows, Linux, macOS
  • Abhängigkeiten: Npgsql .NET-Datenanbieter - im Connector enthalten

Format der Verbindungszeichenfolge

Grundformat

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

Verbindungsparameter

Parameter Beschreibung Erforderlich Beispiel
Host oder Server Hostname des PostgreSQL-Servers Ja postgres.company.com
Port Portnummer des Servers Nein 5432 (Standard)
Database Name der Datenbank Ja process_mining
Username oder User ID PostgreSQL-Benutzername Ja mindzie_user
Password PostgreSQL-Passwort Ja SecurePassword123
Timeout Verbindungs-Timeout (Sekunden) Nein 30
Command Timeout Ausführungs-Timeout (Sekunden) Nein 600
Pooling Aktiviert Connection Pooling Nein true
Minimum Pool Size Minimale Anzahl Pool-Verbindungen Nein 1
Maximum Pool Size Maximale Anzahl Pool-Verbindungen Nein 100
SSL Mode SSL-Verbindungsmodus Nein Prefer
Trust Server Certificate SSL-Zertifikat vertrauen Nein false

Verbindungsbeispiele

Lokales PostgreSQL

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

Remote PostgreSQL mit 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 für PostgreSQL

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

Verbindung mit Pool-Einstellungen

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;

Fehlerbehebung

Häufige Verbindungsprobleme

„Connection refused“-Fehler

  • Überprüfen, ob PostgreSQL läuft: systemctl status postgresql
  • Server-Hostname und Portnummer prüfen
  • Firewall- und Netzwerkverbindung prüfen
  • Sicherstellen, dass PostgreSQL Verbindungen akzeptiert: listen_addresses prüfen

„Authentication failed“-Fehler

  • Benutzername und Passwort auf Richtigkeit prüfen
  • pg_hba.conf Authentifizierungskonfiguration prüfen
  • Sicherstellen, dass der Benutzer existiert: \du in psql
  • Authentifizierungsmethode prüfen (md5, scram-sha-256)

„Datenbank existiert nicht“-Fehler

  • Datenbanknamen prüfen: \l in psql
  • Prüfen, ob Benutzer CONNECT-Berechtigung für die Datenbank hat
  • Richtiges Schreiben des Datenbanknamens (Groß-/Kleinschreibung beachten)

SSL-Verbindungsprobleme

  • PostgreSQL SSL-Konfiguration prüfen
  • SSL-Zertifikate bei „Require“-Modus validieren
  • Für automatische SSL-Verhandlung SSL Mode=Prefer verwenden
  • Einstellung „Trust Server Certificate“ prüfen

Cloud-spezifische Konfigurationen

Amazon RDS PostgreSQL

  • RDS-Endpunkt als Hostname verwenden
  • Sicherheitsgruppen für Netzwerkzugriff konfigurieren
  • SSL-Verbindungen für Datenschutz aktivieren

Azure Database für PostgreSQL

  • Vollqualifizierte Servernamen verwenden
  • @servername im Benutzernamen für Single Server einfügen
  • Firewall-Regeln für Client-Zugriff konfigurieren
  • Sicherheitsfunktionen für Verbindungen aktivieren

mindzie Serverzugriff: Für erhöhte Sicherheit können Sie Ihre Firewall so konfigurieren, dass Verbindungen nur von mindzie-Servern erlaubt sind, indem Sie spezifische IP-Adressen auf die Whitelist setzen. Kontaktieren Sie den mindzie-Support, um die aktuellen IP-Adressen der von Ihnen genutzten mindzie-Server zu erhalten.

Google Cloud SQL PostgreSQL

  • Autorisierte Netzwerke konfigurieren oder Cloud SQL Proxy verwenden
  • SSL-Zertifikate für sichere Verbindungen aktivieren
  • Private IP für erhöhte Sicherheit nutzen

Weiterführende Informationen

💡 Tipp: Nutzen Sie die erweiterten analytischen Funktionen von PostgreSQL wie Window Functions und CTEs für komplexe Process-Mining-Abfragen, die direkt in der Datenbank ausgeführt werden können, um eine bessere Performance zu erzielen.