Zum Inhalt springen
Samuel Statz
Menü

SamsDBview.

Macht aus einer Postgres-Datenbank eine Landkarte, die man anschauen und verstehen kann. Und sorgt dafür, dass die Erklärungen dazu nicht heimlich veralten.

Node und TypeScript. Du musst nichts programmieren können: du legst eine Datei ab und schreibst Text.

Von der leeren Datenbank zur erklärten Landkarte

Das Problem

Eine Datenbank, die gewachsen ist, kennt niemand mehr ganz. Es gibt eine Dokumentation, aber sie stammt aus dem Jahr, in dem jemand Zeit dafür hatte. Neue Tabellen tauchen nie darin auf, und gelöschte stehen noch drin. Man merkt es erst, wenn jemand danach handelt.

Der Ansatz

Das Schema wird eingelesen und als Landkarte gezeichnet: jede Tabelle eine Karte mit ihren echten Spalten, Farbe nach Kategorie. Die Erklärungen stehen daneben in eigenen Dateien und werden gegen das echte Schema abgeglichen. Kommt eine Tabelle dazu, sagt das Werkzeug es, statt zu schweigen.

Loslegen

  1. Herunterladen und öffnen

    Ordner von GitHub holen, in VS Code öffnen, Terminal aufmachen.

  2. Zwei Befehle

    npm install, dann npm run beispiel1. Der zweite lädt eine Beispieldatenbank, liest sie ein und öffnet die Ansicht.

  3. Eigene Datenbank

    Verbindungsdaten eintragen und npm run einlesen. Klemmt etwas, sagt npm run doktor in einer Zeile pro Punkt, was fehlt.

Auf GitHub ansehen →

Lizenz: PolyForm Noncommercial License 1.0.0. Privat, zum Lernen und für Hobbyprojekte frei, ebenso für Vereine, Schulen und Hochschulen. Gewerbliche Nutzung nicht, dazu gehört der Einsatz auf Datenbanken eines Unternehmens im Rahmen seines Geschäftsbetriebs.