Exportar e importar conexões
funcionalMova servidores, bancos de dados e logins - com ou sem senhas - além de cores e ícones de rótulos para outra máquina em um arquivo, escolhendo exatamente o que incluir.
A arquivo de conexão move uma configuração de trabalho inteira entre máquinas ou colegas de equipe em uma única etapa: servidores, os bancos de dados neles, os logins a usar e, se você escolher, as senhas deles, junto com os rótulos de cliente, projeto e ambiente aos quais essas conexões pertencem, incluindo, para cada rótulo, a cor e ícone. As duas exportações gravam o mesmo arquivo; a única diferença é se as senhas vão dentro. Exporte um pelo SQLly, ou escreva um à mão para provisionar uma equipe, e importe-o em qualquer cópia do SQLly.
Exportar conexões
Escolha Arquivo → Exportar conexões… para um arquivo sem senhas, ou Arquivo → Exportar conexão com credenciais… para um com elas (ambos também estão na paleta de comandos). Qualquer um dos dois abre um seletor que mostra cada conexão salva como uma árvore: cada servidor (host, porta e engine) com os bancos de dados você salvou nela abaixo. Exportar Conn c/ Credenciais abre com um aviso no topo de que o arquivo conterá senhas em texto puro.
- Escolha alguns ou todos os servidores - marcar um servidor para pegar todos os bancos de dados abaixo dele, ou marcar de novo para limpar.
- Escolha alguns ou todos os bancos de dados - expanda um servidor e marque bancos de dados individuais; a linha do servidor mostra quantos de seus bancos de dados estão selecionados.
- Selecionar tudo / Limpar marca ou desmarca tudo de uma vez. Tudo começa selecionado.
- Somente o que você escolheu vai junto - os logins compartilhados, os perfis de túnel e os rótulos de cliente, projeto e ambiente que as conexões escolhidas usam estão incluídos, e nada mais.
Clique Exportar e escolha onde salvar. Toda configuração que o editor de conexões oferece vem junto de qualquer maneira, incluindo o método de login de cada conexão. Com credenciais, o SQLly lê cada senha, frase secreta e token de volta do seu keychain para o arquivo; sem elas, todo segredo é deixado de fora e o SQLly verifica se o arquivo não contém nenhum antes de salvá-lo. Um login usado por várias conexões exportadas é escrito uma vez como um login compartilhado; um login usado por uma conexão é escrito naquela conexão. Os ícones de rótulo estão incorporados no arquivo, então ele é completo por si só.


Importar conexões
Escolha Arquivo → Importar conexões… e selecione o arquivo. O mesmo comando lê um arquivo com ou sem senhas, e arquivos salvos por Exportar Conexões em versões anteriores do SQLly. Antes de alterar qualquer coisa, ele verifica todo o arquivo e, se houver algum registro incorreto, lista todos os problemas e não importa nada, evitando que uma importação seja parcialmente aplicada. Um nome de configuração digitado incorretamente é relatado em vez de ser ignorado silenciosamente. As conexões importadas aparecem imediatamente no explorador de servidores.
- Senhas vão para seu chaveiro - Chaveiro no macOS, Gerenciador de Credenciais no Windows, Secret Service no Linux - nunca no arquivo de conexões salvas do SQLly. A barra de status diz quantos chegaram.
- Rótulos são mesclados por nome - um cliente, projeto ou ambiente existente mantém o que o arquivo não definir, e só os interruptores de segurança que o arquivo lista mudam.
- Logins compartilhados são atualizados no local - um login salvo com o mesmo nome e usuário recebe a nova senha, então toda conexão que já o usa continua funcionando.
- Sem senha, sem problema - um login sem senha (todo login, em um arquivo exportado sem credenciais) é importado mesmo assim, e o SQLly pede a senha na primeira vez que você conecta.
Importando do Redis Insight
No Redis Insight, selecione seus bancos de dados e escolha Exportar (marcar Incluir senhas se você quiser que elas sejam transferidas). No SQLly escolha Importar de outras ferramentas… e selecione o arquivo exportado, JSON simples ou a forma base64 que o Redis Insight também aceita. Cada banco de dados se torna uma conexão Redis com seu host, porta, banco de dados lógico, nome de usuário ACL, túnel SSH e configurações TLS.
- O TLS nunca é desativado - um banco de dados exportado com TLS (ou com uma CA ou certificado de cliente) é importado criptografado: Verificação de CA quando o Redis Insight verificou o certificado do servidor, Exigir quando não verificou. O conteúdo do certificado e da chave é salvo como arquivos PEM na pasta de dados do SQLly (chaves legíveis apenas por você), e a conexão aponta para eles.
- Segredos vão para o seu chaveiro - senhas, senhas SSH e frases secretas de chaves da exportação são guardadas exatamente como as de um arquivo de conexão, nunca no arquivo de conexões salvas. Apague a exportação depois: ela as mantém em texto claro.
- Bancos de dados do Azure Entra importe com login do Microsoft Entra; escolha a conta Azure no editor de conexão.
- Bancos de dados do cluster importe como conexões de Redis Cluster pré-configuradas com o nó que elas indicam (ou como um único nó quando o Redis Insight foi configurado para forçar o modo autônomo); Sentinel os bancos de dados são importados como conexões Sentinel com o grupo master, a senha do sentinel (movida para o chaveiro) e o login do próprio master, e a barra de status lista tudo o que não pôde ser migrado.
O que um arquivo de conexão pode conter
| Seção | Conteúdo |
|---|---|
| Conexões | Qualquer número de servidores e qualquer número de bancos de dados em cada um: mecanismo, host, porta, banco de dados, ambiente, cliente e projeto, método de login e (com credenciais) senha, modo TLS e arquivos de certificado, tempos limite de conexão e de instrução, nome do aplicativo, SQL de inicialização, opções de segurança por conexão, estrela de favorito, regras de mascaramento, rota de relay e um túnel SSH embutido, um proxy ou um redirecionamento de porta do Kubernetes. |
| Logins compartilhados | Vários logins nomeados (nome de usuário, mais a senha em um arquivo de credenciais) que muitas conexões podem usar. |
| Perfis de túnel | Cadeias nomeadas de SSH (com host de salto), proxy e Kubernetes, além de senhas de SSH e frases de senha de chave em um arquivo com credenciais. |
| Clientes, projetos, ambientes | Nome, cor, imagem do ícone (incorporada no arquivo) e qualquer uma das proteções de consulta. |
Todo método de login que o SQLly suporta pode ser descrito: nome de usuário e senha, segurança integrada do Windows, Microsoft Entra (navegador ou código do dispositivo), AWS RDS IAM, Google Cloud SQL IAM e tokens do libSQL / Turso. Arquivos SQLite e DuckDB não precisam de login.
Escrevendo um manualmente
Um arquivo de conexão é JSON puro, então um administrador pode escrever um e entregar à equipe uma configuração pronta. Apenas a name, engine, e
server de uma conexão é necessária - todo o resto volta para o mesmo padrão que o editor de conexões usa. Este arquivo adiciona dois bancos de dados em um servidor que compartilham um login somente leitura, um segundo servidor com sua própria senha, e um cliente colorido com um ícone:
{
"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" } }
]
}
- Mecanismos podem ser escritos de forma flexível -
postgres,PostgreSQL,mssql,sql-server,mysql,sqlite,duckdb,clickhouse,redis, e assim por diante. - Cores são
#RGB,#RRGGBB, ou#RRGGBBAA. - Ícones são base64 - uma
data:image/…;base64,URI ou base64 puro - de uma imagem PNG, JPEG, GIF, WebP, BMP, ICO ou SVG de até 1 MB. - Ambientes são
local,dev,test,staging, ouproduction.
Conexões pré-configuradas (Docker, Kubernetes, máquinas gerenciadas)
Em vez de importar um arquivo uma vez, você pode fazer com que o SQLly provisione conexões toda vez que ele iniciar - no aplicativo desktop, nos sqlly-cli comandos do agente e em um servidor auto-hospedado. sqlly-bridge embedded servidor. Aponte
SQLLY_PROVISIONED_CONNECTIONS_FILE para um arquivo (ou coloque
provisioned-connections.json na pasta de configurações do SQLly, ao lado de
connections.json), e/ou defina uma SQLLY_CONNECTION_<NAME>
variável por conexão contendo sua URL. O arquivo usa o formato de arquivo de conexão acima (format e version pode ser omitido, e apenas
connections é lido), e qualquer conexão pode fornecer um url em vez de seus campos de engine, servidor, porta, banco de dados e login:
{
"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 de Sentinel -
redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>], comrediss+sentinel://para TLS evalkey+sentinel:///valkeys+sentinel://para Valkey.?sentinelPassword=define a própria senha dos sentinelas e?preferReplica=trueenvia scripts somente leitura para uma réplica. Sentinelas sem porta usam 26379. As mesmas URLs funcionam no campo Colar URL do editor de conexões. ${VARIABLE}em qualquer lugar do arquivo (ou em umSQLLY_CONNECTION_URL) é substituído por essa variável de ambiente; escreva$${para um literal${.- Senhas ficam fora dos arquivos - uma senha, token,
redis_sentinel_password, senha na URL, ousentinelPasswordescrita exatamente${VARIABLE}é lido do ambiente a cada conexão do SQLly, e nunca é copiado para um perfil nem salvo em lugar nenhum. - Gerenciado, somente leitura - conexões provisionadas aparecem junto às suas, mas nunca são gravadas em
connections.json, e Salvar e Excluir são recusados para elas: mude o arquivo ou as variáveis no lugar, ou use Duplicar para criar sua própria cópia editável. - Uma entrada inválida nunca bloqueia as demais - uma configuração desconhecida, uma variável não definida ou uma URL ilegível pula só essa conexão e imprime um aviso dizendo qual e por quê; uma conexão posterior com um nome já usado é pulada da mesma forma.
- No bridge -
sqlly-bridge embeddedos serve como o perfil somente leituraprovisioned(também via--provisioned-connections <file>); tokens de inicialização podem nomeá-lo como qualquer outro perfil, e ele nunca é escrito no diretório de estado.