SQLly Embedded
Hébergez SQLly dans votre propre application web : ce que contient le package, comment le pont, votre application et sqlly.app s'articulent, et par où commencer.
SQLly Embedded intègre la version navigateur de SQLly à votre propre application web. Vos utilisateurs ont accès à l'intégralité du workbench sur une page de votre site : l'éditeur SQL avec IntelliSense, l'explorateur d'objets, la grille de résultats, les graphiques et les plans d'exécution. Votre serveur conserve tous les mots de passe des bases de données. Vous décidez quelles connexions chaque groupe d'utilisateurs peut voir, et le SQLly Bridge applique votre licence.
Ce que vous exécutez
| Composant | Ce que cela fait | Où il s'exécute |
|---|---|---|
| Votre application web | Connecte vos utilisateurs, décide quel profil (ensemble de connexions) chacun obtient, demande au pont un jeton de lancement et fournit la page qui charge SQLly. | Votre serveur |
SQLly Bridge (sqlly-bridge embedded) | Contient les profils et leurs identifiants, crée des jetons de lancement, accepte les WebSockets du navigateur, exécute un moteur par session, compte les sièges et vérifie la licence auprès de sqlly.app. | Votre serveur, à côté de votre application |
Moteur SQLly (sqlly-cli) | Se connecte à vos bases de données et exécute des requêtes pour une session de navigateur. Le pont démarre et arrête le moteur ; rien d'autre ne communique avec lui. | Votre serveur (processus enfant du pont) |
Bundle web SQLly (web/) | L'application SQLly compilée en WebAssembly. Fichiers statiques servis par votre application. | Navigateurs de vos utilisateurs |
| sqlly.app | Délivre votre licence et signe une autorisation de courte durée chaque fois que le pont se signale (toutes les 20 minutes). Les licences hors ligne ne le contactent jamais. | Le nôtre |
Le package inclut également une application d'administration exemple (Node.js, sans dépendances) qui fait tout ce que votre application ferait : un écran d'administration pour les profils, les étiquettes et les utilisateurs, et une page de connexion qui ouvre SQLly pour chaque utilisateur. Exécutez-la pour voir tout le processus, puis remplacez-la par votre propre application, ou commencez à partir de son code.
Dans cette section
- Fonctionnement
- Le principe de fonctionnement : le pont, le moteur par session, les jetons de lancement, l'octroi de licence signé, les vérifications périodiques, les sièges, la règle d'origine, et l'emplacement des identifiants.
- Démarrage rapide
- Exécutez le package SQLly Embedded sur localhost en cinq minutes : démarrez le pont et l'application exemple, liez une licence, ajoutez un profil, et ouvrez SQLly en tant qu'utilisateur.
- 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.
- Créer votre propre application
- Étape par étape : pilotez le pont SQLly Embedded depuis votre propre application web - stockez les profils, créez des jetons de lancement, servez la version navigateur, libérez des sièges et liez les installations.
- Ouvrir SQLly sur une requête
- Lancez SQLly directement dans un onglet de requête : le script, sa connexion et sa base de données, les valeurs des paramètres et le curseur, envoyés avec le jeton de lancement pour les boutons « Ouvrir dans SQLly ».
- Référence de l’API
- Chaque point de terminaison de l'API de gestion du pont SQLly Embedded, généré à partir de son document OpenAPI (swagger.json), plus les points de terminaison de liaison sqlly.app.
- Licences
- Formules, sièges, sessions, instances, domaines, vérifications de licence, périodes de grâce, fichiers de licence hors ligne, chaque état de licence dans lequel le pont peut se trouver, et comment corriger chacun d’eux.
- Passer en production
- TLS, les proxies inverses, le domaine licencié, les gestionnaires de services, les sauvegardes, la Content-Security-Policy et les en-têtes d'isolation, et une checklist de production pour SQLly Embedded.
Choisissez un chemin
- Vous évaluez ? Lire Fonctionnement, puis suivez les Démarrage rapide. Chaque compte sqlly.app inclut un essai gratuit de trois mois (un utilisateur, un pont), donc inutile d'acheter quoi que ce soit pour l'essayer.
- Intégration ? Faites le tour de l'application exemple pour voir ce que votre application doit fournir, puis parcourez Créer votre propre application avec le Référence de l’API (ou chargez swagger.json dans vos outils API).
- Déploiement ? Lire Licences pour les sièges, les domaines et ce que chaque état de licence signifie, puis Passer en production.
La version courte
- Les identifiants n'atteignent jamais le navigateur. Les mots de passe d'un profil se trouvent dans le répertoire d'état du pont. Le navigateur ne reçoit que la liste des connexions (noms, moteurs, étiquettes) et envoie des requêtes via le WebSocket du pont.
- Les sièges sont des utilisateurs simultanés. Un utilisateur occupe un siège tant que SQLly est ouvert chez lui, ou tant qu'il détient un jeton de lancement non expiré. Le siège se libère dès qu'il a fini. Les offres payantes autorisent quatre onglets par utilisateur.
- Un domaine par licence - avec tous les sous-domaines inclus. Le pont n'accepte que les navigateurs dont
Originest sur ce domaine (pluslocalhosttant que vous développez). - Tous les moteurs pris en charge par SQLly fonctionne via le pont : SQL Server, Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse, Oracle, libSQL/Turso, Redis et Valkey, ainsi que les variantes cloud.
- Connecté ou hors ligne. Les licences connectées contactent sqlly.app toutes les 20 minutes. Les licences hors ligne sont un fichier signé que le pont vérifie localement, sans jamais contacter le serveur.
Les formules et les prix sont sur la page SQLly Embedded. Téléchargez le package pour votre plateforme depuis Téléchargements, et gérez vos licences, clés et installations liées sur votre page Embedded.