匯出與匯入連線

功能性的

移動伺服器、資料庫和登入資訊——有密碼或無密碼——以及標籤顏色和圖示到另一台機器的單一檔案中,精準選擇要包含的項目。

A 連線檔案 在一個步驟內把整套工作設定搬到另一台機器或交給同事:伺服器、伺服器上的資料庫、要用的登入,以及(如果你選擇)它們的密碼,還有這些連線所屬的客戶、專案與環境標籤,包括每個標籤的 顏色 和 圖示。兩種匯出寫出的是同一種檔案;唯一差別在於裡面含不含密碼。可以從 SQLly 匯出,也可以手寫一份來佈建團隊,然後在任何一份 SQLly 裡匯入。

存有密碼的檔案會以明文保存密碼。 這就是它好用的地方,也是它敏感的地方。SQLly 儲存的匯出檔案只有你讀得到,匯入時會把每個密碼移進你的系統鑰匙圈,而且絕不保留檔案副本。請透過你信任的管道傳送,匯入完成後就刪掉。要共用連線 沒有 密碼,請使用 檔案 → 匯出連線….

匯出連線

選擇 檔案 → 匯出連線… ,可匯出不含密碼的檔案,或 檔案 → 匯出連線與憑證… 以獲取包含密碼的文件(這兩個命令在命令面板中也可以找到)。任一選項都會開啟一個選擇器,顯示每個已儲存的連線樹狀結構:每個 伺服器 (主機、連接埠和引擎),再搭配 資料庫 以及你儲存在其下的密碼。Export Conn w/ Creds 開啟時,頂端會顯示警告:檔案內將包含明文密碼。

  • 選擇部分或全部伺服器 - 勾選伺服器即可選取其下所有資料庫,再勾選一次則取消。
  • 選擇部分或全部資料庫 - 展開伺服器並個別勾選資料庫;伺服器那一列會顯示已選取幾個資料庫。
  • 全選 / 清除 一次切換所有項目。一開始全部都是選取狀態。
  • 只有你挑選的內容會跟著走 - 只會包含所選連線用到的共用登入、通道設定檔,以及客戶、專案和環境標籤,其他一概不含。

點擊 匯出 並選擇儲存位置。無論哪種方式,連線編輯器提供的每個設定都會一併帶上,包括每個連線的登入方法。若包含認證資訊,SQLly 會從你的鑰匙圈讀出每個密碼、通關密語和權杖寫入檔案;不包含的話,所有機密都不會寫入,且 SQLly 會在存檔前檢查檔案裡確實沒有任何機密。被多個匯出連線共用的登入會寫成一份共用登入;只被一個連線使用的登入則寫在該連線上。標籤圖示會內嵌在檔案裡,所以檔案本身自成一體。

SQLly
SQLLY 匯出連線對話方塊,可選擇是否包含密碼及目的地檔案SQLLY 匯出連線對話方塊,可選擇是否包含密碼及目的地檔案
匯出連線對話方塊:選擇是否包含密碼,然後選擇檔案。

匯入連線

選擇 檔案 → 匯入連線… 然後選擇檔案。同一個命令可讀取含密碼或不含密碼的檔案,也能讀取舊版 SQLly「匯出連線」儲存的檔案。它會在動任何內容之前先檢查整個檔案;只要有任何一項有錯,就列出所有問題且完全不匯入,所以不可能只匯入一半。設定名稱打錯會被回報,而不是默默略過。匯入的連線會立刻出現在伺服器總管中。

  • 密碼會存入你的鑰匙圈 - macOS 上的鑰匙圈,Windows 上的憑證管理員,Linux 上的 Secret Service —— 永遠不會進入 SQLly 的已儲存連線檔案。狀態列會顯示有多少被匯入。
  • 標籤依名稱合併 - 現有的客戶、專案或環境會保留檔案未設定的任何內容,只有檔案列出的安全設定會被更改。
  • 共用登入會即時更新 - 具有相同名稱和使用者名稱的已儲存登入會獲得新密碼,因此每個已使用它的連線仍然可正常運作。
  • 無密碼也沒問題 - 沒有密碼的登入(在未含憑證的檔案中匯出的每個登入)照樣會匯入,SQLly 會在你第一次連線時要求輸入密碼。

從 Redis Insight 匯入

在 Redis Insight 中,選取你的資料庫,然後選擇 匯出 (勾選 包含密碼 如果你想把它們一併帶過去)。在 SQLly 中選擇 從其他工具匯入… 並選擇匯出的檔案(純 JSON,或 Redis Insight 也接受的 base64 格式)。每個資料庫都會變成一個 Redis 連線,帶有其主機、連接埠、邏輯資料庫、ACL 使用者名稱,以及 SSH 通道與 TLS 設定。

  • TLS 永遠不會被拿掉 - 匯出時帶有 TLS(或 CA 或客戶端憑證)的資料庫會以加密方式匯入: 驗證 CA 當 Redis Insight 驗證了伺服器憑證, 需要 當它實際上沒有時。憑證與金鑰內容會以 PEM 檔案儲存在 SQLly 的資料資料夾中(金鑰僅你能讀取),連線會指向這些檔案。
  • 機密會存到你的鑰匙圈 - 匯出檔裡的密碼、SSH 密碼和金鑰通關密語,儲存方式與連線檔完全相同,絕不會寫進已儲存的連線檔。匯出後請把檔案刪掉:裡面的內容是明文。
  • Azure Entra 資料庫 使用 Microsoft Entra 登入匯入;在連線編輯器中選擇 Azure 帳戶。
  • 叢集資料庫 匯入為 Redis Cluster 連線,並以其中指名的節點作為種子(或當 Redis Insight 被設定強制單機時,匯入為單一節點); 哨兵 資料庫會匯入成 Sentinel 連線,帶著主節點群組、Sentinel 的密碼(移到鑰匙圈)與主節點本身的登入資訊;狀態列會列出所有無法轉移的項目。

連線檔案可以包含的內容

區段它所承載的內容
連線任意數量的伺服器,且每台伺服器上可有任意數量的資料庫:引擎、主機、連接埠、資料庫、環境、客戶與專案、登入方式與(有認證資訊時的)密碼、TLS 模式與憑證檔案、連線與陳述式逾時、應用程式名稱、啟動 SQL、每個連線的安全開關、我的最愛星號、遮罩規則、中繼路由,以及內嵌的 SSH 通道、Proxy 或 Kubernetes 連接埠轉送。
共用登入多個具名登入(使用者名稱,密碼存放在憑證檔中),可供多條連線使用。
通道設定檔具名 SSH(含跳板主機)、Proxy 與 Kubernetes 連線鏈,以及存放在憑證檔中的 SSH 密碼與金鑰密碼。
客戶、專案、環境名稱、顏色、圖示圖片(內嵌於檔案中),以及任意的查詢保護設定。

SQLly 支援的每一種登入方式都能描述:使用者名稱與密碼、Windows 整合安全性、Microsoft Entra(瀏覽器或裝置碼)、AWS RDS IAM、Google Cloud SQL IAM,以及 libSQL / Turso 權杖。SQLite 和 DuckDB 檔案不需登入。

手動撰寫一個

連線檔案就是純 JSON,管理員可以寫一份,交給團隊一個現成的設定。只有連線的 name, engine,而且 server ——其他所有項目都會退回連線編輯器給的相同預設值。這個檔案在同一台伺服器上加了兩個共用唯讀登入的資料庫、一台有自己密碼的第二台伺服器,以及一個有圖示、設了顏色的用戶端:

{
  "format": "sqlly-credentials",
  "version": 1,
  "clients": [
    { "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
  ],
  "sql_auth_accounts": [
    { "name": "Reader", "username": "ro", "password": "ro-secret" }
  ],
  "connections": [
    { "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
      "client": "Acme", "environment": "production",
      "authentication": { "type": "sql-login", "account": "Reader" },
      "tls": { "mode": "verify-full" } },
    { "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
      "client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
    { "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
      "authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
  ]
}
  • 引擎 可以隨意編寫—— postgres, PostgreSQL, mssql, sql-server, mysql, sqlite, duckdb, clickhouse, redis,依此類推。
  • 顏色 是 #RGB, #RRGGBB,或 #RRGGBBAA.
  • 圖示 是 base64 —— 一個 data:image/…;base64, URI 或純 base64——PNG、JPEG、GIF、WebP、BMP、ICO 或 SVG 圖片,最大 1 MB。
  • 環境 是 local, dev, test, staging,或 production.

預先設定的連線(Docker、Kubernetes、受管理的機器)

與其只匯入檔案一次,不如讓 SQLly 佈建 啟動時都會讀取連線——在桌面應用程式裡、在 sqlly-cli 代理指令,以及自行託管的 sqlly-bridge embedded 伺服器。點 SQLLY_PROVISIONED_CONNECTIONS_FILE 指向某個檔案(或把 provisioned-connections.json 位於 SQLly 的設定資料夾中,旁邊就是 connections.json),和/或設定一個 SQLLY_CONNECTION_<NAME> 每個連線各有一個變數來存放其 URL。檔案採用上述的連線檔案格式(format 和 version 可以省略,而只有 connections 讀取之後),而且任何連線都能給出 url 而不是引擎、伺服器、連接埠、資料庫與登入欄位:

{
  "connections": [
    { "name": "Cache",
      "url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
      "environment": "production" },
    { "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
      "authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
      "tls": { "mode": "verify-full" } }
  ]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=...        # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
  • Sentinel 網址 - redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>],並且 rediss+sentinel:// 用於 TLS 和 valkey+sentinel:// / valkeys+sentinel:// 對 Valkey 也有效嗎? ?sentinelPassword= 設定哨兵自己的密碼並 ?preferReplica=true 會將唯讀腳本傳送給副本。未指定連接埠的哨兵使用 26379。這些 URL 也可以用在連線編輯器的「貼上 URL」。
  • ${VARIABLE} 在檔案中的任何位置(或在一個 SQLLY_CONNECTION_ URL)會換成該環境變數;寫成 $${ ,來表示字面上的 ${.
  • 密碼不寫進檔案 - 密碼、權杖, redis_sentinel_password、URL 密碼,或 sentinelPassword 若完全寫成 ${VARIABLE} 每次 SQLly 連線時都會從環境中讀取,並且永遠不會複製到設定檔或儲存到任何地方。
  • 受管理、唯讀 - 佈建的連線會與你自己的連線並列顯示,但永遠不會寫入 connections.json,而且不能對它們儲存或刪除:請直接改檔案或變數,或使用 複製 來建立你可編輯的副本。
  • 一個錯誤的項目不會拖垮其餘項目 - 未知的設定、未設定的變數或無法讀取的 URL 只會略過該連線,並輸出警告說明是哪一個以及原因;之後名稱重複的連線也會以同樣方式略過。
  • 在橋接上 - sqlly-bridge embedded 以唯讀設定檔提供它們 provisioned (也可以透過 --provisioned-connections <file>);啟動權杖可以像其他設定檔一樣指名使用它,而且它絕不會寫入狀態目錄。