Tudo é um arquivo

funcional

Conexõ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:

PlataformaPasta
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.
Segredos são a exceção, de propósito. Senhas e tokens vão para o chaveiro do sistema operacional (Keychain do macOS, Gerenciador de Credenciais do Windows, Secret Service do Linux), e o JSON armazena apenas uma referência para eles. É isso que torna seguro copiar, comparar ou fazer commit do seu arquivo de conexão: as credenciais não estão nele.

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.