一切皆為檔案

功能性的

連線、歷史記錄、程式碼片段、卡片和規則都以一般檔案的形式存放,你可以備份、檢視並保留它們。

連線、查詢歷史、程式碼片段、實體卡片、快速鍵設定和規則全部以 磁碟上的純檔案。沒有日後得設法擺脫的不透明應用程式資料庫:可以備份、比對差異,需要的話也可以放進 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 僅儲存對它們的 參考 。這正是你可以安心複製、比對差異或提交連線檔案的原因:認證資訊不在檔案裡。

設定檔具版本標記

connections.json, tenant-scoping.json,以及其他每個設定檔,都會記錄自己儲存時的設定版本。當 SQLly 啟動並發現某個檔案是較舊版本存的,會把它升級一次,並以目前版本儲存。這一版中,升級會清除早期版本儲存的租戶範圍設定(見 租戶範圍)。你無需執行任何操作。

為什麼是這個形式

  • 你可以離開。 你的設定不用 SQLly 也讀得懂,而且方便帶著走 cp.
  • 你可以審閱。 連線或按鍵映射的變更會以你讀得懂的差異呈現——這是唯一能在團隊裡留存下來的設定變更方式。
  • 出了問題能自己修。 出問題時,那是一個你自己就打得開的檔案,而不是得開支援單才能處理的資料庫。
  • 同步不是我們的問題。 因為它就只是檔案,任何同步檔案的工具都行得通,我們不必居中經手。