EF Core 基础知识

数据库连接字符串

在 ASP.NET Core 添加配置片段:

{
  "ConnectionStrings": {
    "BloggingDatabase": "Server=(localdb)\\mssqllocaldb;Database=EFGetStarted.ConsoleApp.NewDb;Trusted_Connection=True;"
  }
}

然后,配置对应的DbContext:

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext(options =>
        options.UseSqlServer(Configuration.GetConnectionString("BloggingDatabase")));
}

日志记录

EF Core 默认会与 ASP.NET Core的日志提供程序一起工作,只需要使用AddDbContextAddDbContextPool添加服务即可。

除此之外,还可以手工添加日志记录。

首先,创建LoggerFactory的单例:

public static readonly LoggerFactory MyLoggerFactory
    = new LoggerFactory(new[] {new ConsoleLoggerProvider((_, __) => true, true)});

然后,通过DbContextOptionsBuilder注册此单例:

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    => optionsBuilder
        .UseLoggerFactory(MyLoggerFactory) // Warning: Do not create a new ILoggerFactory instance each time
        .UseSqlServer(
            @"Server=(localdb)\mssqllocaldb;Database=EFLogging;Trusted_Connection=True;ConnectRetryCount=0");

如果你只想记录想要的日志,例如数据操作语句,可以在ILoggerProvider中进行配置:

public static readonly LoggerFactory MyLoggerFactory
    = new LoggerFactory(new[]
    {
        new ConsoleLoggerProvider((category, level)
            => category == DbLoggerCategory.Database.Command.Name
               && level == LogLevel.Information, true)
    });

配置弹性连接

EF Core 可以根据不同的数据库失败,制定不同的执行策略,例如故障自动重试等。

针对SQL Server,它知道可以重试的异常类型,并且具有合理的默认值的最大重试,重试次数等之间的延迟。

配置如下:

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseSqlServer(
            @"Server=(localdb)\mssqllocaldb;Database=EFMiscellanous.ConnectionResiliency;Trusted_Connection=True;ConnectRetryCount=0",
            options => options.EnableRetryOnFailure());
}

也可在Startup中配置:

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext(
        options => options.UseSqlServer(
            "",
            providerOptions => providerOptions.EnableRetryOnFailure()));
}

你也可以自定义执行策略:

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseMyProvider(
            "",
            options => options.ExecutionStrategy(...));
}

自动重试与事物

对于执行自动重试策略来说,每一次调用context.SaveChanges()方法将会当做一个重试单元。如果你的事物中有多个SaveChanges操作,配置的自动重试策略将会抛出异常,解决方法是使用委托来手动调用执行策略。代码如下:

using (var db = new BloggingContext())
{
    var strategy = db.Database.CreateExecutionStrategy();

    strategy.Execute(() =>
    {
        using (var context = new BloggingContext())
        {
            using (var transaction = context.Database.BeginTransaction())
            {
                context.Blogs.Add(new Blog {Url = "http://blogs.msdn.com/dotnet"});
                context.SaveChanges();

                context.Blogs.Add(new Blog {Url = "http://blogs.msdn.com/visualstudio"});
                context.SaveChanges();

                transaction.Commit();
            }
        }
    });
}

此方法同样适用于环境事物:

using (var context1 = new BloggingContext())
{
    context1.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/visualstudio" });

    var strategy = context1.Database.CreateExecutionStrategy();

    strategy.Execute(() =>
    {
        using (var context2 = new BloggingContext())
        {
            using (var transaction = new TransactionScope())
            {
                context2.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
                context2.SaveChanges();

                context1.SaveChanges();

                transaction.Complete();
            }
        }
    });
}

自动重试策略需要考虑幂等性问题,防止数据添加重复等误操作。EF Core 引入了一种状态检查机制,可以帮助我们实现是否执行成功的检测:

using (var db = new BloggingContext())
{
    var strategy = db.Database.CreateExecutionStrategy();

    var blogToAdd = new Blog {Url = "http://blogs.msdn.com/dotnet"};
    db.Blogs.Add(blogToAdd);

    strategy.ExecuteInTransaction(db,
        operation: context =>
        {
            context.SaveChanges(acceptAllChangesOnSuccess: false);
        },
        verifySucceeded: context => context.Blogs.AsNoTracking().Any(b => b.BlogId == blogToAdd.BlogId));

    db.ChangeTracker.AcceptAllChanges();
}

DbContext配置项

DbContext必须有DbContextOptions实例能,Options的作用如下:

  • 配置数据库提供程序
  • 连接字符串
  • 数据库提供程序级别的可选项
  • EF Core级别的可选项

可以通过构造函数添加Options:

public class BloggingContext : DbContext
{
    public BloggingContext(DbContextOptions options)
        : base(options)
    { }

    public DbSet Blogs { get; set; }
}

也可以通过OnConfiguring方法进行配置:

public class BloggingContext : DbContext
{
    public DbSet Blogs { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlite("Data Source=blog.db");
    }
}

使用依赖注入DbContext时,需要构造函数的方式进行配置,并在Startup中配置DbContext:

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext(options => options.UseSqlite("Data Source=blog.db"));
}

避免多线程操作

EF Core 提供了async/await操作,但是这是一个语法糖,它并不支持并行操作,这是由于数据库连接的特性限制的,因此我们应避免针对同一个Context执行任何并行操作。

参考文档

参考微软 EF Core 使用文档,详情:

  • https://docs.microsoft.com/zh-cn/ef/core/miscellaneous/connection-strings
  • https://docs.microsoft.com/zh-cn/ef/core/miscellaneous/logging
  • https://docs.microsoft.com/zh-cn/ef/core/miscellaneous/connection-resiliency
  • https://docs.microsoft.com/zh-cn/ef/core/miscellaneous/configuring-dbcontext

你可能感兴趣的:(EF Core 基础知识)