PostgreSQL Database Connector

Categorie: Database Connectors

Introductie

Dit document is gemaakt om te helpen bij het instellen van een mindzieDataDesigner-connector voor een PostgreSQL-database. mindzieDataDesigner is de ETL-tool die door mindzieStudio wordt gebruikt om databasetabellen om te zetten naar process mining event logs. Het doel van dit document is om te helpen bij het aanmaken van de verbindingsreeks en het openen van poorten in de firewall indien nodig.

Overzicht

De PostgreSQL-connector biedt een hoge prestatieconnectiviteit met PostgreSQL-databases via de Npgsql data provider. Deze connector ondersteunt geavanceerde PostgreSQL-functies en is geoptimaliseerd voor analytische workloads die gebruikelijk zijn in process mining.

Systeemvereisten

  • Databasesysteem: PostgreSQL 10 of later (PostgreSQL 15+ aanbevolen)
  • Cloudondersteuning: Amazon RDS voor PostgreSQL, Azure Database voor PostgreSQL, Google Cloud SQL
  • Platformondersteuning: Windows, Linux, macOS
  • Afhankelijkheden: Npgsql .NET data provider - inbegrepen bij connector

Formaat Verbindingsreeks

Basisformaat

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

Verbindingsparameters

Parameter Beschrijving Vereist Voorbeeld
Host of Server Hostnaam van de PostgreSQL-server Ja postgres.company.com
Port Poortnummer van de server Nee 5432 (standaard)
Database Naam van de database Ja process_mining
Username of User ID PostgreSQL gebruikersnaam Ja mindzie_user
Password PostgreSQL wachtwoord Ja SecurePassword123
Timeout Timeout voor verbinding (seconden) Nee 30
Command Timeout Timeout voor commando (seconden) Nee 600
Pooling Schakel connection pooling in Nee true
Minimum Pool Size Minimum aantal connecties in de pool Nee 1
Maximum Pool Size Maximum aantal connecties in de pool Nee 100
SSL Mode SSL connectiemodus Nee Prefer
Trust Server Certificate Vertrouw SSL-certificaat Nee false

Voorbeelden van Verbindingen

Lokale PostgreSQL

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

Externe PostgreSQL met 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 voor PostgreSQL

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

Verbinding met Pool-instellingen

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;

Problemen Oplossen

Veelvoorkomende Verbindingsproblemen

"Connection refused" Fout

  • Controleer of PostgreSQL draait: systemctl status postgresql
  • Controleer server hostnaam en poortnummer
  • Valideer firewall en netwerkconnectiviteit
  • Zorg dat PostgreSQL verbindingen accepteert: controleer listen_addresses

"Authentication failed" Fout

  • Controleer of gebruikersnaam en wachtwoord correct zijn
  • Controleer pg_hba.conf authenticatieconfiguratie
  • Zorg dat gebruiker bestaat: \du in psql
  • Controleer authenticatiemethode (md5, scram-sha-256)

"Database does not exist" Fout

  • Controleer databasenaam: \l in psql
  • Controleer of gebruiker CONNECT-rechten heeft voor database
  • Let op correcte spelling van database (hoofdlettergevoelig)

SSL Verbindingsproblemen

  • Controleer PostgreSQL SSL-configuratie
  • Verifieer SSL-certificaten bij gebruik van Require-modus
  • Gebruik SSL Mode=Prefer voor automatische SSL-onderhandeling
  • Controleer instelling Trust Server Certificate

Cloud-Specifieke Configuraties

Amazon RDS PostgreSQL

  • Gebruik het RDS-endpoint als hostnaam
  • Configureer security groups voor netwerktoegang
  • Schakel SSL-verbindingen in voor databeveiliging

Azure Database voor PostgreSQL

  • Gebruik volledig gekwalificeerde servernamen
  • Voeg @servername toe in gebruikersnaam voor single server
  • Configureer firewallregels voor clienttoegang
  • Schakel beveiligingsfuncties voor verbinding in

Toegang tot mindzie Server: Voor extra beveiliging kunt u uw firewall configureren om alleen verbindingen vanaf mindzie-servers toe te staan door specifieke IP-adressen op een witte lijst te plaatsen. Neem contact op met mindzie support om de actuele IP-adressen te verkrijgen van de mindzie-servers die u gebruikt.

Google Cloud SQL PostgreSQL

  • Configureer geautoriseerde netwerken of gebruik Cloud SQL Proxy
  • Schakel SSL-certificaten in voor beveiligde verbindingen
  • Gebruik private IP voor verbeterde beveiliging

Gerelateerde Informatie

šŸ’” Tip: Maak gebruik van de geavanceerde analytische functies van PostgreSQL, zoals window functions en CTE's, voor complexe process mining queries die direct in de database kunnen worden uitgevoerd voor betere prestaties.