Skip to content
使用指南

存储模式

对比文件存储与数据库存储,了解支持的数据库、连接配置、表结构与切换方式。

更新于 2026-11-17MIT 开源

存储模式 ​

1. 两种模式 ​

维度文件存储数据库存储
依赖无对应 NuGet 驱动包 + 数据库
配置零配置连接字符串 + Provider
数据位置App_Data/QuartzJobs/ 下的 JSONquartz_* 表
适用规模单机、轻量应用中大型、生产环境
多实例共享不支持支持
备份直接复制目录数据库备份
迁移可迁移到任意数据库可迁移到文件或其他数据库

两种模式共用同一套 API 与管理界面,切换时不需要修改业务代码。

2. 文件存储 ​

2.1 配置 ​

json
{
  "QuartzUI": {
    "StorageType": "File",
    "FileStoragePath": "App_Data/QuartzJobs",
    "JwtSecret": "...",
    "UserName": "Admin",
    "Password": "123456"
  }
}

StorageType 省略时默认为文件存储。

2.2 数据文件 ​

text
App_Data/QuartzJobs/
├── jobs.json           # 作业定义与状态
├── logs.json           # 执行日志
├── notifications.json  # 通知历史
└── settings.json       # 系统设置
  • 首次启动自动创建目录与文件;
  • 升级版本时自动兼容旧数据,新增字段默认为空;
  • 迁移前建议先停止应用并备份整个目录。

2.3 适用建议 ​

  • 单体应用、任务量不大;
  • 想零依赖快速验证或内部工具;
  • 可以接受「单实例写入」的约束。

如果在多实例 / 容器多副本环境中共用同一个文件目录,可能出现并发写入冲突,此时应使用数据库存储或为每个实例配置独立目录。

3. 数据库存储 ​

3.1 安装驱动 ​

数据库NuGet 包DatabaseProvider
MySQLChet.QuartzNet.EFCore.MySQLmysql
PostgreSQLChet.QuartzNet.EFCore.PostgreSQLpostgresql
SQL ServerChet.QuartzNet.EFCore.SqlServersqlserver
SQLiteChet.QuartzNet.EFCore.SQLitesqlite
bash
dotnet add package Chet.QuartzNet.EFCore.SQLite

3.2 配置示例 ​

json
{
  "ConnectionStrings": {
    "QuartzUI": "Server=localhost;Database=quartzui;User=root;Password=123456;"
  },
  "QuartzUI": {
    "StorageType": "Database",
    "DatabaseProvider": "mysql"
  }
}
json
{
  "ConnectionStrings": {
    "QuartzUI": "Host=localhost;Port=5432;Database=quartzui;Username=postgres;Password=123456;"
  },
  "QuartzUI": {
    "StorageType": "Database",
    "DatabaseProvider": "postgresql"
  }
}
json
{
  "ConnectionStrings": {
    "QuartzUI": "Data Source=localhost;Initial Catalog=quartzui;User Id=sa;Password=123456;TrustServerCertificate=true;"
  },
  "QuartzUI": {
    "StorageType": "Database",
    "DatabaseProvider": "sqlserver"
  }
}
json
{
  "ConnectionStrings": {
    "QuartzUI": "Data Source=quartzui.db"
  },
  "QuartzUI": {
    "StorageType": "Database",
    "DatabaseProvider": "sqlite"
  }
}

3.3 表结构 ​

表名说明
quartz_jobs作业定义、Cron、状态、依赖、重试与并发配置
quartz_job_logs作业执行日志与结果
quartz_settings系统设置(键值)
quartz_notifications通知发送历史

数据库表由 EF Core 迁移自动创建与升级。升级 NuGet 包后,如包含结构变更,需要执行:

bash
dotnet ef database update

数据库结构变更通常由 EFCore 扩展包提供。升级主包时请同步升级对应扩展包,否则新增字段可能写入失败。

3.4 适用建议 ​

  • 生产环境或任务量较大;
  • 需要多实例共享同一份作业数据;
  • 已有数据库运维体系(备份、监控、权限);
  • 希望后续在不同数据库之间迁移。

4. 如何在两种模式间切换 ​

推荐使用内置的数据迁移功能,而不是手工拷贝数据:

  1. 安装目标数据库驱动包;
  2. 在 QuartzUI:Migration 中配置目标数据库配置档(或直接使用当前数据库);
  3. 打开「系统配置 → 数据迁移」,选择源与目标,先执行预检;
  4. 选择写入模式(合并 / 覆盖 / 替换)后开始迁移;
  5. 迁移完成后按提示修改 StorageType、DatabaseProvider 与连接字符串并重启。

详见 数据迁移。

让 Quartz.Net 调度,从未如此简单