连接字符串
- 允许为每个模块设置单独的连接字符串,这样每个模块都可以有自己的物理数据库. 甚至可以将模块配置为使用不同的DBMS.
- 允许为每个租户设置单独的连接字符串使用单独的数据库(在SaaS应用程序中).
它还支持混合场景;
- 允许将模块分组到数据库 (所有的模块分组到一个共享数据库, 两个模块使用数据库A, 3个模块使用数据库B, 一个数据库使用数据库C其余的数据库使用数据库D…等.)
- 允许为每个租户每个模块分离数据库 (数据库过多会增加维护成本,但ABP框架支持这种需求).
所有预构建应用模块已设计为与以上场景兼容.
参见以下配置:
MyMainDb
(Default
连接字符串)是应用程序的主连接字符串. 如果没有为模块指定连接字符串,则回退到Default
连接字符串. 配置为使用单个字符串, 所以所有的模块都使用单个数据库.MyIdsDb
由 IdentityServer 模块使用.MyPermissionDb
由 模块使用.
预构建的应用程序模块 为连接字符串名称定义常量. 例如IdentityServer模块在 AbpIdentityServerDbProperties
类(位于 Volo.Abp.IdentityServer
命名空间)定义了 常量 . 其他的模块类似的定义常量,你可以查看连接字符串的名称.
ABP实际上使用 AbpDbConnectionOptions
获取连接字符串. 如果如上所述设置了连接字符串, AbpDbConnectionOptions
会被自动填充. 但是你也可以使用设置或覆盖连接字符串. 你可以在模块的 ConfigureServices
方法配置AbpDbConnectionOptions
). 如下所示:
模块通常使用 ConnectionStringName
attribute 为 DbContext
类关联一个唯一的连接字符串名称. 示例:
对于 和 MongoDB, 写入到 DbContext
类 (和接口,如果有的话).
关系数据库需要在使用数据库之前创建数据库和数据库架构 (表, 视图…等).
启动模板(使用 EF Core ORM) 带有一个数据库和一个 .EntityFrameworkCore.DbMigrations
项目,其中包含数据库的迁移文件. 该项目主要定义了一个YourProjectNameMigrationsDbContext,它调用所有模块的 方法,例如 builder.ConfigurePermissionManagement()
.
一旦要分离模块的数据库,通常需要创建第二个迁移路径. 请参阅了解如何为所需模块创建和使用其他数据库.
参阅 多租户文档了解如何为租户使用单独的数据库.
MultiTenantConnectionStringResolver
用于多租户应用程序,并尝试获取当前租户的已配置连接字符串(如果有). 它使用ITenantStore
查找连接字符串. 它继承了DefaultConnectionStringResolver
, 如果没有为当前租户指定连接字符串则回退到基本逻辑.
如果需要自定义逻辑来确定连接字符串,可以实现 IConnectionStringResolver
接口(也可以从现有类派生)并使用系统替换现有实现.