Visite guidée de l’application d’exemple
Une visite écran par écran de l'application d'administration exemple fournie avec SQLly Embedded : statut et licences, profils et connexions, étiquettes, utilisateurs, et lancement de SQLly.
Le package comprend une petite application d'administration (sample-app/, Node.js 20+, sans dépendances) qui utilise toutes les fonctionnalités de SQLly Embedded. Elle joue le rôle de votre application : un côté administrateur pour les profils, les étiquettes et les utilisateurs, et un côté utilisateur qui connecte les personnes et ouvre SQLly. Chaque écran ci-dessous est une fine couche sur une ou deux API de gestion appels, qui sont nommés sous chaque capture d'écran afin que vous puissiez voir ce que votre propre application appellerait.
Ces captures d'écran proviennent d'un vrai pont lié à une licence d'essai, avec une base de données Northwind sur SQL Server derrière.
Connexion administrateur
Statut et licences
Statut est GET /manage/status affiché sous forme de page. Un pont démarré sans clé ni fichier de licence est sans licence: vous pouvez déjà créer et tester des profils, mais SQLly ne se lancera pas tant que l'installation n'est pas liée.
Connectez-vous à sqlly.app demande à sqlly.app un code de lien (POST /api/embedded/links) et l'affiche. Ouvrez sqlly.app pour approuver emmène le propriétaire de la licence sur sqlly.app, où il confirme le même code et choisit une licence :
Quelques secondes plus tard, l'application administrateur collecte la clé de l'installation, la remet au pont avec PUT /manage/license, et le Statut affiche la licence :
Profils
Un profil est l'ensemble des connexions qu'un groupe d'utilisateurs voit. La liste montre les connexions de chaque profil et qui y est assigné, avec Lancer pour ouvrir SQLly sous votre identité avec ce profil.
Modification d'une connexion
L'éditeur de connexion propose tous les champs que le format d'identifiants prend en charge pour le moteur choisi. La liste des moteurs et les types d'authentification de chaque moteur proviennent de GET /manage/engines. Test vérifie tout ce qui est sur le formulaire, enregistré ou non, et affiche la réponse du moteur en ligne :
Étiquettes
Les clients, projets et environnements colorent et regroupent les connexions dans SQLly, et appliquent des règles de sécurité. L'application d'exemple conserve un jeu partagé et l'envoie avec chaque profil, donc le renommage d'une étiquette met à jour chaque connexion qui l'utilise.
Utilisateurs et sièges
Les utilisateurs de l'application exemple sont leurs propres comptes, chacun affecté à un profil. Dans votre application, les utilisateurs et leur accès sont ceux que vous avez déjà. La page indique également qui détient actuellement un siège (GET /manage/seats), avec Libérer le siège (DELETE /manage/seats/{user}).
Ce que vos utilisateurs voient
Les utilisateurs se connectent à la racine de l'application, pas sous /admin :
Pendant que SQLly est ouvert, Statut montre le siège en cours d'utilisation :
Lire le code
| Fichier | Ce qu'il faut en retenir |
|---|---|
lib/bridge.js | Un client API de gestion complet : chaque appel, gestion des erreurs, délais d'attente. Copiez-le ou portez-le. |
lib/credentials.js | Transforme les champs de formulaire et les étiquettes partagées en un sqlly-credentials document. |
lib/sqllyapp.js | Côté sqlly.app : créer la demande de liaison, puis interroger jusqu'à obtenir la clé. |
server.js | Routage. GET /app/ est la route de lancement ; /admin/* est le côté administration ; /admin/link* est en cours de liaison. |
views/pages.js | Le HTML, y compris injectLaunch, qui définit les deux variables globales avant boot.js. |
test/ | node --test des suites qui exécutent l'application contre un pont fictif. Un bon modèle pour tester votre propre intégration. |
Prêt à le remplacer ? Créer votre propre application passe en revue chacun de ces travaux dans votre propre stack.