Doku

Live-Datenbank

Verbinde deine echte Datenbank, damit JillionDB dir sagt, wenn sie und JillionDB nicht übereinstimmen. Pro und Enterprise.

Was es tut

JillionDB liest die Tabellendefinitionen deiner PostgreSQL- oder MySQL-Datenbank und vergleicht sie mit dem Schema in deinem Projekt. Hat jemand die Datenbank außerhalb von JillionDB geändert oder wurde eine angenommene Änderung noch nicht angewendet, siehst du jede Abweichung in klaren Worten.

Führe das einmal als Admin auf deiner Datenbank aus. Setze deinen Datenbanknamen und ein langes Passwort ein.

PostgreSQL (Neon, Supabase, Amazon RDS und andere):

CREATE ROLE jilliondb_reader LOGIN PASSWORD 'choose-a-long-password';
GRANT CONNECT ON DATABASE your_database TO jilliondb_reader;
GRANT USAGE ON SCHEMA public TO jilliondb_reader;

MySQL:

CREATE USER 'jilliondb_reader'@'%' IDENTIFIED BY 'choose-a-long-password';
GRANT REFERENCES ON your_database.* TO 'jilliondb_reader'@'%';

PostgreSQL lässt jeden Login Tabellendefinitionen lesen, und das MySQL-Recht REFERENCES zeigt sie, ohne Lesezugriff zu erlauben. Keiner der beiden Logins sieht deine Daten.

Verbinden

Öffne dein Projekt und klicke in der Werkzeugleiste auf das Datenbanksymbol.
Füge die Verbindungs-URL deines Anbieters mit dem Login von oben ein, oder fülle die Felder einzeln aus.
Wähle die Verschlüsselung: Verschlüsselt, Zertifikat geprüft für Neon, Supabase und die meisten gehosteten Datenbanken, oder Nur verschlüsselt für Anbieter mit eigenem Zertifikat, etwa Amazon RDS.
Klicke auf Verbinden und prüfen. JillionDB liest die Datenbank und zeigt, ob sie übereinstimmt.

Wenn sie abweichen

Die Liste zeigt, was JillionDB ändern würde, um deine Datenbank abzubilden. Mit JillionDB angleichen bringst du dein Projekt auf Stand; das aktuelle Schema wird vorher als Version gespeichert, damit du zurückkannst. Hinkt die Datenbank hinterher, wende deine Migrationen wie gewohnt an und klicke auf Jetzt prüfen.

Mit automatischer Prüfung schaut JillionDB alle paar Stunden nach, und auch, wenn du das Projekt nach einer Stunde oder länger öffnest.

Wenn keine Verbindung zustande kommt

Lässt deine Datenbank nur bestimmte IP-Adressen zu, gib 162.254.39.64 frei. Datenbanken in privaten Netzen kann JillionDB nicht erreichen; nutze die öffentliche Adresse deines Anbieters.

Private, lokale und SQLite-Datenbanken: der Bridge

Wenn JillionDB deine Datenbank nicht erreichen kann, weil sie auf deinem Laptop, in einem privaten Netz oder eine SQLite-Datei ist, nutze stattdessen den Bridge. Das ist ein kleiner Open-Source-Befehl, der die Tabellendefinitionen dort liest, wo deine Datenbank ist, und nur diese an JillionDB sendet. Dein Datenbank-Passwort verlässt nie deinen Rechner, und JillionDB verbindet sich nie von außen.

Öffne dein Projekt, klicke auf den Datenbank-Button und wähle Bridge ausführen.
Klicke auf Token erstellen und kopiere es. Damit kann der Bridge nur Tabellendefinitionen an dieses eine Projekt senden.
Führe den Befehl dort aus, wo deine Datenbank erreichbar ist, mit deinem eigenen Connection-String oder dem Pfad zu deiner SQLite-Datei.

npx jilliondb push --token jdbb_… --url postgresql://user:password@localhost:5432/app

Das Ergebnis erscheint sofort, im Terminal und im Projekt. Mit --watch läuft der Bridge weiter und sendet alle 15 Minuten erneut. Oder führe ihn nach jedem Deploy in CI mit --fail-on-drift aus, damit der Build stoppt, wenn Datenbank und JillionDB nicht übereinstimmen. Mit --print siehst du genau, was gesendet würde, ohne etwas zu senden.

Der Bridge braucht Node 20 oder neuer, für SQLite-Dateien Node 22.13 oder neuer. Token und Datenbank kannst du auch über JILLIONDB_TOKEN und DATABASE_URL setzen, statt sie in den Befehl zu schreiben.

Trennen

Klicke im selben Fenster auf Trennen. JillionDB löscht den gespeicherten Login und hört auf zu prüfen. Bis dahin ist das Passwort verschlüsselt gespeichert. Du kannst den Login auch jederzeit in deiner Datenbank löschen.