Verbindungen exportieren und importieren

funktional

Verschiebe Server, Datenbanken und Anmeldungen - mit oder ohne Passwörter - plus Labelfarben und Symbole in einer Datei auf einen anderen Rechner, und wähle dabei genau aus, was enthalten sein soll.

A Verbindungsdatei verschiebt ein komplettes Arbeitssetup zwischen Rechnern oder Teammitgliedern in einem Schritt: Server, die darauf befindlichen Datenbanken, die zu verwendenden Logins und, falls gewünscht, deren Passwörter, zusammen mit den Clients, Projekt- und Umgebungslabels, zu denen diese Verbindungen gehören, einschließlich der einzelnen Labels Farbe und Symbol. Beide Exporte schreiben dieselbe Datei; der einzige Unterschied ist, ob Passwörter enthalten sind. Eine Datei kann aus SQLly exportiert oder von Hand erstellt werden, um ein Team auszustatten, und auf jeder Kopie von SQLly importiert werden.

Eine Datei mit Passwörtern speichert diese im Klartext. Genau das macht es nützlich, und genau das macht es sensibel. SQLly speichert eine exportierte Datei, die nur von dir gelesen werden kann, verschiebt beim Import jedes Passwort in den System-Schlüsselbund und behält nie eine Kopie der Datei. Schicke sie über einen Kanal, dem du vertraust, und lösche sie, sobald sie importiert wurde. Um Verbindungen zu teilen ohne Passwörter, verwende Datei → Verbindungen exportieren….

Verbindungen exportieren

Auswählen Datei → Verbindungen exportieren… für eine Datei ohne Passwörter oder Datei → Verbindungen mit Zugangsdaten exportieren… für eine mit ihnen (beide sind auch in der Befehlspalette). Beide öffnen einen Auswahldialog, der jede gespeicherte Verbindung als Baum anzeigt: jede Server (Host, Port und Engine) mit den Datenbanken die du darunter darauf gespeichert hast. Verbindungen mit Zugangsdaten exportieren öffnet mit einer Warnung am oberen Rand, dass die Datei Passwörter im Klartext enthalten wird.

  • Wähle beliebige oder alle Server aus - hake einen Server an, um alle Datenbanken darunter zu übernehmen, oder hake ihn wieder ab, um sie abzuwählen.
  • Wähle beliebige oder alle Datenbanken aus - klappe einen Server auf und hake einzelne Datenbanken ab; die Serverzeile zeigt, wie viele ihrer Datenbanken ausgewählt sind.
  • Alle auswählen / Auswahl aufheben schaltet alles auf einmal um. Alles ist standardmäßig ausgewählt.
  • Nur das Ausgewählte kommt mit - die gemeinsamen Logins, Tunnelprofile und die Kunden-, Projekt- und Umgebungs-Labels der ausgewählten Verbindungen sind enthalten, sonst nichts.

Klicken Exportieren und wähle, wohin gespeichert wird. Jede Einstellung, die der Verbindungseditor anbietet, kommt in jedem Fall mit, auch die Anmeldemethode jeder Verbindung. Mit Anmeldedaten liest SQLly jedes Passwort, jede Passphrase und jedes Token aus deinem Schlüsselbund zurück in die Datei; ohne sie lässt es jedes Geheimnis weg und prüft vor dem Speichern, dass die Datei keines enthält. Einen Login, den mehrere der exportierten Verbindungen nutzen, schreibt es einmal als geteilten Login; einen Login, den nur eine Verbindung nutzt, schreibt es bei dieser Verbindung. Label-Symbole sind in die Datei eingebettet, sodass sie für sich allein vollständig ist.

SQLly
SQLLY-Dialog „Verbindungen exportieren“ mit Option zum Einbeziehen der Passwörter und Angabe der ZieldateiSQLLY-Dialog „Verbindungen exportieren“ mit Option zum Einbeziehen der Passwörter und Angabe der Zieldatei
Der Dialog Verbindungen exportieren: festlegen, ob Passwörter enthalten sind, und dann die Datei wählen.

Verbindungen importieren

Auswählen Datei → Verbindungen importieren… und wähle die Datei aus. Derselbe Befehl liest Dateien mit oder ohne Passwörter und Dateien, die Export Connections in früheren SQLly-Versionen gespeichert hat. Bevor er etwas ändert, prüft er die ganze Datei und listet, wenn ein Eintrag falsch ist, jedes Problem auf und importiert nichts, sodass ein halb angewendeter Import nicht passieren kann. Ein vertippter Einstellungsname wird gemeldet statt stillschweigend übersprungen. Die importierten Verbindungen erscheinen sofort im Server-Explorer.

  • Passwörter gehen in deinen Schlüsselbund - Schlüsselbund auf macOS, Anmeldeinformations-Manager unter Windows, Secret Service unter Linux – niemals in SQLlys gespeicherte Verbindungsdatei. Die Statusleiste sagt, wie viele reingekommen sind.
  • Beschriftungen werden nach Namen zusammengeführt - ein bestehender Client, ein Projekt oder eine Umgebung behält alles, was die Datei nicht setzt, und nur die Sicherheitsoptionen, die die Datei auflistet, ändern sich.
  • Geteilte Logins werden an Ort und Stelle aktualisiert - Ein gespeicherter Login mit demselben Namen und Benutzernamen erhält das neue Passwort, sodass jede Verbindung, die ihn bereits verwendet, weiterhin funktioniert.
  • Kein Passwort, kein Problem - ein Login ohne Passwort (jeder Login in einer ohne Anmeldedaten exportierten Datei) wird trotzdem importiert, und SQLly fragt beim ersten Verbinden nach dem Passwort.

Importieren aus Redis Insight

Wähl in Redis Insight deine Datenbanken aus und wähl Exportieren (aktiviere Passwörter einschließen wenn sie übernommen werden sollen). Wähle in SQLly Aus anderen Tools importieren… und wähle die exportierte Datei aus, reines JSON oder die Base64-Variante, die auch Redis Insight akzeptiert. Jede Datenbank wird zu einer Redis-Verbindung mit Host, Port, logischer Datenbank, ACL-Benutzername, SSH-Tunnel und TLS-Einstellungen.

  • TLS wird niemals deaktiviert - eine Datenbank, die mit TLS (oder mit einem CA- oder Client-Zertifikat) exportiert wurde, wird verschlüsselt importiert: CA überprüfen wenn Redis Insight das Serverzertifikat überprüft hat, Erforderlich wenn nicht. Zertifikats- und Schlüsseltexte werden als PEM-Dateien im Datenordner von SQLly gespeichert (die Schlüssel nur für dich lesbar), und die Verbindung verweist darauf.
  • Secrets landen in deinem Schlüsselbund - Passwörter, SSH-Passwörter und Schlüssel-Passphrasen aus dem Export werden genauso gespeichert wie die einer Verbindungsdatei, niemals in der Datei mit den gespeicherten Verbindungen. Lösche den Export danach: Er enthält sie im Klartext.
  • Azure Entra-Datenbanken Import mit Microsoft-Entra-Anmeldung; wähle das Azure-Konto im Verbindungseditor.
  • Cluster-Datenbanken Importieren als Redis-Cluster-Verbindungen, die mit dem Knoten, den sie benennen, initialisiert werden (oder als ein Knoten, wenn Redis Insight angewiesen wurde, Standalone zu erzwingen); Sentinel Datenbanken werden als Sentinel-Verbindungen importiert - mit der Master-Gruppe, dem Passwort des Sentinels (in den Schlüsselbund verschoben) und der eigenen Anmeldung des Masters; die Statusleiste listet alles auf, was nicht übernommen werden konnte.

Was eine Verbindungsdatei enthalten kann

AbschnittWas sie trägt
VerbindungenBeliebige Anzahl von Servern und beliebige Anzahl von Datenbanken auf jedem: Engine, Host, Port, Datenbank, Umgebung, Client und Projekt, Anmeldemethode und (mit Anmeldeinformationen) Passwort, TLS-Modus und Zertifikatsdateien, Verbindungs- und Befehlszeitlimits, Anwendungsname, Start-SQL, Sicherheitsumschalter pro Verbindung, Favoritenstern, Maskierungsregeln, Relay-Route und ein Inline-SSH-Tunnel, Proxy oder Kubernetes-Port-Forward.
Geteilte LoginsMehrere benannte Anmeldungen (Benutzername sowie das Passwort in einer Datei mit Zugangsdaten), die viele Verbindungen verwenden können.
TunnelprofileBenannte SSH- (mit Jump-Host), Proxy- und Kubernetes-Ketten sowie SSH-Passwörter und Schlüssel-Passphrasen in einer Datei mit Zugangsdaten.
Kunden, Projekte, UmgebungenName, Farbe, Symbolbild (in der Datei eingebettet) und beliebige der Abfrage-Schutzoptionen.

Jede Anmeldemethode, die SQLly unterstützt, lässt sich angeben: Benutzername und Passwort, integrierte Windows-Sicherheit, Microsoft Entra (Browser oder Gerätecode), AWS RDS IAM, Google Cloud SQL IAM und libSQL-/Turso-Token. SQLite- und DuckDB-Dateien brauchen keine Anmeldung.

Manuelles Schreiben

Eine Verbindungsdatei ist einfaches JSON, sodass ein Administrator eine erstellen kann, um einem Team ein fertiges Setup zur Verfügung zu stellen. Nur die name, engine, und server einer Verbindung sind erforderlich – alles andere fällt auf denselben Standard zurück, den der Verbindungseditor verwendet. Diese Datei fügt zwei Datenbanken auf einem Server hinzu, die sich einen schreibgeschützten Login teilen, einen zweiten Server mit eigenem Passwort und einen farbigen Client mit Symbol:

{
  "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" } }
  ]
}
  • Engines kann locker geschrieben werden – postgres, PostgreSQL, mssql, sql-server, mysql, sqlite, duckdb, clickhouse, redis, und so weiter.
  • Farben sind #RGB, #RRGGBB, oder #RRGGBBAA.
  • Symbole sind base64 – eine data:image/…;base64, URI oder reines Base64 – ein PNG-, JPEG-, GIF-, WebP-, BMP-, ICO- oder SVG-Bild bis zu 1 MB.
  • Umgebungen sind local, dev, test, staging, oder production.

Vorkonfigurierte Verbindungen (Docker, Kubernetes, verwaltete Maschinen)

Anstatt eine Datei einmal zu importieren, kann SQLly bereitstellen Verbindungen bei jedem Start - in der Desktop-App, in den sqlly-cli Agentenbefehlen und auf einem selbstgehosteten sqlly-bridge embedded Server. Zeig SQLLY_PROVISIONED_CONNECTIONS_FILE auf eine Datei (oder leg provisioned-connections.json im Einstellungsordner von SQLly neben connections.jsonab), und/oder setze eine SQLLY_CONNECTION_<NAME> Variable pro Verbindung, die ihre URL enthält. Die Datei verwendet das oben angegebene Verbindungsdateiformat (format und version kann weggelassen werden, und nur connections wird gelesen), und jede Verbindung kann eine url anstatt seiner Engine-, Server-, Port-, Datenbank- und Anmeldefelder:

{
  "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
  • Sentinel-URLs - redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>], mit rediss+sentinel:// für TLS und valkey+sentinel:// / valkeys+sentinel:// für Valkey. ?sentinelPassword= setzt das eigene Passwort der Sentinels und ?preferReplica=true sendet schreibgeschützte Skripte an ein Replikat. Sentinels ohne Port verwenden 26379. Dieselben URLs funktionieren im Verbindungseditor unter Paste URL.
  • ${VARIABLE} irgendwo in der Datei (oder in einer SQLLY_CONNECTION_ URL) wird durch diese Umgebungsvariable ersetzt; schreibe $${ für ein Literal ${.
  • Passwörter landen nie in Dateien - ein Passwort, Token, redis_sentinel_password, URL-Passwort, oder sentinelPassword genau so geschrieben ${VARIABLE} wird jedes Mal aus der Umgebung gelesen, wenn SQLly eine Verbindung herstellt, und wird niemals in ein Profil kopiert oder irgendwo gespeichert.
  • Verwaltet, schreibgeschützt - bereitgestellte Verbindungen erscheinen neben deinen eigenen, landen aber nie in connections.json, und Speichern und Löschen werden für sie verweigert: ändere stattdessen die Datei oder die Variablen oder verwende Duplizieren , um deine eigene bearbeitbare Kopie zu erstellen.
  • Ein fehlerhafter Eintrag blockiert niemals die anderen - eine unbekannte Einstellung, eine nicht gesetzte Variable oder eine nicht lesbare URL überspringt nur diese Verbindung und gibt eine Warnung aus, welche und warum; eine spätere Verbindung mit einem bereits verwendeten Namen wird auf die gleiche Weise übersprungen.
  • Auf der Brücke - sqlly-bridge embedded stellt sie als schreibgeschütztes Profil bereit provisioned (auch über --provisioned-connections <file>); Start-Token können es wie jedes andere Profil benennen, und es wird niemals in das Zustandsverzeichnis geschrieben.