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.
Das Paket enthält eine kleine Admin-App (sample-app/, Node.js 20+, keine Abhängigkeiten), die alles durchexerziert, was SQLly Embedded kann. Sie spielt die Rolle der dein App: eine Admin-Seite für Profile, Labels und Benutzer sowie eine Benutzerseite, die Leute anmeldet und SQLly öffnet. Jeder Bildschirm unten ist eine dünne Schicht über einem oder zwei Management-API Aufrufen, die unter jedem Screenshot benannt sind, damit du siehst, was deine eigene App aufrufen würde.
Diese Screenshots stammen von einer echten Bridge, die mit einer Testlizenz verbunden ist, mit einer SQL Server Northwind-Datenbank dahinter.
Admin-Anmeldung
Status und Lizenzierung
Status ist GET /manage/status als Seite gerendert wird. Eine Bridge, die ohne Schlüssel oder Lizenzdatei gestartet wird, ist unlizenziert: du kannst bereits Profile anlegen und testen, aber SQLly startet nicht, bis die Installation verknüpft ist.
Mit sqlly.app verbinden fragt sqlly.app nach einem Verknüpfungscode (POST /api/embedded/links) und zeigt ihn an. Zum Genehmigen sqlly.app öffnen führt den Lizenzinhaber zu sqlly.app, wo derselbe Code bestätigt und eine Lizenz ausgewählt wird:
Sekunden später sammelt die Admin-App den Schlüssel der Installation und übergibt ihn der Bridge mit PUT /manage/license, und der Status zeigt die Lizenz an:
Profile
Ein Profil ist die Menge der Verbindungen, die eine Gruppe von Benutzern sieht. Die Liste zeigt die Verbindungen jedes Profils und wer ihm zugewiesen ist, mit Starten um SQLly mit diesem Profil unter deinem eigenen Benutzer zu öffnen.
Bearbeiten einer Verbindung
Der Verbindungseditor bietet jedes Feld, das das Anmeldeformat für die gewählte Engine unterstützt. Die Engineliste und die Anmeldetypen jeder Engine stammen aus GET /manage/engines. Test prüft alles, was auf dem Formular ist, gespeichert oder nicht, und zeigt die eigene Antwort der Engine inline an:
Labels
Kunden, Projekte und Umgebungen färben und gruppieren Verbindungen in SQLly und tragen Sicherheitsregeln. Die Beispiel-App behält einen gemeinsamen Satz und sendet ihn mit jedem Profil, sodass das Umbenennen eines Labels jede Verbindung aktualisiert, die es verwendet.
Benutzer und Plätze
Die Benutzer der Beispiel-App sind eigene Konten, jeweils einem Profil zugewiesen. In deiner App sind Benutzer und ihre Zugriffe das, was du schon hast. Die Seite zeigt auch, wer gerade einen Seat belegt (GET /manage/seats), mit Platz freigeben (DELETE /manage/seats/{user}).
Was deine Benutzer sehen
Benutzer melden sich an der Root der App an, nicht unter /admin:
Während SQLly geöffnet ist, zeigt der Status den belegten Lizenzplatz:
Den Code lesen
| Datei | Was man daraus mitnehmen sollte |
|---|---|
lib/bridge.js | Ein vollständiger Management-API-Client: jeder Aufruf, Fehlerbehandlung, Timeouts. Kopiere ihn oder porte ihn. |
lib/credentials.js | Macht aus Formularfeldern und gemeinsamen Labels ein sqlly-credentials Dokument. |
lib/sqllyapp.js | Die sqlly.app-Seite der Verknüpfung: Verknüpfung erstellen, nach dem Schlüssel fragen. |
server.js | Routing. GET /app/ ist die Startroute; /admin/* ist die Admin-Seite; /admin/link* ist das Verknüpfen. |
views/pages.js | Das HTML, einschließlich injectLaunch, das die beiden globalen Variablen vorher setzt boot.js. |
test/ | node --test Suiten, die die App gegen eine gefälschte Bridge laufen lassen. Ein gutes Vorbild, um deine eigene Integration zu testen. |
Bereit, sie zu ersetzen? Eigene App entwickeln Geht jeden dieser Jobs in deinem eigenen Stack durch.