实体框架
对应的官方页面地址
实体框架 (EF) 支持仍处于测试阶段，不适合生产型数据库。
本页面指的是建立一个 Bitwarden 实例来进行开发，如需了解如何测试个人使用的 EF 部署（例如 Bitwarden Unified），请参阅帮助文档。
背景
实体框架 (EF) 是一个 ORM 框架，充当数据库的包装器。它允许我们支持多个（非 MSSQL）数据库，而无需为每个数据库维护迁移和查询脚本。
我们的 EF 实现目前支持 Postgres、MySQL 和 SQLite3。
设置 EF 数据库
这里的工作流程与普通的 MSSQL 实现大致相同：设置 docker 容器、配置用户机密，并按时间顺序针对相关数据库运行脚本文件夹中的脚本。
要求
您可以配置多个数据库，并通过改变 globalSettings:databaseProvider 用户机密的值以在它们之间切换。您不需要删除您的连接字符串。
数据库设置
在您的服务器存储库的 dev 文件夹中，运行：
在您的服务器存储库的 dev 文件夹中，运行：
选择数据库文件的位置。您可以使用服务器存储库的 dev 文件夹，为此目的，git 配置为忽略此存储库中的 .db 文件。
用户机密
将以下值添加到您的 API、身份和管理员用户机密中。
请务必根据需要更改 root 密码等信息。如果您已经拥有这些机密，请确保更新现有的值，而不是创建一个新的值：
请务必根据需要更改 root 密码等信息。如果您已经拥有这些机密，请确保更新现有的值，而不是创建一个新的值：
将以下值添加到您的 API、身份和管理员用户机密中。注意，您必须设置数据源路径。使用在数据库设置中选择的文件位置：
更改 secrets.json 文件后，记得运行 pwsh setup_secrets.ps1 -clear 使更改生效。
迁移
在 dev 文件夹中运行以下命令将数据库更新到最新的迁移：
migrate.ps1 中的 -postgres 标志将用于运行 dotnet ef 命令以执行迁移。
您还可以使用以下命令同时为所有数据库提供程序运行迁移：
在 dev 文件夹中运行以下命令将数据库更新到最新的迁移：
migrate.ps1 中的 -mysql 标志将用于运行 dotnet ef 命令以执行迁移。
您还可以使用以下命令同时为所有数据库提供程序运行迁移：
在 dev 文件夹中运行以下命令将数据库更新到最新的迁移：
migrate.ps1 中的 -sqlite 标志将用于运行 dotnet ef 命令以执行迁移。
您还可以使用以下命令同时为所有数据库提供程序运行迁移：
验证（可选）
如果您想验证一切工作是否正常：
检查数据库表以确保所有内容均已创建
使用
dotnet test从您的服务器项目的根部运行集成测试。注意：这需要一个已配置好的 MSSQL 数据库。您可能还需要设置其他 EF 提供程序才能通过测试。
测试 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 测试了。
最后更新于