Exporter et importer des connexions
fonctionnelDéplacez les serveurs, les bases de données et les connexions - avec ou sans mots de passe - ainsi que les couleurs et les icônes des étiquettes vers une autre machine dans un seul fichier, en choisissant exactement ce que vous voulez inclure.
A fichier de connexion déplace une configuration de travail complète d'une machine ou d'un coéquipier à l'autre en une seule étape : les serveurs, les bases de données qu'ils contiennent, les logins à utiliser et, si vous le souhaitez, leurs mots de passe, ainsi que les étiquettes client, projet et environnement auxquelles ces connexions appartiennent, y compris, pour chaque étiquette, la couleur et icône. Les deux exportations écrivent le même fichier ; la seule différence est la présence ou non des mots de passe. Exportez-en un depuis SQLly, ou écrivez-en un à la main pour provisionner une équipe, puis importez-le sur n'importe quelle copie de SQLly.
Exporter les connexions
Choisir Fichier → Exporter les connexions… pour un fichier sans mots de passe, ou Fichier → Exporter Conn avec identifiants… pour un fichier avec ceux-ci (les deux options sont également dans la palette de commandes). Chacune ouvre un sélecteur qui montre chaque connexion enregistrée sous forme d'arborescence : chaque serveur (hôte, port et moteur) avec les bases de données que vous y avez enregistrées dessous. Export Conn w/ Creds s'ouvre avec un avertissement en tête indiquant que le fichier contiendra des mots de passe en clair.
- Choisissez tout ou partie des serveurs - cochez un serveur pour sélectionner toutes les bases de données sous celui-ci, ou cliquez à nouveau pour les désélectionner.
- Choisissez tout ou partie des bases de données - développez un serveur et cochez les bases de données individuelles ; la ligne du serveur montre combien de ses bases de données sont sélectionnées.
- Tout sélectionner / Effacer bascule tout à la fois. Tout est sélectionné au départ.
- Seul ce que vous avez choisi est inclus - les logins partagés, les profils de tunnel et les étiquettes de client, de projet et d'environnement utilisés par les connexions choisies sont inclus, et rien d'autre.
Cliquez Exporter et choisissez où enregistrer. Tous les paramètres offerts par l'éditeur de connexion sont inclus dans les deux cas, y compris la méthode d'authentification de chaque connexion. Avec les identifiants, SQLly relit chaque mot de passe, phrase secrète et jeton depuis votre trousseau pour les placer dans le fichier ; sans eux, tous les secrets sont omis et SQLly vérifie que le fichier n'en contient aucun avant de l'enregistrer. Un identifiant utilisé par plusieurs connexions exportées est écrit une seule fois comme identifiant partagé ; un identifiant utilisé par une seule connexion est écrit sur cette connexion. Les icônes des étiquettes sont intégrées au fichier, qui se suffit donc à lui-même.


Importer des connexions
Choisir Fichier → Importer les connexions… et sélectionnez le fichier. La même commande lit un fichier avec ou sans mots de passe, ainsi que les fichiers enregistrés par l'exportation des connexions dans les versions antérieures de SQLly. Avant de modifier quoi que ce soit, elle vérifie l'intégralité du fichier et, si une entrée est incorrecte, liste tous les problèmes et n'importe rien, de sorte qu'une importation partiellement appliquée ne peut pas se produire. Un nom de paramètre mal tapé est signalé plutôt que ignoré silencieusement. Les connexions importées apparaissent immédiatement dans l'explorateur de serveurs.
- Les mots de passe vont dans votre trousseau - Trousseau sur macOS, Gestionnaire d'identifiants sur Windows, Secret Service sur Linux - jamais dans le fichier des connexions enregistrées de SQLly. La barre d'état indique combien en ont été importés.
- Les étiquettes fusionnent par nom - un client, projet ou environnement existant garde tout ce que le fichier ne définit pas, et seuls les interrupteurs de sécurité listés dans le fichier changent.
- Les identifiants partagés sont mis à jour sur place - une connexion enregistrée avec le même nom et identifiant utilisateur reçoit le nouveau mot de passe, donc chaque connexion l’utilisant déjà continue de fonctionner.
- Pas de mot de passe, pas de problème - une connexion sans mot de passe (toute connexion dans un fichier exporté sans identifiants) est importée quand même, et SQLly demande le mot de passe lors de la première connexion.
Importer depuis Redis Insight
Dans Redis Insight, sélectionnez vos bases de données et choisissez Exporter (cocher Inclure les mots de passe si vous voulez qu'ils soient transférés). Dans SQLly, choisissez Importer depuis d'autres outils… et sélectionnez le fichier exporté, JSON simple ou la forme base64 que Redis Insight accepte également. Chaque base de données devient une connexion Redis avec son hôte, port, base de données logique, nom d'utilisateur ACL, tunnel SSH et paramètres TLS.
- TLS n'est jamais désactivé - une base de données exportée avec TLS (ou avec un certificat CA ou client) est importée de manière chiffrée : Vérifier l'autorité de certification (CA) lorsque Redis Insight a vérifié le certificat du serveur, Exiger lorsqu'il ne l'a pas fait. Le contenu des certificats et des clés est enregistré sous forme de fichiers PEM dans le dossier de données de SQLly (clés lisibles uniquement par vous), et la connexion pointe vers ces fichiers.
- Les secrets vont dans votre trousseau de clés - les mots de passe, les mots de passe SSH et les phrases de passe de clé de l'export sont stockés exactement comme ceux d'un fichier de connexion, jamais dans le fichier des connexions enregistrées. Supprimez ensuite l'export : il les contient en texte clair.
- Bases de données Azure Entra importer avec la connexion Microsoft Entra ; choisissez le compte Azure dans l'éditeur de connexion.
- Bases de données Cluster s'importent en connexions Redis Cluster pré-remplies avec le nœud qu'elles nomment (ou en un seul nœud quand Redis Insight a été réglé pour forcer le mode autonome) ; Sentinelle les bases de données sont importées comme des connexions Sentinel avec le groupe master, le mot de passe du Sentinel (déplacé dans le trousseau) et les identifiants du master, et la barre d'état liste tout ce qui n'a pas pu être transféré.
Ce qu'un fichier de connexion peut contenir
| Section | Ce qu'il transporte |
|---|---|
| Connexions | Un nombre quelconque de serveurs et un nombre quelconque de bases de données sur chacun : moteur, hôte, port, base de données, environnement, client et projet, méthode de connexion et (avec les identifiants) mot de passe, mode TLS et fichiers de certificats, délais d'expiration de connexion et d'instruction, nom de l'application, SQL de démarrage, options de sécurité par connexion, étoile de favori, règles de masquage, route de relais, et un tunnel SSH, un proxy ou un transfert de port Kubernetes en ligne. |
| Identifiants partagés | Plusieurs identifiants nommés (nom d'utilisateur, plus le mot de passe dans un fichier d'identifiants) que de nombreuses connexions peuvent utiliser. |
| Profils de tunnel | Chaînes SSH nommées (avec hôte de saut), proxy et Kubernetes, plus les mots de passe SSH et les phrases secrètes des clés dans un fichier d'identifiants. |
| Clients, projets, environnements | Nom, couleur, image de l'icône (intégrée dans le fichier) et toute protection de requête. |
Chaque méthode de connexion prise en charge par SQLly peut être décrite : nom d'utilisateur et mot de passe, sécurité intégrée Windows, Microsoft Entra (navigateur ou code de l'appareil), AWS RDS IAM, Google Cloud SQL IAM, et jetons libSQL / Turso. Les fichiers SQLite et DuckDB ne nécessitent pas de connexion.
Écrire à la main
Un fichier de connexion est du JSON simple, donc un administrateur peut en écrire un pour fournir à une équipe une configuration prête à l'emploi. Seule une connexion name, engine, et
server sont requis - tout le reste reprend la même valeur par défaut que l'éditeur de connexion. Ce fichier ajoute deux bases de données sur un serveur qui partagent un identifiant en lecture seule, un deuxième serveur avec son propre mot de passe, et un client coloré avec une icône :
{
"format": "sqlly-credentials",
"version": 1,
"clients": [
{ "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
],
"sql_auth_accounts": [
{ "name": "Reader", "username": "ro", "password": "ro-secret" }
],
"connections": [
{ "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
"client": "Acme", "environment": "production",
"authentication": { "type": "sql-login", "account": "Reader" },
"tls": { "mode": "verify-full" } },
{ "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
"client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
{ "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
"authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
]
}
- Moteurs peut être écrit librement -
postgres,PostgreSQL,mssql,sql-server,mysql,sqlite,duckdb,clickhouse,redis, et ainsi de suite. - Couleurs sont
#RGB,#RRGGBB, ou#RRGGBBAA. - Icônes sont en base64 - une
data:image/…;base64,URI ou le base64 brut - d’une image PNG, JPEG, GIF, WebP, BMP, ICO ou SVG jusqu’à 1 Mo. - Environnements sont
local,dev,test,staging, ouproduction.
Connexions préconfigurées (Docker, Kubernetes, machines gérées)
Au lieu d'importer un fichier une seule fois, vous pouvez faire en sorte que SQLly provisionner connexions à chaque démarrage - dans l'application de bureau, dans les sqlly-cli commandes d’agent, et dans un environnement auto-hébergé sqlly-bridge embedded serveur. Point
SQLLY_PROVISIONED_CONNECTIONS_FILE à un fichier (ou mettre
provisioned-connections.json dans le dossier des paramètres de SQLly, à côté de
connections.json), et/ou définir un SQLLY_CONNECTION_<NAME>
variable par connexion contenant son URL. Le fichier utilise le format de fichier de connexion ci-dessus (format et version peut être omis, et seulement
connections est lu), et toute connexion peut donner un url au lieu de ses champs moteur, serveur, port, base de données et authentification :
{
"connections": [
{ "name": "Cache",
"url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
"environment": "production" },
{ "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
"authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
"tls": { "mode": "verify-full" } }
]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=... # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
- URLs des sentinelles -
redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>], avecrediss+sentinel://pour TLS etvalkey+sentinel:///valkeys+sentinel://pour Valkey.?sentinelPassword=définit le mot de passe des sentinelles elles-mêmes et?preferReplica=trueenvoie des scripts en lecture seule à une réplique. Les sentinelles sans port utilisent 26379. Les mêmes URL fonctionnent dans le collage d’URL de l’éditeur de connexion. ${VARIABLE}tout endroit dans le fichier (ou dans unSQLLY_CONNECTION_URL) est remplacé par cette variable d’environnement ; écrivez$${pour un littéral${.- Les mots de passe restent hors des fichiers - un mot de passe, un jeton,
redis_sentinel_password, mot de passe URL, ousentinelPasswordécrit exactement${VARIABLE}est lu depuis l'environnement à chaque fois que SQLly se connecte, et n'est jamais copié dans un profil ni enregistré ailleurs. - Géré, en lecture seule - les connexions approvisionnées apparaissent aux côtés des vôtres mais ne sont jamais écrites dans
connections.json, et Enregistrer et Supprimer leur sont refusés : modifiez plutôt le fichier ou les variables, ou utilisez Dupliquer pour créer votre propre copie éditable. - Une mauvaise entrée ne bloque jamais les autres - un paramètre inconnu, une variable non définie ou une URL illisible saute juste cette connexion et affiche un avertissement indiquant laquelle et pourquoi ; une connexion ultérieure avec un nom déjà utilisé est ignorée de la même manière.
- Sur le pont -
sqlly-bridge embeddedleur sert de profil en lecture seuleprovisioned(aussi via--provisioned-connections <file>); les jetons de lancement peuvent le nommer comme n'importe quel autre profil, et il n'est jamais écrit dans le répertoire d'état.