Exportar e importar conexiones
funcionalMueve servidores, bases de datos e inicios de sesión, con o sin contraseñas, además de colores de etiquetas e iconos a otra máquina en un solo archivo, eligiendo exactamente qué incluir.
A archivo de conexión mueve una configuración de trabajo completa entre máquinas o compañeros de equipo en un solo paso: servidores, las bases de datos en ellos, los inicios de sesión a utilizar y, si eliges, sus contraseñas, junto con las etiquetas de cliente, proyecto y entorno a las que pertenecen esas conexiones, incluyendo cada etiqueta color y icono. Ambas exportaciones escriben el mismo archivo; la única diferencia es si las contraseñas van dentro. Exporta uno desde SQLly, o escríbelo a mano para aprovisionar un equipo, e impórtalo en cualquier copia de SQLly.
Exportar conexiones
Elegir Archivo → Exportar conexiones… para un archivo sin contraseñas, o Archivo → Exportar conexión con credenciales… para uno con ellas (ambos también están en la paleta de comandos). Cualquiera abre un selector que muestra cada conexión guardada como un árbol: cada servidor (host, puerto y motor) con el bases de datos que hayas guardado en ella debajo. Exportar Conn con Credenciales se abre con una advertencia arriba: el archivo contendrá contraseñas en texto claro.
- Elige algunos o todos los servidores - marca un servidor para llevarte todas sus bases de datos, o vuelve a marcarlo para desmarcarlas.
- Elige algunas o todas las bases de datos - expande un servidor y marca bases de datos individuales; la fila del servidor muestra cuántas de sus bases de datos están seleccionadas.
- Seleccionar todo / Limpiar marca o desmarca todo de una vez. Todo empieza seleccionado.
- Solo se incluye lo que seleccionaste - se incluyen los inicios de sesión compartidos, los perfiles de túnel y las etiquetas de cliente, proyecto y entorno que usan las conexiones elegidas, y nada más.
Haz clic Exportar y elige dónde guardar. Todos los ajustes que ofrece el editor de conexiones se incluyen en ambos casos, incluido el método de inicio de sesión de cada conexión. Con credenciales, SQLly vuelca cada contraseña, frase de contraseña y token de tu llavero en el archivo; sin ellas, omite todos los secretos y comprueba que el archivo no contenga ninguno antes de guardarlo. Un inicio de sesión usado por varias de las conexiones exportadas se escribe una vez como inicio de sesión compartido; uno usado por una sola conexión se escribe en esa conexión. Los iconos de las etiquetas se incrustan en el archivo, así que este es completo por sí solo.


Importar conexiones
Elegir Archivo → Importar conexiones… y selecciona el archivo. El mismo comando lee archivos con o sin contraseñas, y también los guardados por Exportar conexiones en versiones anteriores de SQLly. Antes de cambiar nada comprueba el archivo entero y, si alguna entrada está mal, enumera todos los problemas y no importa nada, así que no puede quedar una importación a medias. Un nombre de ajuste mal escrito se avisa en lugar de pasarse por alto en silencio. Las conexiones importadas aparecen en el explorador de servidores de inmediato.
- Las contraseñas van a tu llavero - Llavero en macOS, Administrador de Credenciales en Windows, Secret Service en Linux - nunca en el archivo de conexiones guardadas de SQLly. La barra de estado indica cuántas se importaron.
- Las etiquetas se fusionan por nombre - un cliente, proyecto o entorno ya existente conserva todo lo que el archivo no establezca, y solo cambian los interruptores de seguridad que el archivo enumere.
- Los inicios de sesión compartidos se actualizan donde están - un inicio de sesión guardado con el mismo nombre y nombre de usuario obtiene la nueva contraseña, de modo que todas las conexiones que ya lo usan siguen funcionando.
- Sin contraseña, no hay problema - un inicio de sesión sin ella (todos los inicios de sesión, en un archivo exportado sin credenciales) se importa de todos modos, y SQLly solicita la contraseña la primera vez que te conectas.
Importando desde Redis Insight
En Redis Insight, selecciona tus bases de datos y elige Exportar (marca Incluir contraseñas si deseas que se transfieran). En SQLly elige Importar desde otras herramientas… y selecciona el archivo exportado, ya sea JSON plano o el formato base64 que Redis Insight también acepta. Cada base de datos se convierte en una conexión Redis con su host, puerto, base de datos lógica, usuario ACL, túnel SSH y ajustes TLS.
- TLS nunca se desactiva - una base de datos exportada con TLS (o con una CA o un certificado de cliente) se importa cifrada: Verificar CA cuando Redis Insight verificó el certificado del servidor, Requerir cuando no lo hizo. El contenido de certificados y claves se guarda como archivos PEM en la carpeta de datos de SQLly (claves legibles solo por ti), y la conexión apunta a ellos.
- Los secretos van a tu llavero - las contraseñas, las contraseñas SSH y las frases de las claves que vengan en la exportación se guardan igual que en un archivo de conexión, nunca en el archivo de conexiones guardadas. Borra la exportación después: las contiene en texto plano.
- Bases de datos de Azure Entra importa con inicio de sesión de Microsoft Entra; selecciona la cuenta de Azure en el editor de conexiones.
- Bases de datos de clúster importa como conexiones de Redis Cluster inicializadas con el nodo que nombran (o como un solo nodo cuando Redis Insight fue configurado para forzar modo independiente) Sentinel las bases de datos se importan como conexiones Sentinel con el grupo maestro, la contraseña del sentinel (movida al llavero) y el inicio de sesión del propio maestro, y la barra de estado lista todo lo que no se pudo transferir.
Lo que un archivo de conexión puede contener
| Sección | Lo que lleva |
|---|---|
| Conexiones | Cualquier número de servidores y cualquier número de bases de datos en cada uno: motor, host, puerto, base de datos, entorno, cliente y proyecto, método de inicio de sesión y (con credenciales) contraseña, modo TLS y archivos de certificado, tiempos de espera de conexión y de instrucción, nombre de la aplicación, SQL de inicio, interruptores de seguridad por conexión, estrella de favorito, reglas de enmascaramiento, ruta de relay y un túnel SSH en línea, proxy o reenvío de puerto de Kubernetes. |
| Inicios de sesión compartidos | Varios inicios de sesión con nombre (nombre de usuario, más la contraseña en un archivo de credenciales) que pueden usar muchas conexiones. |
| Perfiles de túnel | Cadenas con nombre de SSH (con host de salto), proxy y Kubernetes, además de contraseñas SSH y frases de contraseña de claves en un archivo de credenciales. |
| Clientes, proyectos, entornos | Nombre, color, imagen del icono (incrustada en el archivo) y cualquiera de las protecciones de consulta. |
Cada método de inicio de sesión que SQLly admite puede describirse: nombre de usuario y contraseña, seguridad integrada de Windows, Microsoft Entra (navegador o código de dispositivo), AWS RDS IAM, Google Cloud SQL IAM y tokens de libSQL / Turso. Los archivos SQLite y DuckDB no necesitan inicio de sesión.
Escribiéndolo a mano
Un archivo de conexión es JSON simple, así que un administrador puede escribir uno y darle al equipo una configuración lista para usar. Solo se requieren name, engine, y
server son obligatorios - todo lo demás toma el mismo valor por defecto que usa el editor de conexiones. Este archivo añade dos bases de datos en un servidor que comparten un inicio de sesión de solo lectura, un segundo servidor con su propia contraseña y un cliente con un color y un icono:
{
"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" } }
]
}
- Motores puede escribirse de manera flexible -
postgres,PostgreSQL,mssql,sql-server,mysql,sqlite,duckdb,clickhouse,redis, y así sucesivamente. - Colores son
#RGB,#RRGGBB, o#RRGGBBAA. - Iconos son base64: un
data:image/…;base64,URI o el base64 sin formato - de una imagen PNG, JPEG, GIF, WebP, BMP, ICO o SVG de hasta 1 MB. - Entornos son
local,dev,test,staging, oproduction.
Conexiones preconfiguradas (Docker, Kubernetes, máquinas gestionadas)
En lugar de importar un archivo una vez, puedes hacer que SQLly aprovisionar conexiones cada vez que arranca - en la aplicación de escritorio, en los sqlly-cli comandos del agente, y en un servidor autoalojado sqlly-bridge embedded servidor. Apunta
SQLLY_PROVISIONED_CONNECTIONS_FILE a un archivo (o pon
provisioned-connections.json en la carpeta de ajustes de SQLly, al lado de
connections.json), y/o establece una SQLLY_CONNECTION_<NAME>
variable por conexión que contiene su URL. El archivo usa el formato de archivo de conexión de arriba (format y version se puede omitir, y solo
connections se lee), y cualquier conexión puede proporcionar un url en lugar de los campos de motor, servidor, puerto, base de datos e inicio de sesión:
{
"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
- URL de los Sentinel -
redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>], conrediss+sentinel://para TLS yvalkey+sentinel:///valkeys+sentinel://para Valkey.?sentinelPassword=establece la propia contraseña de los centinelas y?preferReplica=trueenvía scripts de solo lectura a una réplica. Los centinelas sin puerto usan 26379. Las mismas URL funcionan en la opción «Pegar URL» del editor de conexiones. ${VARIABLE}en cualquier parte del archivo (o en unaSQLLY_CONNECTION_URL) se sustituye por esa variable de entorno; escribe$${para un literal${.- Las contraseñas quedan fuera de los archivos - una contraseña, token,
redis_sentinel_password, contraseña de URL, osentinelPasswordescrita exactamente${VARIABLE}se lee del entorno cada vez que SQLly se conecta, y nunca se copia en un perfil ni se guarda en ningún sitio. - Administrado, de solo lectura - las conexiones aprovisionadas aparecen junto a las tuyas, pero nunca se escriben en
connections.json, y Guardar y Eliminar se rechazan para ellas: cambia el archivo o las variables, o usa Duplicar para hacer tu propia copia editable. - Una entrada incorrecta nunca bloquea las demás - un ajuste desconocido, una variable sin definir o una URL ilegible omite solo esa conexión e imprime una advertencia que dice cuál y por qué; una conexión posterior con un nombre ya usado se omite igual.
- En el puente -
sqlly-bridge embeddedlos sirve como el perfil de solo lecturaprovisioned(también a través de--provisioned-connections <file>); los tokens de lanzamiento pueden nombrarlo como cualquier otro perfil, y nunca se escribe en el directorio de estado.