모든 것은 파일입니다
정상 동작연결, 기록, 스니펫, 카드, 규칙은 백업하고, 들여다보고, 남겨둘 수 있는 일반 파일로 저장됩니다.
연결, 쿼리 기록, 스니펫, 엔터티 카드, 키 바인딩 및 규칙 모두는 디스크 위의 일반 파일. 나중에 빠져나가야 할 불투명한 애플리케이션 데이터베이스가 없습니다. 백업하고, 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로 드러나는데, 팀을 거치고도 살아남는 설정 변경은 이것뿐입니다.
- 직접 고칠 수 있습니다. 문제가 생겼을 때 열어 볼 수 있는 것은 파일이지, 지원 티켓이 필요한 데이터베이스가 아닙니다.
- 동기화는 우리 몫이 아닙니다. 그냥 파일이기 때문에 파일을 동기화하는 어떤 도구로도 되고, 우리가 그 가운데 끼어 있을 필요도 없습니다.