【ASP.NET Core】调用 Web API 备份数据库

摩卡金 發表於 2025-6-2 19:27:00

【ASP.NET Core】调用 Web API 备份数据库

老周不经意间翻了一下博客列表，上一篇水文竟然在一个月前。啊，大海啊，全是水；时间啊，你跑得真快！过了一个月老周竟没感觉出来，可是这一个月里，好像啥事也没干成，就改了一下几个旧项目。也许是现在大环境真的不好，新项目不好找。新的活有是有，比较简单，却很奇怪，比那货难的项目都做过，偏偏这货没头绪。这东西需求就是画图——是用程序来画图，类似甘特图。莫名其妙的是，这活会卡在窗口排版上。按照需求，这货窗口特多。点一下这里，弹一个对话框出来可以修改；点一下那里，又要弹一个出来允许修改；右键单击一下，弹出上百个选项的菜单（Check 模式），简直离谱，那么多指标项，我都怀疑他们老板根本不会去看的，但他们非要做全面。更闹心的是主窗口，想想现在的显示屏分辨率又高又大，一个窗口全屏放在那里，可上面又没几个控件，70% 的地方就是画进度图，每几秒刷新一下。虽然简单易用最好，但这窗口是看着空洞了一些。免得那些不懂编程的人说老周这项目根本没干啥活，老周还打算给它弄个高清《美少女战士》或《刘姥姥进大观园》当背景图，这样看起来就不空洞了。
今天咱们聊一个很单的主题，写一个 Web API，客户端可以调用它来备份 SQL Server 数据库。不知道大伙伴们有没有做过这活。相信做过的人会比老周更明白，毕竟，老熟人都知道，老周有两大弱项：SQL、汇编。汇编呢，是学生时代没好好学，想当年很轻松地就拿下了二级C++，偏就没学会汇编；而 SQL 呢，本来就学得一般，再加上用得少，忘得差不多了，所以别人给老周安排的项目基本不包括写 SQL 的，最终导致 SQL 方面越来越弱。
EF Core 不仅能用 LINQ 和实体类型配合操作，确实能让你在80%的情况下不用写SQL语句，但，为了灵活，EF Core 和早期 EF 和 ADO.NET 一样，是可以直接执行 SQL 语句的。这意味着，备份和还原数据库不在话下。
这个功能的实现并不难，但有两小坑，老周接下来会慢慢讲。
备份数据库用的是 BACKUP DATABASE 语句，比如这样
<div class="cnblogs_code">
<pre>BACKUP DATABASE <你的数据库名>
TO DISK = 'D:\backups\dbs.bak'</pre>
</div>
DISK 后的表达式不一定指定磁盘，更多时候是备份的文件名。如果还要备份日志，可以接着执行 BACKUP LOG 语句。
<div class="cnblogs_code">
<pre>BACKUP LOG <数据库名> TO DISK = 'E:\WrtMsn\oodo-log.bak'</pre>
</div>
如果要把备份放到另一台服务器上，可以用共享路径。
<div class="cnblogs_code">
<pre>BACKUP DATABASE <数据库名> TO DISK = '\\GaoXServer\shares\team\abc.bak'</pre>
</div>
这里就有第一个坑——权限，不管是你的程序进程还是 MSSQL 进程，有些目录是没有写入的权限的。比较懒的做法是在放置备份的目录上给个 everyone 的完全控制权限。老周不推荐这样，太不厚道了。若是不太好确定用哪个用户（毕竟有时候不一定是某个用户，而是系统服务），Windows 里面有一个好用的名称，叫 Authenticated Users，看字面意思就已经过验证的用户，就不是单指某个用户了。这个比 everyone 靠谱多了，起码匿名的不允许。
简单说说操作，在目录上右击，打开“属性”窗口，切换到“安全”页。点击下面的“高级”按钮。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602165332029-135338705.png" alt="" width="341" height="442" loading="lazy">
点击“添加”按钮。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602165431324-344405886.png" alt="" width="472" height="414" loading="lazy">
 点击“选择主体”，找到 Authenticated Users 并添加。最起码给予写入和修改权限。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602165645663-891005679.png" alt="" width="351" height="257" loading="lazy">
然后一路确定、应用即可。
============================================================================================
好了，理论知识完毕，下面可以动手了。
先建个库用来测试。这里老周建了个实体，名为 Movie，表示一部大片。
<div class="cnblogs_code">
<pre>public class Movie
{
/// <summary>
/// 编号
/// </summary>
public int Id { get; set; }
/// <summary>
/// 电影标题
/// </summary>
public string? Subject {get; set; }
/// <summary>
/// 导演是谁
/// </summary>
public string? Director {get; set; }
/// <summary>
/// 哪年上映的
/// </summary>
public int? Year { get; set; }
/// <summary>
/// 讲了啥故事
/// </summary>
public string? Desc {get; set; }
}</pre>
</div>
接下来写 DbContext。
<div class="cnblogs_code">
<pre>public class TestDBContext:DbContext
{
public TestDBContext(DbContextOptions<TestDBContext> options)
 : base(options)
{ }

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
 // 主键
 modelBuilder.Entity<Movie>().HasKey(x => x.Id);
 // 影片名为必填
 modelBuilder.Entity<Movie>().Property(x => x.Subject).IsRequired();
 // 填充初始数据
 modelBuilder.Entity<Movie>().ToTable("t_movies").HasData(
 new Movie { Id = 1, Subject = "狗二总裁", Year = 2026, Director = "大头苏", Desc = "二五仔二次创业的励志故事" },
new Movie { Id = 2, Subject = "子夜实验室", Year = 2025, Director = "丁小丁", Desc = "某大学的实验室总是在子夜时分莫名发生火灾，校方怀疑有人恶意纵火，于是，学校成立专项小组进行调查……" }
 );
 // 下面这行可以省略，Id 属性默认是自增长标识
 //modelBuilder.Entity<Movie>().Property(c => c.Id).ValueGeneratedOnAdd();
}

public DbSet<Movie> Movies { get; set; }
}</pre>
</div>
重写 OnModelCreating 方法是对模型做一些自定义设置，如果你只需保留默认，可以不重写此方法。由于表示主键的属性名为 Id，EF Core 会自动认为是主键，且启用自增长标识。上面代码老周用 ToTable 方法映射到的数据表名 t_movies。如果你要求表名和实体类名一样，那可以忽略。
另外，代码还调用了 HasData 方法，其用途是插入一些初始数据。如果你的数据表的初始状态允许空白，可以忽略。如果要插入种子数据（即初始数据），这里有第二个坑，一定要显式地指定 Id 属性的值，这里比较特殊。因为这是种子数据，必须保证每个字段的值是静态的，也就是说，不管你的程序在哪台机器上运行，得保证插入的数据是相同的。Id 字段虽然是自增长的，可你无法保证实际使用时数据库会从1开始增长，也不保证步长值一定是1。说不定人家是 100、101、102 呢。正因为如此，如果你忽略 Id 的值就会抛出异常。有一种方案就是使用负值，这个不如硬编码一个整数值保险一些。
完工后，要在 ASP.NET Core 应用程序的服务容器中注册。
<div class="cnblogs_code">
<pre>var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
// 配置数据库
string? connectionStr = builder.Configuration.GetConnectionString("prj_cns");
builder.Services.AddDbContext<TestDBContext>(ob =>
{
ob.UseSqlServer(connectionStr);
});
var app = builder.Build();</pre>
</div>
数据库的连接字符串在配置文件中（appsettings.json）。
<div class="cnblogs_code">
<pre>{
"Logging": {
……
}
},
"AllowedHosts": "*",
"ConnectionStrings": {
"prj_cns": "Data Source=.\\SQLTEST;Initial Catalog=Demo;Integrated Security=True;Persist Security Info=False;Pooling=False;Encrypt=True;Trust Server Certificate=True"
}
}</pre>
</div>
在配置文件中使用 ConnectionStrings 节点有特殊含义，把数据库连接字符串放在此节点下，代码中获取时可以简化一些。
<div class="cnblogs_code">
<pre>builder.Configuration.GetConnectionString("prj_cns");</pre>
</div>
就是 GetSection("ConnectionStrings")["prj_cns"] 的简化版。
======================================================================================
最后要实现的是 Web API。对于有明确的模块功能的代码我们尽量用 MVC Controller 去实现，Mini-API 只适合没啥模块化的简单代码，也避免把 Main 方法的代码搞得又长又臭。
<div class="cnblogs_code">
<pre>public class TestController : Controller
{
private readonly TestDBContext _db;
public TestController(TestDBContext db)
{
 _db = db;
}

public ActionResult Index()
{
 _db.Database.EnsureCreated();
 return View("~/Views/home.cshtml", _db.Movies.ToArray());
}

public async Task<JsonResult> NewData(Movie mvi)
{
 bool hasany = await _db.Movies.AnyAsync(m => m.Subject!.Equals(mvi.Subject));
 if(hasany)
 {
 return Json( new
 {
 Code = 2,
 Message = "此电影已存在"
 } );
 }
 await _db.Movies.AddAsync(mvi);
 int i = await _db.SaveChangesAsync();
 if(i <= 0)
 {
 return Json(new { Code = 3, Message = "添加失败" });
 }
 return Json(new
 {
 Code = 0,
 Message = "OK"
 });
}

public IEnumerable<Movie> GetAllMovies()
{
 return _db.Movies.ToArray();
}


public ActionResult Backup(string filename)
{
 // 取得当前目录
 IWebHostEnvironment env = HttpContext.RequestServices.GetRequiredService<IWebHostEnvironment>();
 string curDir = env.ContentRootPath;
 string bkfilePath = Path.Combine(curDir, filename);
 string dbname = _db.Database.GetDbConnection().Database;
 if (System.IO.File.Exists(bkfilePath))
 {
 System.IO.File.Delete(bkfilePath);
 }
 string sql = $"BACKUP DATABASE {dbname} TO DISK = '{bkfilePath}'";
 try
 {
 // 不必理会返回值
 _ = _db.Database.ExecuteSqlRaw(sql);
 }
 catch
 {
 return Json(new
 {
 Code = 1,
 Message = "备份失败"
 });
 }
 return Json(new
 {
 Code = 0,
 Message = "OK"
 });
}
}</pre>
</div>
其他代码你可以不看，重点关注 Backup 方法即可，这才是核心。数据上下文（我们从 DbContext 类派生了）有一个 Database 属性，可以对数据库进行额外的操作，比如 EnsureCreated 方法可以检查数据库是否存在，不存在就自动创建；EnsureDeleted 方法可以检查数据库是否已存在，若是，删除它；你还可以用 EnsureDeleted 方法启动一个事务。咱们用到的是 ExecuteSqlRaw 方法，它的功能是执行原始 SQL 语句。何谓“原始”？就是你给啥SQL就是啥，不做参数化处理，也不过滤SQL注入攻击。所以，这个方法你要在安全的情况下调用。本例的代码调用是安全的，因为只是执行 BACKUP 语句，客户端不能传入其他无关的数据——仅仅需要提供备份的文件名。出于安全考虑，你甚至可以不用客户端提供文件名，而是直接生成（用日期时间 + GUID 方式就行）。当然了，在实际使用中，你应该对 API 的调用做一下验证，比如，客户端必须传一个有效的 token 表明身份等。
由于执行 BACKUP 语句不属于常规的“增删改查”操作，无论执行成功还是失败，返回的整数值都是负值。因此，咱们不能依据返回的数值来判断是否备份成功。不过，倒可以用 try 语句块来简单判断。因为如果备份出错会抛异常。把 ExecuteSqlRaw 方法调用写在 try 语句块中，若抛异常，说明备份过程不顺利。
为了让客户端能方便管理数据维护，你还可以加一个 API，让客户端下载备份的文件。不过，如果操作的环境不够安全，或没有有效的安全措施，有泄露数据库的风险。
 
============================================================================================
本示例备份的文件是放在应用程序目录中的，所以，你得事先给程序目录设置一下权限，允许写入文件（参考前文）。这是为了程序部署方便，如果服务器环境允许，可以在服务器上选择一个专用的目录来存放备份。可以把路径配置到 appsettings.json 文件中，程序中直接读取，这样你在部署项目后可以手动在 appsettings.json 文件中编辑正确的目录。
<div class="cnblogs_code">
<pre>{
……
"AllowedHosts": "*",
"ConnectionStrings": {
……
},
"backup_dir": "D:\\backups"
}</pre>
</div>
修改程序代码，从 backup_dir 配置项读取目录。
<div class="cnblogs_code">
<pre> // 取得当前目录
IWebHostEnvironment env = HttpContext.RequestServices.GetRequiredService<IWebHostEnvironment>();
// 读取配置
IConfiguration config = HttpContext.RequestServices.GetRequiredService<IConfiguration>();
// 如果找不到配置的目录，那就放在应用程序目录下
string bkfilePath = Path.Combine(bkDir, filename);
string dbname = _db.Database.GetDbConnection().Database;
if (System.IO.File.Exists(bkfilePath))
{
 System.IO.File.Delete(bkfilePath);
}
string sql = $"BACKUP DATABASE {dbname} TO DISK = '{bkfilePath}'";

……</pre>
</div>
你不能保证配置 backup_dir 一定有效，如果没有配置，就把备份文件放在应用程序目录下。
在运行程序后，你要访问一次根 URL（/），目的是让 EF Core 自动创建数据库。如果在 VS 中调试运行，默认会自动打浏览器的。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602183736696-1639902785.png" alt="" width="264" height="199" loading="lazy">
创建的数据库如下：
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602183932227-1436186209.png" alt="" width="255" height="281" loading="lazy">
现在，你可以用任何方式，任何 API 测试工具来验证一下，能不能备份。不想用第三方工具，可以用.NET 官方的 httprepl 工具，安装命令：
<div class="cnblogs_code">
<pre>dotnet tool install -g microsoft.dotnet-httprepl</pre>
</div>
安装好后，在 cmd 中直接输入 httprepl 就能进入对话状态。是的，交互式的。
为了后面在 POST JSON 数据时方便编辑，咱们设置一个默认的文本编译器。免得折腾，你可以直接用 VS Code。
<div class="cnblogs_code">
<pre> pref set editor.command.default "C:\Users\Admin\Softs\VSCode\Code.exe"
pref set editor.command.default.argument "-w"</pre>
</div>
第一条命令是设置 VS Code 的路径，注意，是 VSC 的可执行文件路径。
第二条命令是设置命令行参数 -w，此参数是让 VSC 等待打开的文件顺利保存并关闭才退出进程。因为 httprepl 工具在启动 VSC 时会创建一个临时文件，并让 VSC 打开来编辑。
好，现在咱们测试。
1、运行示例程序。
2、CMD中进入 httprepl 会话。
3、连接根URL。
<div class="cnblogs_code">
<pre>connect http://localhost:5276</pre>
</div>
4、调用 /demo/backup 接口。
<div class="cnblogs_code">
<pre>post /demo/backup -h content-type=application/json</pre>
</div>
-h 指定HTTP头。
5、此时，VSC 会启动，我们编辑一下。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602190537264-1578441187.png" alt="" width="253" height="83" loading="lazy">
注意这里，不用输入大括号，直接输入 Javascript 字符串就行，因为 filename 参数不是复杂对象，而是一个基础类型。
6、保存，关闭 VSC。
7、回到 CMD 窗口，就会看到备份成功的响应。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602190945616-45215752.png" alt="" width="350" height="144" loading="lazy">
到备份目录下，就能看到刚备份的文件了。大小约 3.46 MB 。
要验证备份是否真有效，可以把这个文件还原回 SQL Server，如果还原后，看到数据，说明备份是没有问题的。
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602192407115-1575396025.png" alt="" width="447" height="390" loading="lazy">
<img src="https://img2024.cnblogs.com/blog/367389/202506/367389-20250602192533394-86793248.png" alt="" width="528" height="264" loading="lazy">
 好了，今天就水到这里了。 
来源：https://www.cnblogs.com/tcjiaan/p/18907380

頁: [1]

琼殿技术论坛's Archiver

【ASP.NET Core】调用 Web API 备份数据库