Willkommen bei HarborDB! Diese Anleitung führt Sie durch das Erstellen Ihrer ersten PostgreSQL-Verbindung. Egal, ob Sie eine lokale Datenbank auf Ihrem Mac oder einen Remote-Server verbinden – HarborDB macht den Prozess einfach und sicher.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:

HarborDB installiert (siehe Installationsanleitung)
PostgreSQL-Server läuft und ist erreichbar
Verbindungsdetails bereit:
- Hostname oder IP-Adresse
- Port-Nummer (Standard: 5432)
- Datenbankname
- Benutzername und Passwort
- Optional: SSL-Zertifikat falls erforderlich

Schritt 1: HarborDB starten und Verbindungen aufrufen

Öffnen Sie HarborDB aus Ihrem Anwendungsordner oder Launchpad
Finden Sie die Verbindungs-Seitenleiste auf der linken Seite des Fensters
Klicken Sie auf die "+"-Schaltfläche oder gehen Sie zu Datei → Verbindung hinzufügen

Schritt 2: Verbindungsdetails ausfüllen

Der Verbindungsdialog hat mehrere Felder, die auszufüllen sind:

Grundlegende Informationen

Name: Ein Anzeigename für diese Verbindung (z.B. "Lokale Entwicklung", "Produktionsserver")
Host: Die PostgreSQL-Server-Adresse
- Lokale Datenbank: localhost oder 127.0.0.1
- Remote-Server: IP-Adresse oder Hostname (z.B. db.example.com)
Port: PostgreSQL-Port (Standard: 5432)
Datenbank: Die spezifische Datenbank, zu der Sie eine Verbindung herstellen möchten
Benutzername: Ihr PostgreSQL-Benutzername
Passwort: Ihr PostgreSQL-Passwort

Erweiterte Optionen (Optional)

Schema: Bevorzugtes Schema (standardmäßig public)
SSL-Modus: Wählen Sie basierend auf Ihrer Serverkonfiguration:
- prefer: SSL verwenden, falls verfügbar
- require: SSL-Verbindung erforderlich
- verify-full: SSL mit Zertifikatsvalidierung erforderlich
Timeout: Verbindungs-Timeout in Sekunden
Anwendungsname: Benutzerdefinierter Identifier für diese Verbindung

Schritt 3: Ihre Verbindung testen

Speichern Sie immer zuerst Ihre Verbindung:

Klicken Sie auf "Verbindung testen" im Dialog
Warten Sie auf Bestätigung – Sie sollten "Verbindung erfolgreich" sehen
Überprüfen Sie alle Warnungen bezüglich SSL oder anderen Einstellungen

Häufige Testergebnisse

✅ Erfolg: Sie können speichern und verbinden
❌ Fehler: Überprüfen Sie die Fehlermeldung für Hinweise:
- "Verbindung abgelehnt": Server läuft nicht oder Firewall blockiert
- "Authentifizierung fehlgeschlagen": Falscher Benutzername/Passwort
- "Datenbank existiert nicht": Datenbankname inkorrekt

Schritt 4: Verbindung speichern und sichern

Passwortspeicheroptionen

HarborDB bietet sichere Passwortspeicherung:

In Keychain speichern (Empfohlen): Passwort verschlüsselt im macOS Keychain
In Verbindung speichern: Passwort mit Verbindungseinstellungen gespeichert (weniger sicher)
Jedes Mal fragen: Bei jeder Verbindung nach Passwort fragen

Die richtige Option wählen

| Speichermethode | Sicherheit | Komfort | Am besten geeignet für | | ------------------- | ------------ | ------------ | ------------------------------- | | macOS Keychain | 🔒 Hoch | ⚡ Hoch | Tägliche Nutzung, vertrauenswürdige Computer | | Verbindungsdatei | 🔒 Mittel | ⚡ Hoch | Schnelle Einrichtung, Tests | | Jedes Mal fragen | 🔒 Höchste | ⚡ Niedrig | Gemeinsam genutzte Computer, hohe Sicherheit |

Ihre Verbindung speichern

Wählen Sie Passwortspeichermethode
Klicken Sie auf "Speichern", um die Verbindung zu speichern
Finden Sie Ihre Verbindung in der Verbindungs-Seitenleiste
Doppelklicken Sie, um zu verbinden

Schritt 5: Verbinden und erkunden

Sobald verbunden, können Sie:

Ihre Datenbank navigieren

Erweitern Sie die Verbindung, um Datenbanken zu sehen
Durchsuchen Sie Schemas und Tabellen in der Seitenleiste
Rechtsklicken Sie auf Tabellen für schnelle Aktionen:
- Tabellenstruktur anzeigen
- Erste 100 Zeilen vorschauen
- SELECT-Abfrage generieren

Schnellstart-Aktionen

Abfrage-Editor öffnen: Klicken Sie auf das SQL-Symbol oder drücken Sie ⌘ + N
Eine Testabfrage ausführen:
```
SELECT version();
```
Oberfläche erkunden: Machen Sie sich mit Tabs, Panels und Tools vertraut

Verbindungsverwaltung

Mehrere Verbindungen organisieren

Wenn Sie mehr Verbindungen hinzufügen, halten Sie sie organisiert:

Favoriten: Markieren Sie häufig verwendete Verbindungen für schnellen Zugriff
Gruppen: Organisieren Sie nach Projekt, Umgebung oder Team
Farbcodierung: Verwenden Sie Tags oder Namenskonventionen

Bestehende Verbindungen bearbeiten

Rechtsklicken Sie auf Verbindung in der Seitenleiste
Wählen Sie "Verbindung bearbeiten"
Aktualisieren Sie alle benötigten Felder
Testen und speichern Sie Änderungen

Verbindungen duplizieren

Sparen Sie Zeit durch Duplizieren ähnlicher Verbindungen:

Rechtsklicken Sie auf Quellverbindung
Wählen Sie "Duplizieren"
Ändern Sie nur die geänderten Felder
Speichern Sie als neue Verbindung

Sicherheitsbest Practices

Passwortsicherheit

Teilen Sie niemals Keychain-Passwörter
Verwenden Sie starke Passwörter für PostgreSQL-Benutzer
Rotieren Sie Passwörter regelmäßig
Vermeiden Sie Wiederverwendung von Passwörtern über verschiedene Server

Verbindungssicherheit

Verwenden Sie SSL für Remote-Verbindungen
Begrenzen Sie Datenbankberechtigungen auf notwendige Operationen
Verwenden Sie schreibgeschützte Verbindungen für Berichte
Überprüfen Sie regelmäßig Verbindungsprotokolle

Netzwerksicherheit

Firewall-Konfiguration: Erlauben Sie nur vertrauenswürdige IPs
VPN-Zugriff für Remote-Datenbanken
SSH-Tunneling für zusätzliche Sicherheitsebenen

Häufige Verbindungsszenarien

Lokales PostgreSQL (via Homebrew installiert)

Name: Lokales PostgreSQL
Host: localhost
Port: 5432
Datenbank: postgres
Benutzername: Ihr_Benutzername
Passwort: [Keychain]

Docker PostgreSQL Container

Name: Docker Dev DB
Host: localhost
Port: 5432  # Oder benutzerdefinierter Port falls anders gemappt
Datenbank: app_datenbank
Benutzername: postgres
Passwort: postgres_passwort

Amazon RDS PostgreSQL

Name: AWS Produktion
Host: Ihre-db-instanz.region.rds.amazonaws.com
Port: 5432
Datenbank: produktions_db
Benutzername: app_benutzer
SSL-Modus: verify-full

Google Cloud SQL

Name: GCP Cloud SQL
Host: /cloudsql/projekt:region:instanz
Port: 5432
Datenbank: cloud_db
SSL-Modus: require

Fehlerbehebung bei Verbindungsproblemen

"Kann nicht mit Server verbinden"

Überprüfen Sie, ob PostgreSQL läuft:

# Im Terminal
pg_isready -h localhost -p 5432

Überprüfen Sie Firewall-Einstellungen:
- macOS Firewall (Systemeinstellungen → Sicherheit & Datenschutz)
- Netzwerk-Firewall-Regeln

Testen Sie Netzwerkverbindung:

# Im Terminal
ping Ihre-Server-Adresse
telnet Ihre-Server-Adresse 5432

"Passwort-Authentifizierung fehlgeschlagen"

Überprüfen Sie PostgreSQL-Authentifizierungsmethode:
- Zeigen Sie pg_hba.conf-Datei an
- Stellen Sie md5 oder scram-sha-256 Authentifizierung sicher

Passwort bei Bedarf zurücksetzen:

ALTER USER benutzername WITH PASSWORD 'neues_passwort';

Überprüfen Sie, ob Benutzer Datenbankzugriff hat:

-- Als Superuser verbinden
\du  -- Benutzer auflisten
\l   -- Datenbanken auflisten

SSL/TLS-Verbindungsfehler

Überprüfen Sie SSL-Anforderungen:
- Server benötigt möglicherweise bestimmten SSL-Modus
- Zertifikat muss möglicherweise importiert werden
Passen Sie SSL-Modus in Verbindungseinstellungen an
Importieren Sie Zertifikat falls Sie verify-full-Modus verwenden

Leistungstipps

Verbindungspooling

Halten Sie Verbindungen offen für häufige Nutzung
Schließen Sie ungenutzte Verbindungen, um Ressourcen freizugeben
Verwenden Sie Verbindungspooling für Anwendungen

Netzwerkoptimierung

Lokale Verbindungen: Verwenden Sie localhost für beste Leistung
Remote-Verbindungen: Stellen Sie ausreichende Bandbreite sicher
Kompression: Aktivieren Sie bei großen Ergebnismengen

Nächste Schritte

Jetzt, da Sie verbunden sind:

Abfragegrundlagen erkunden – Lernen Sie, SQL-Abfragen zu schreiben und auszuführen
Datenbanknavigation – Erkunden Sie Schemas, Tabellen und Beziehungen
Daten exportieren – Ergebnisse in CSV oder JSON speichern

Hilfe erhalten

Wenn Sie immer noch Probleme haben:

Überprüfen Sie unseren Support-Leitfaden für weitere Fehlerbehebung
Besuchen Sie die FAQ für häufig gestellte Fragen
Kontaktieren Sie den Support für persönliche Unterstützung

Ihre erste Verbindung erstellen