Tudo é um arquivo
funcionalConexões, histórico, trechos, cartões e regras ficam como arquivos simples que você pode copiar para backup, inspecionar e manter.
Conexões, histórico de consultas, trechos, cartões de entidades, atalhos de teclado e regras ficam todos como arquivos simples no disco. Não há um banco de dados de aplicativo opaco do qual escapar mais tarde: faça backup deles, compare as diferenças, ou mantenha-os no Git se isso se adequar ao seu fluxo de trabalho.
Onde eles estão
Tudo fica em uma única SQLLY pasta dentro dos locais normais de configuração e dados da sua plataforma:
| Plataforma | Pasta |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/ |
| Janelas | %APPDATA%\SQLLY\ e %LOCALAPPDATA%\SQLLY\ |
| Linux | ~/.config/SQLLY/ e ~/.local/share/SQLLY/ |
Alguns dos arquivos que você vai encontrar lá:
connections.json- suas conexões e os clientes, projetos e ambientes a que elas pertencem, com as cores delas e a política de segurança. Nunca senhas (veja abaixo).keybindings.json- seu mapa de teclas, editável manualmente.intellisense-rules.jsonc- regras de autocompletar, com comentários permitidos, porque um arquivo de regras que você não pode anotar é um arquivo de regras que você não vai manter.entra-accounts.json,query-ai-summary.json,cli-agent.json- configurações por recurso, um arquivo para cada, então um reset é uma exclusão em vez de uma cirurgia.- Pastas para histórico de consultas, conversas com IA, propostas e auditoria do MCP e arquivos temporários de resultados gravados em disco.
Arquivos de configurações versionadas
connections.json, tenant-scoping.json, e todos os outros arquivos de configuração guardam a versão com que foram salvos. Quando o SQLly inicia e encontra um arquivo salvo por uma versão anterior, ele atualiza esse arquivo uma vez e o salva na versão atual. Nesta versão, a atualização remove as configurações com escopo de locatário salvas por versões anteriores (veja Escopo de inquilino). Não há nada que você precise fazer.
Por que essa forma
- Você pode sair. Sua configuração é legível sem o SQLly e portátil com
cp. - Você pode revisar. Uma alteração em uma conexão ou em um mapa de teclas aparece como um diff que você consegue ler, o único tipo de alteração de configuração que sobrevive a uma equipe.
- Você pode consertar. Quando algo está errado, é um arquivo que você pode abrir, não um banco de dados que precisa de um ticket de suporte.
- A sincronização não é nosso problema. Porque são apenas arquivos, qualquer ferramenta que sincronize arquivos funciona, e não precisamos estar no meio disso.