Willkommen zum Datenbanknavigations-Leitfaden! HarborDB bietet leistungsstarke Werkzeuge, um Ihre PostgreSQL-Datenbanken zu erkunden und zu verstehen. Dieser Leitfaden zeigt Ihnen, wie Sie Ihre Datenbankstruktur effektiv navigieren, Tabellen und Beziehungen untersuchen und das Beste aus der visuellen Oberfläche von HarborDB herausholen können.

Die Navigationsoberfläche

Seitenleisten-Übersicht

Die linke Seitenleiste ist Ihr primäres Navigationswerkzeug. Sie zeigt eine hierarchische Ansicht Ihrer Datenbankstruktur:

Verbindungsname
├── Datenbanken
│   ├── Datenbank 1
│   │   ├── Schemas
│   │   │   ├── public
│   │   │   │   ├── Tabellen
│   │   │   │   ├── Views
│   │   │   │   ├── Funktionen
│   │   │   │   └── Sequenzen
│   │   │   └── andere_schemas
│   │   └── Einstellungen
│   └── Datenbank 2
└── Systemobjekte

Navigationsmodi

HarborDB bietet zwei Hauptnavigationsmodi:

Baumansicht (Standard): Hierarchische Erweiterung von Objekten
Suchansicht: Schnelle Suche über alle Objekte

Datenbanken erkunden

Verfügbare Datenbanken anzeigen

Wenn Sie sich zum ersten Mal verbinden, sehen Sie eine Liste der Datenbanken, auf die Sie Zugriff haben:

Erweitern Sie Ihre Verbindung in der Seitenleiste
Klicken Sie auf "Datenbanken", um die Liste zu sehen
Doppelklicken Sie auf eine beliebige Datenbank, um deren Inhalte zu erkunden

Datenbankinformationen

Rechtsklicken Sie auf eine beliebige Datenbank für schnellen Zugriff auf:

Eigenschaften: Datenbankgröße, Encoding, Kollation anzeigen
Neuer Abfrage-Tab: Abfrage-Editor öffnen, der bereits mit dieser Datenbank verbunden ist
Aktualisieren: Datenbankliste aktualisieren
Datenbank erstellen: Wenn Sie Berechtigungen haben

Arbeiten mit Schemas

Schemas verstehen

Schemas sind logische Container innerhalb von Datenbanken. PostgreSQL verwendet standardmäßig das public-Schema, aber Sie können anderen begegnen.

Schema-Inhalte erkunden

Erweitern Sie eine Datenbank, um deren Schemas zu sehen
Erweitern Sie ein Schema, um Objekttypen zu sehen:
- Tabellen: Datenspeicherung
- Views: Virtuelle Tabellen aus Abfragen
- Funktionen: Gespeicherte Prozeduren und Funktionen
- Sequenzen: Automatisch inkrementierende Zahlengeneratoren

Schema-Operationen

Rechtsklicken Sie auf ein Schema, um:

Neue Tabelle/View/Funktion erstellen
Schema-Inhalte aktualisieren
Als Standard setzen: Machen Sie dies zu Ihrem bevorzugten Schema

Tabellen untersuchen

Tabellenstruktur-Ansicht

Wenn Sie den "Tabellen"-Ordner erweitern, sehen Sie alle Tabellen im Schema. Klicken Sie auf eine beliebige Tabelle, um zu sehen:

Spalten-Tab

Spaltennamen und Datentypen
Constraints (Primärschlüssel, Fremdschlüssel, etc.)
Standardwerte und nullable-Status
Speicherinformationen

Datenvorschau-Tab

Erste 100 Zeilen der Tabellendaten
Sortierbare Spalten (Kopfzeilen anklicken)
Filterbare Daten (rechtsklick auf Spaltenkopfzeilen)
Schnell-Export-Optionen

Indizes-Tab

Indexnamen und Typen
Indizierte Spalten
Indexgröße und Statistiken

Fremdschlüssel-Tab

Beziehungen zu anderen Tabellen
Referenzierte Tabellen und Spalten
Cascade-Regeln

Tabellen-Schnellaktionen

Rechtsklicken Sie auf eine beliebige Tabelle für sofortigen Zugriff auf:

| Aktion | Beschreibung | Tastenkombination | | -------------------- | ------------------------------------------------ | ----------------- | | Select Top 100 | Abfrage mit SELECT * FROM tabelle LIMIT 100 öffnen | ⌘ + Klick | | Struktur anzeigen | Tabellenstruktur in Detailansicht öffnen | ⌥ + Klick | | SELECT generieren | Basis-SELECT-Abfrage für diese Tabelle erstellen | | | INSERT generieren | INSERT-Vorlage erstellen | | | Daten exportieren | Tabelle nach CSV/JSON exportieren | ⌘ + E | | Aktualisieren | Tabelleninformationen aktualisieren | ⌘ + R |

Views verstehen

View vs. Tabelle

Views erscheinen ähnlich wie Tabellen, sind aber virtuelle Objekte basierend auf SQL-Abfragen:

Reguläre Views: Gespeicherte Abfragedefinitionen
Materialisierte Views: Vorberechnete Ergebnisse (gecached)

View-Informationen

Klicken Sie auf eine beliebige View, um zu sehen:

Definition: Die SQL-Abfrage, die die View definiert
Spalten: Resultsatz-Struktur
Abhängigkeiten: Tabellen und Views, von denen diese View abhängt

Arbeiten mit großen Datenbanken

Filtern und Suchen

Bei der Arbeit mit vielen Objekten verwenden Sie diese Funktionen:

Schnellfilter

Klicken Sie in das Suchfeld oben in der Seitenleiste
Geben Sie den Objektnamen ein, um in Echtzeit zu filtern
Verwenden Sie Wildcards: *users* findet alle Objekte mit "users" im Namen

Erweiterte Suche

Suchbereich einschränken: Auf Tabellen, Views oder alle Objekte begrenzen
Groß-/Kleinschreibung umschalten: Exakte Groß-/Kleinschreibung abgleichen
Regex-Unterstützung: Reguläre Ausdrücke für komplexe Muster verwenden

Favorisierte Objekte

Markieren Sie häufig genutzte Objekte für schnellen Abruf:

Rechtsklicken Sie auf ein beliebiges Objekt
Wählen Sie "Zu Favoriten hinzufügen"
Greifen Sie auf Favoriten aus dem Favoriten-Bereich der Seitenleiste zu

Beziehungen untersuchen

Tabellenbeziehungen visualisieren

HarborDB hilft Ihnen zu verstehen, wie Tabellen verbunden sind:

Fremdschlüssel-Visualisierung

Rechtsklicken Sie auf eine beliebige Tabelle mit Fremdschlüsseln
Wählen Sie "Beziehungen anzeigen"
Sehen Sie eine grafische Darstellung der Verbindungen

Abhängigkeitsanalyse

Sehen Sie, was von dieser Tabelle abhängt
Zirkuläre Referenzen identifizieren
Auswirkungen von Schemaänderungen verstehen

Beziehungs-Browser

Für komplexe Datenbanken verwenden Sie den Beziehungs-Browser:

Öffnen Sie Tools-Menü → Beziehungs-Browser
Wählen Sie Starttabelle
Erkunden Sie Verbindungen visuell
Beziehungsdiagramm exportieren zur Dokumentation

Praktische Navigationsbeispiele

Beispiel 1: Eine neue Datenbank erkunden

Wenn Sie eine Verbindung zu einer unbekannten Datenbank herstellen:

Datenbankgröße prüfen (rechtsklick Datenbank → Eigenschaften)
Alle Schemas auflisten und die Hauptschemas identifizieren
Tabellenanzahl in jedem Schema überprüfen
Größte Tabellen untersuchen (nach Zeilenanzahl oder Größe sortieren)
Nach Dokumentationstabellen suchen (oft benannt: docs, documentation, readme)

Beispiel 2: Bestimmte Daten finden

Wenn Sie Kundendaten finden müssen:

Nach Tabellen suchen, die "customer", "user" oder "client" enthalten
Wahrscheinliche Tabellen auf relevante Spalten untersuchen
Fremdschlüssel prüfen, um verwandte Daten zu finden
Datenvorschau verwenden, um tatsächliche Daten zu beproben

Beispiel 3: Anwendungsstruktur verstehen

Um zu verstehen, wie eine Anwendung Daten organisiert:

Tabellen nach Präfix gruppieren (z.B. app_, auth_, report_)
Namenskonventionen untersuchen
Nach Fremdschlüssel-Mustern suchen
Lookup-/Referenztabellen identifizieren

Tastenkombinationen für die Navigation

Beherrschen Sie diese Tastenkombinationen für effiziente Navigation:

| Tastenkombination | Aktion | | ----------------- | ------------------------------- | | ⌘ + B | Seitenleisten-Sichtbarkeit umschalten | | ⌘ + F | Fokus auf Suche in Seitenleiste | | ⌘ + G | Nächstes in Suchergebnissen finden | | ⌥ + Klick | Objekt in neuem Tab öffnen | | ⌘ + Klick | SELECT-Abfrage für Tabelle öffnen | | ⌘ + R | Aktuelle Ansicht aktualisieren | | ⌘ + . | Suche/Filter löschen | | ⌘ + 1-9 | Zwischen Seitenleistenabschnitten wechseln |

Navigations-Best Practices

Organisationstipps

Verwenden Sie aussagekräftige Verbindungsnamen: Umgebung (Dev, Prod) und Zweck einschließen
Verwandte Verbindungen gruppieren: Lokale Entwicklung, Staging, Produktion
Nach Umgebung farbkodieren: Grün für Dev, Gelb für Staging, Rot für Prod
Verbindungsvorlagen erstellen: Für ähnliche Datenbank-Setups

Leistungsüberlegungen

Auto-Erweiterung begrenzen: Nicht alles auf einmal erweitern
Für große Datenbanken Suche statt Durchsuchen verwenden
Ungenutzte Verbindungen schließen, um Ressourcen freizugeben
Cache regelmäßig löschen für sehr große Schemas

Sicherheitspraktiken

Verbindungsspezifische Anmeldedaten verwenden, wenn möglich
Sichtbarkeit von Schemas mit geeigneten Berechtigungen einschränken
Vermeiden Sie, Produktionspasswörter in weniger sicheren Umgebungen zu speichern
Verbindungsnutzung regelmäßig überprüfen

Fehlerbehebung bei Navigationsproblemen

"Objekt nicht gefunden"-Fehler

Wenn Sie erwartete Objekte nicht sehen können:

Verbindung aktualisieren (rechtsklick → Aktualisieren)
Ihre Berechtigungen auf der Datenbank prüfen
Verifizieren Sie, dass Sie im richtigen Schema sind
Bestätigen Sie, dass Objekt nicht umbenannt oder gelöscht wurde

Langsame Navigationsleistung

Bei träger Reaktion:

Auto-Erweiterungstiefe in den Einstellungen reduzieren
Vorschaubilder für große Tabellen deaktivieren
Abfrage-Timeout für Remote-Verbindungen erhöhen
Suche statt Baum-Erweiterung verwenden

Fehlende Beziehungen

Wenn Fremdschlüssel nicht angezeigt werden:

Prüfen Sie, ob Fremdschlüssel in PostgreSQL korrekt definiert sind
Verifizieren Sie Ihre Berechtigungen, Constraint-Informationen anzuzeigen
Tabellen-Metadaten aktualisieren
Auf verzögerte Constraint-Überprüfung prüfen

Erweiterte Navigationsfunktionen

Benutzerdefinierte Abfragen für Erkundung

Erstellen Sie gespeicherte Abfragen für komplexe Erkundung:

-- Alle Tabellen mit bestimmter Spalte finden
SELECT
    table_schema,
    table_name,
    column_name,
    data_type
FROM information_schema.columns
WHERE column_name ILIKE '%email%'
ORDER BY table_schema, table_name;

-- Größte Tabellen auflisten
SELECT
    schemaname,
    tablename,
    pg_size_pretty(pg_total_relation_size(schemaname || '.' || tablename)) as size
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY pg_total_relation_size(schemaname || '.' || tablename) DESC
LIMIT 20;

Häufige Pfade bookmarken

Speichern Sie häufig genutzte Navigationspfade:

Navigieren Sie zu Ihrem Zielobjekt
Klicken Sie auf Lesezeichen-Button in der Symbolleiste
Benennen Sie das Lesezeichen (z.B. "Kunden-Analyse-Tabellen")
Greifen Sie auf Lesezeichen aus dem Lesezeichen-Menü zu

Datenbankstruktur exportieren

Dokumentieren Sie Ihre Datenbankstruktur:

Objekte in Seitenleiste auswählen
Rechtsklick → Struktur exportieren
Format wählen: SQL, Markdown oder HTML
Optionen einbeziehen: Mit Daten, Constraints, Indizes

Nächste Schritte

Jetzt, da Sie Datenbanken effektiv navigieren können:

Abfragegrundlagen – Lernen Sie, SQL-Abfragen zu schreiben und auszuführen
Daten exportieren – Ergebnisse in CSV oder JSON speichern
Leistungsoptimierung – Ihren Datenbank-Workflow optimieren

Hilfe erhalten

Wenn Sie auf Navigationsprobleme stoßen:

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

Datenbanknavigation in HarborDB