SQLly Embedded
Hoste SQLly in deiner eigenen Web-App: was im Paket steckt, wie die Bridge, deine App und sqlly.app zusammenspielen und wo du einsteigst.
SQLLY Embedded bringt den Browser-Build von SQLLY in deine eigene Web-App. Deine Nutzer bekommen die komplette Workbench auf einer Seite deiner Website: den SQL-Editor mit IntelliSense, den Objektbrowser, das Ergebnisraster, Diagramme und Ausführungspläne. Dein Server behält jedes Datenbankpasswort. Du entscheidest, welche Verbindungen jede Nutzergruppe sieht, und die SQLLY-Bridge setzt deine Lizenz durch.
Was du ausführst
| Baustein | Was es bewirkt | Wo es ausgeführt wird |
|---|---|---|
| Deine Webanwendung | Meldet deine Nutzer an, entscheidet, welches Profil (Menge an Verbindungen) jeder bekommt, die Bridge nach einem Starttoken fragt und die Seite ausliefert, die SQLly lädt. | Dein Server |
SQLly-Bridge (sqlly-bridge embedded) | Hält die Profile und deren Zugangsdaten, stellt Launch-Tokens aus, akzeptiert Browser-WebSockets, führt eine Engine pro Sitzung aus, zählt die Plätze und prüft die Lizenz bei sqlly.app. | Dein Server, neben deiner App |
SQLly-Engine (sqlly-cli) | Verbindet sich mit deinen Datenbanken und führt für eine Browsersitzung Abfragen aus. Die Bridge startet und stoppt sie; sonst redet niemand mit ihr. | Dein Server (Kindprozess der Bridge) |
SQLly Web-Bundle (web/) | Die SQLly-App, kompiliert zu WebAssembly. Statische Dateien, die deine App ausliefert. | Die Browser deiner Benutzer |
| sqlly.app | Stellt deine Lizenz aus und signiert jedes Mal, wenn sich die Bridge meldet (alle 20 Minuten), eine kurzlebige Freigabe. Offline-Lizenzen kontaktieren ihn nie. | Unsere |
Das Paket enthält auch eine Beispiel-Admin-App (Node.js, keine Abhängigkeiten), die alles macht, was deine App tun würde: einen Admin-Bildschirm für Profile, Labels und Benutzer sowie eine Anmeldeseite, die SQLly für jeden Benutzer öffnet. Führe sie aus, um den ganzen Ablauf zu sehen, und ersetze sie dann durch deine eigene App oder starte mit ihrem Code.
In diesem Abschnitt
- So funktioniert es
- Die Funktionsweise: die Bridge, die Engine pro Sitzung, Starttoken, die signierte Lizenzfreigabe, Check-ins, Plätze, die Origin-Regel und wo die Zugangsdaten liegen.
- Schnellstart
- Führe das SQLly-Embedded-Paket in fünf Minuten auf localhost aus: starte die Bridge und die Beispiel-App, verknüpfe eine Lizenz, füge ein Profil hinzu und öffne SQLly als Benutzer.
- Tour durch die Beispiel-App
- Eine Bildschirm-für-Bildschirm-Tour der Beispiel-Admin-App, die mit SQLly Embedded ausgeliefert wird: Status und Lizenzierung, Profile und Verbindungen, Labels, Benutzer und das Starten von SQLly.
- Eigene App entwickeln
- Schritt für Schritt: Steuere die SQLly-Embedded-Bridge aus deiner eigenen Web-App heraus – Profile speichern, Launch-Tokens ausstellen, den Browser-Build ausliefern, Plätze freigeben und Installationen verknüpfen.
- SQLly mit einer Abfrage öffnen
- SQLly direkt in einem Abfrage-Tab starten: das Skript, seine Verbindung und Datenbank, Parameterwerte und die Cursor-Position, gesendet mit dem Launch-Token für „In SQLly öffnen“-Buttons.
- API-Referenz
- Jeder Endpunkt der Verwaltungs-API der SQLly-Embedded-Bridge, generiert aus ihrem OpenAPI-Dokument (swagger.json), plus die sqlly.app-Verknüpfungsendpunkte.
- Lizenzierung
- Pläne, Plätze, Sitzungen, Instanzen, Domains, Check-ins, Karenzzeiten, Offline-Lizenzdateien, jeder Lizenzstatus, in dem sich die Brücke befinden kann, und wie man jeden einzelnen behebt.
- In Produktion gehen
- TLS, Reverse-Proxys, die lizenzierte Domain, Service-Manager, Backups, Content-Security-Policy und Isolations-Header sowie eine Produktions-Checkliste für SQLly Embedded.
Wähle einen Pfad
- Bewerten? Lesen So funktioniert es, dann folge dem Schnellstart. Jedes sqlly.app-Konto enthält eine kostenlose dreimonatige Testphase (ein Nutzer, eine Bridge), du musst also nichts kaufen, um es auszuprobieren.
- Integration? Mach die Tour der Beispiel-App um zu sehen, was deine App bereitstellen muss, und arbeite dann durch Eigene App entwickeln mit dem API-Referenz (oder lade swagger.json in Ihr API-Tooling).
- Bereitstellung? Lesen Lizenzierung für Benutzerplätze, Domains und was jeder Lizenzstatus bedeutet, dann In Produktion gehen.
Die kurze Version
- Die Zugangsdaten kommen nie beim Browser an. Die Passwörter eines Profils befinden sich im Zustandsverzeichnis der Bridge. Der Browser erhält nur die Verbindungsübersicht (Namen, Engines, Labels) und sendet Anfragen über das WebSocket der Bridge.
- Lizenzplätze entsprechen gleichzeitigen Benutzern. Ein Benutzer belegt einen Platz, solange SQLly für ihn geöffnet ist oder solange er ein nicht abgelaufenes Start-Token besitzt. Der Platz wird frei, sobald er fertig ist. Bezahlte Pläne erlauben vier Tabs pro Benutzer.
- Eine Domain pro Lizenz - mit allen Subdomains. Die Bridge akzeptiert nur Browser, deren
Originsich auf dieser Domain befinden (pluslocalhostwährend der Entwicklung). - Jede Engine, die SQLly unterstützt funktioniert über die Brücke: SQL Server, Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse, Oracle, libSQL/Turso, Redis und Valkey sowie die Cloud-Varianten.
- Verbunden oder offline. Verbundene Lizenzen melden sich alle 20 Minuten bei sqlly.app. Offline-Lizenzen sind eine signierte Datei, die die Bridge lokal überprüft und die niemals Kontakt nach außen aufnimmt.
Pläne und Preise befinden sich auf der SQLly Embedded-Seite. Lade das Paket für deine Plattform von Downloads, und verwalte deine Lizenzen, Schlüssel und verknüpften Installationen auf deiner Embedded-Seite.