计划任务

功能的

在 SQLly 打开时,可按计划运行内置转储、本地备份和已保存查询导出。

SQLly 可以按每小时、每天或每周的节奏运行三种任务: 内置 SQL 转储、 原生备份 与 pg_dump 或者 mysqldump,或者一个 查询导出 会运行 SQL 库中保存的查询,并把结果写入 CSV 或 JSON Lines 文件。要添加一个,请运行 计划任务(转储、备份或查询导出)… 从命令面板打开,或点击 添加… 在“设置 ▸ 工作区 ▸ 计划转储”中。选择数据库和任务,然后设置输出文件夹、执行频率和要保留的文件数。

每个任务都会写入一个 输出文件夹,从来不会只写一个文件:每次运行都会在这里新增一个带时间戳的文件,第一次运行时如果文件夹不存在会自动创建。 选择… 打开一个文件夹选择器。默认是你主文件夹中的一个 SQLLY Backups 文件夹,位于你的主目录下。

任务引擎每次运行写入的内容
内置 SQL 转储所有支持转储的引擎<db>_<id>_<stamp>.sql,或者按对象分文件导出时用同名文件夹。内容、DROP IF EXISTS、批量大小和要包含哪些对象类型,都和“导出数据库为 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 转储。

计划任务需要桌面版。浏览器版无法按计划写入文件。