모든 것은 파일입니다

정상 동작

연결, 기록, 스니펫, 카드, 규칙은 백업하고, 들여다보고, 남겨둘 수 있는 일반 파일로 저장됩니다.

연결, 쿼리 기록, 스니펫, 엔터티 카드, 키 바인딩 및 규칙 모두는 디스크 위의 일반 파일. 나중에 빠져나가야 할 불투명한 애플리케이션 데이터베이스가 없습니다. 백업하고, diff로 비교하고, 워크플로에 맞는다면 Git에 담아 두세요.

위치

모든 것은 단 하나의 SQLLY 폴더는 플랫폼의 일반적인 설정 및 데이터 위치 아래에 있습니다:

플랫폼폴더
macOS~/Library/Application Support/SQLLY/
Windows%APPDATA%\SQLLY\ 그리고 %LOCALAPPDATA%\SQLLY\
Linux~/.config/SQLLY/ 그리고 ~/.local/share/SQLLY/

거기에서 발견할 수 있는 몇 가지 파일:

  • connections.json - 연결과 그 연결이 속한 클라이언트, 프로젝트, 환경, 그리고 각자의 색과 안전 정책. 비밀번호는 절대 포함하지 않음 (아래 참조).
  • keybindings.json - 여러분의 키맵, 수동으로 편집 가능.
  • intellisense-rules.jsonc - 주석을 허용하는 자동 완성 규칙. 주석을 달 수 없는 규칙 파일은 아무도 관리하지 않게 되기 때문입니다.
  • entra-accounts.json, query-ai-summary.json, cli-agent.json - 기능별 설정은 기능당 파일 하나씩이라, 초기화는 수술이 아니라 삭제로 끝납니다.
  • 쿼리 기록, AI 대화, MCP 제안과 감사, 임시 결과 스필 파일을 위한 폴더입니다.
비밀 정보는 의도적으로 예외입니다. 비밀번호와 토큰은 운영 체제 키체인(macOS Keychain, Windows Credential Manager, Linux Secret Service)에 저장되고, JSON에는 그것에 대한 참조 만 저장됩니다. 이게 연결 파일을 복사하거나 diff하거나 커밋해도 안전한 이유입니다: 자격 증명은 그 안에 없습니다.

버전이 기록된 설정 파일

connections.json, tenant-scoping.json, 그리고 그 밖의 모든 설정 파일은 저장 당시의 구성 버전을 기록합니다. SQLly가 시작할 때 이전 버전이 저장한 파일을 발견하면 한 번 업그레이드해서 현재 버전으로 저장합니다. 이번 릴리스의 업그레이드는 이전 버전이 저장한 테넌트 범위 설정을 지웁니다(자세한 내용은 테넌트 범위 지정). 사용자가 할 일은 없습니다.

이런 형태인 이유

  • 언제든 떠날 수 있습니다. 설정은 SQLly 없이도 읽을 수 있고, 옮길 때는 cp.
  • 직접 검토할 수 있습니다. 연결이나 키맵 변경은 읽을 수 있는 diff로 드러나는데, 팀을 거치고도 살아남는 설정 변경은 이것뿐입니다.
  • 직접 고칠 수 있습니다. 문제가 생겼을 때 열어 볼 수 있는 것은 파일이지, 지원 티켓이 필요한 데이터베이스가 아닙니다.
  • 동기화는 우리 몫이 아닙니다. 그냥 파일이기 때문에 파일을 동기화하는 어떤 도구로도 되고, 우리가 그 가운데 끼어 있을 필요도 없습니다.