Exporter et importer des connexions

fonctionnel

Dé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.

Un fichier de mots de passe les stocke en clair. C'est ce qui le rend utile, et ce qui le rend sensible. SQLly enregistre un fichier exporté lisible uniquement par vous, déplace chaque mot de passe dans votre trousseau système lors de l'importation, et ne conserve jamais de copie du fichier. Envoyez-le via un canal de confiance, et supprimez-le une fois qu'il a été importé. Pour partager les connexions sans mots de passe, utilisez Fichier → Exporter les connexions….

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.

SQLly
Dialogue d'exportation des connexions SQLLY avec le choix d'inclure les mots de passe et le fichier de destinationDialogue d'exportation des connexions SQLLY avec le choix d'inclure les mots de passe et le fichier de destination
La boîte de dialogue d'exportation des connexions : choisissez si les mots de passe sont inclus, puis sélectionnez le fichier.

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

SectionCe qu'il transporte
ConnexionsUn 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ésPlusieurs identifiants nommés (nom d'utilisateur, plus le mot de passe dans un fichier d'identifiants) que de nombreuses connexions peuvent utiliser.
Profils de tunnelChaî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, environnementsNom, 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, ou production.

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>], avec rediss+sentinel:// pour TLS et valkey+sentinel:// / valkeys+sentinel:// pour Valkey. ?sentinelPassword= définit le mot de passe des sentinelles elles-mêmes et ?preferReplica=true envoie 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 un SQLLY_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, ou sentinelPassword é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 embedded leur sert de profil en lecture seule provisioned (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.