实体框架
最后更新于
实体框架 (EF) 支持仍处于测试阶段,不适合生产型数据库。
实体框架 (EF) 是一个 ORM 框架,充当数据库的包装器。它允许我们支持多个(非 MSSQL)数据库,而无需为每个数据库维护迁移和查询脚本。
我们的 EF 实现目前支持 Postgres、MySQL 和 SQLite3。
这里的工作流程与普通的 MSSQL 实现大致相同:设置 docker 容器、配置用户机密,并按时间顺序针对相关数据库运行脚本文件夹中的脚本。
一个正常运行的本地开发服务器
Docker
一种在服务器项目中管理用户机密的方法 - 请参阅
数据库管理软件(参阅)
dotnet
cli
dotnet
cli
您可以配置多个数据库,并通过改变 globalSettings:databaseProvider
用户机密的值以在它们之间切换。您不需要删除您的连接字符串。
在您的服务器存储库的 dev
文件夹中,运行:
将以下值添加到您的 API、身份和管理员用户机密中。
请务必根据需要更改 root 密码等信息。如果您已经拥有这些机密,请确保更新现有的值,而不是创建一个新的值:
在 dev
文件夹中运行以下命令将数据库更新到最新的迁移:
migrate.ps1
中的 -postgres
标志将用于运行 dotnet ef
命令以执行迁移。
您还可以使用以下命令同时为所有数据库提供程序运行迁移:
如果您想验证一切工作是否正常:
检查数据库表以确保所有内容均已创建
使用 dotnet test
从您的服务器项目的根部运行集成测试。注意:这需要一个已配置好的 MSSQL 数据库。您可能还需要设置其他 EF 提供程序才能通过测试。
在您的 server/dev/secrets.json
文件中查找,或在 json 结构的根部添加此机密块:
此块用于为每个支持的提供程序类型测试数据库。集成测试将连接到这些数据库。如果尚未更新,则应更新这些连接字符串的密码,以使其与现有数据库相匹配。如果您的 server/dev/secrets.json
文件中根本没有这些设置,只需将其添加到底部即可。这些设置不会出现在 globalSettings
中。然后运行 pwsh setup_secrets.ps1 -clear
将其应用到本地项目。
将连接字符串应用到项目后:使用 pwsh server/dev/migrate.ps1 --all
确保数据库已全部迁移。然后就可以使用 dotnet test 从 test/Infrastructure.IntegrationTest
文件夹运行 EF 测试了。
将以下值添加到您的 API、身份和管理员用户机密中。注意,您必须设置数据源路径。使用在中选择的文件位置: