mirror of https://github.com/abpframework/abp.git
maliming
7 years ago
committed by
GitHub
GitHub
1 changed files with 64 additions and 0 deletions
@ -0,0 +1,64 @@ |
|||||
|
# 连接字符串 |
||||
|
|
||||
|
ABP框架的设计是[模块化](Module-Development-Basics.md), [微服务兼容](Microservice-Architecture.md) 和 [多租户](Multi-Tenancy.md). 同时设计了连接字符串管理来支持这些场景; |
||||
|
|
||||
|
* 允许为每个模块设置单独的连接字符串,这样每个模块都可以有自己的物理数据库. 甚至可以将模块配置为使用不同的DBMS. |
||||
|
* 允许为每个租户设置单独的连接字符串使用单独的数据库(在SaaS应用程序中). |
||||
|
|
||||
|
它还支持混合场景; |
||||
|
|
||||
|
* 允许将模块分组到数据库 (所有的模块分组到一个共享数据库, 两个模块使用数据库A, 3个模块使用数据库B, 一个数据库使用数据库C其余的数据库使用数据库D...等.) |
||||
|
* 允许将租户分组到数据库中,像模块一样. |
||||
|
* 允许为每个租户每个模块分离数据库 (数据库过多会增加维护成本,但ABP框架支持这种需求). |
||||
|
|
||||
|
所有[预构建应用模块](Modules/Index.md)已设计为与以上场景兼容. |
||||
|
|
||||
|
## 配置连接字符串 |
||||
|
|
||||
|
参见以下配置: |
||||
|
|
||||
|
````json |
||||
|
"ConnectionStrings": { |
||||
|
"Default": "Server=localhost;Database=MyMainDb;Trusted_Connection=True;", |
||||
|
"AbpIdentityServer": "Server=localhost;Database=MyIdsDb;Trusted_Connection=True;", |
||||
|
"AbpPermissionManagement": "Server=localhost;Database=MyPermissionDb;Trusted_Connection=True;" |
||||
|
} |
||||
|
```` |
||||
|
|
||||
|
> ABP使用 `IConfiguration` 服务获取应用程序配置. 虽然在 `appsettings.json` 文件中写入配置是最简单的方法, 但它不仅限于此文件. 你可以使用环境变量, user secrets, Azure Key Vault... 等. 更多信息参阅 [配置](Configuration.md) 文档. |
||||
|
|
||||
|
以上配置定义了三个不同的连接字符串: |
||||
|
|
||||
|
* `MyMainDb` (`Default` 连接字符串)是应用程序的主连接字符串. 如果没有为模块指定连接字符串,则回退到 `Default` 连接字符串. [应用程序启动模板](Startup-Templates/Application.md) 配置为使用单个字符串, 所以所有的模块都使用单个数据库. |
||||
|
* `MyIdsDb` 由 [IdentityServer](Modules/IdentityServer.md) 模块使用. |
||||
|
* `MyPermissionDb` 由 [权限管理](Modules/Permission-Management.md) 模块使用. |
||||
|
|
||||
|
[预构建的应用程序模块](Modules/Index.md) 为连接字符串名称定义常量. 例如IdentityServer模块在 `AbpIdentityServerDbProperties` 类(位于 `Volo.Abp.IdentityServer` 命名空间)定义了 `ConnectionStringName` 常量 . 其他的模块类似的定义常量,你可以查看连接字符串的名称. |
||||
|
|
||||
|
## 设置连接字符串名称 |
||||
|
|
||||
|
模块通常使用 `ConnectionStringName` attribute 为 `DbContext` 类关联一个唯一的连接字符串名称. 示例: |
||||
|
|
||||
|
````csharp |
||||
|
[ConnectionStringName("AbpIdentityServer")] |
||||
|
public class IdentityServerDbContext |
||||
|
: AbpDbContext<IdentityServerDbContext>, IIdentityServerDbContext |
||||
|
{ |
||||
|
} |
||||
|
```` |
||||
|
|
||||
|
对于 [Entity Framework Core](Entity-Framework-Core.md) 和 [MongoDB](MongoDB.md), 写入到 `DbContext` 类 (和接口,如果有的话). |
||||
|
|
||||
|
> 如果你开发的是与数据库提供程序无关的可重用模块, 请参见 [最佳实践指南](Best-Practices/Index.md). |
||||
|
|
||||
|
## Entity Framework Core的数据库迁移 |
||||
|
|
||||
|
关系数据库需要在使用数据库之前创建数据库和数据库架构 (表, 视图...等). |
||||
|
|
||||
|
启动模板(使用 EF Core ORM) 带有一个数据库和一个 `.EntityFrameworkCore.DbMigrations` 项目,其中包含数据库的迁移文件. 该项目主要定义了一个*YourProjectName*MigrationsDbContext,它调用所有模块的 `Configure...()` 方法,例如 `builder.ConfigurePermissionManagement()`. |
||||
|
|
||||
|
一旦要分离模块的数据库,通常需要创建第二个迁移路径. 最简单的方法是创建一个带有 `DbContext` 的 `.EntityFrameworkCore.DbMigrations` 项目副本, 更改为只调用需要存储在第二个数据库中的模块的 `Configure...()` 方法并重新创建迁移. 这时你还需要更改 `.DbMigrator` 应用程序使其兼容第二个数据库,这样每个数据库将有一个单独的迁移DbContext. |
||||
|
|
||||
|
## 多租户 |
||||
|
|
||||
|
参阅 [多租户文档](Multi-Tenancy.md)了解如何为租户使用单独的数据库. |
||||
Loading…
Reference in new issue