排程任務

功能性的

在 SQLly 開啟時,依排程執行內建傾印、原生備份與已存查詢匯出。

SQLly 可以每小時、每天或每週執行三種任務: 內建 SQL 傾印、 原生備份 與 pg_dump 或 mysqldump,或單獨一個 查詢匯出 它會執行 SQL 程式庫中儲存的查詢,並把結果寫入 CSV 或 JSON Lines 檔案。要新增一個,請從指令面板執行 排程任務(傾印、備份或查詢匯出)… 從命令面板開啟,或點擊 新增… 位於「設定 ▸ 工作區 ▸ 排程傾印」中。挑選資料庫與工作,然後設定輸出資料夾、頻率,以及要保留的檔案數量。

每個任務都寫進 輸出資料夾,不會只寫一個檔案:每次執行都會在那裡新增一個帶時間戳記的檔案,第一次執行時若資料夾不存在就會建立。 選擇… 開啟資料夾選擇器。預設是在你的主資料夾中的 SQLLY Backups 資料夾,在你的主資料夾裡。

任務引擎每次執行寫入的內容
內建 SQL 傾印每個支援傾印的引擎<db>_<id>_<stamp>.sql,或者當你每個物件匯出一個檔案時,該名稱的資料夾。內容、存在即刪除、批次大小以及包含哪些物件類型與「匯出資料庫為 SQL」中的設定相同。
原生備份PostgreSQL、MySQL / MariaDB<db>_native_<id>_<stamp>.dump (.tar 或 .sql 適用於那些 pg_dump 格式),或 .sql 沿用自 mysqldump。PostgreSQL 則增加了輸出格式與 --no-owner;MySQL 加上 --single-transaction.
查詢匯出每個 SQL 引擎<db>_query_<name>_<id>_<stamp>.csv 或 .jsonl 與查詢結果的每一列。
SQLly
排程任務:任務選擇器可在內建傾印、原生 pg_dump 備份與已儲存查詢匯出之間切換。
排程任務:任務選擇器可在內建傾印、原生 pg_dump 備份與已儲存查詢匯出之間切換。

僅在 SQLly 開啟時執行

SQLly 每分鐘檢查一次是否有到期任務,且只在應用程式執行時檢查。它不會安裝 cron 工作、launchd 代理程式或 Windows 排程工作。若 SQLly 關閉期間有任務到期,會在你重新開啟應用程式後的第一次檢查時執行。若需要任務在 SQLly 關閉時執行,請使用 複製 CLI 命令 (如下),然後把那一行貼進 cron(在 Windows 上,是 Git Bash 或 WSL 的 cron 工作)。

保留最新的檔案

保留 設定任務中有多少個檔案保留在其資料夾中(0 表示全部保留)。每次完整執行後,舊檔案會被刪除。取消或失敗的執行不會刪除任何檔案。在上述名稱中, <id> 是該任務專屬的短 ID,而且 <stamp> 是 YYYYMMDD-HHMMSS。清理時只會刪除名稱完全符合該任務格式的檔案,所以其他任務、同名資料庫的其他連線,以及資料夾裡你自己的檔案都不會被動到。只有當資料夾裡裝的全是一物件一檔案的傾印時,才會刪掉整個資料夾。舊版 SQLly 命名、沒有任務 ID 的檔案會原樣保留。

安全規則

  • 查詢匯出是唯讀的。 已儲存的查詢必須是單一、唯讀的 SELECT。它會在鎖定為僅限 SELECT 的連線上執行,而且資料庫自身的唯讀模式也會一併開啟。任何其他陳述式,或傳回多個結果集的查詢,都會使執行失敗,並記錄原因。查詢是從設定中指定的 SQL 程式庫資料夾讀取,因此搬移程式庫不會破壞任務。
  • 正式環境連線永遠不會執行。 排程任務,包括 立即執行,會跳過標記為生產環境的連線。跳過會記錄為該任務的最後結果。
  • 原生備份需要直接連線。 pg_dump 和 mysqldump 會自行連線資料庫,因此經由中繼橋接建立的連線只會記錄錯誤,不會執行。
  • 缺少的部分會明確回報,而不是用猜的。 如果 pg_dump 或 mysqldump 未安裝,執行時會記下錯誤,並在下一個排程時段重試。請在「設定 ▸ 進階 ▸ 資料庫工具」中設定工具的路徑。如果儲存的查詢已遭刪除,或連線已不存在,任務會自行停用並說明原因。
  • 檔案中不含密碼。 dump-schedules.json 儲存的是連線的 ID,絕不會儲存認證資訊。原生工具取得密碼的方式與手動執行原生傾印時相同。
  • 受損的任務檔案會被保留。 如果 dump-schedules.json 無法讀取時,「排程傾印」面板會顯示錯誤,且在你修復或移動檔案之前,SQLly 會拒絕覆寫它。面板每次開啟都會重新讀取檔案,所以修好後再回來看就會正常。

管理任務

設定 ▸ 工作區 ▸ 排程傾印 會列出每個任務及其連線、資料庫、任務類型、頻率、保留的檔案數、下一次執行時間與上次結果。每一列都有 立即執行, 編輯… (在排程編輯器中重新開啟它)、 複製 CLI 命令,而且 移除. 立即執行 會在狀態列告訴你某個任務已在執行中。在任務類型出現之前儲存的任務,會以內建 SQL 傾印的方式載入。

排程任務需要桌面應用程式。瀏覽器版本無法按排程寫入檔案。