prisma-driver-adapter-implementation

此技能作为开发自定义 Prisma ORM v7 驱动程序适配器 (driver adapter) 的权威技术参考。它提供了将数据库驱动程序与 PrismaClient 通过 SqlMigrationAwareDriverAdapterFactory 桥接的底层架构指引。指令集详述了 SqlDriverAdapter 与 Transaction 等强制接口的实现方式，确保查询执行、事务生命周期与数据库特定元数据处理的正确性。此技能专为系统工程师与库作者设计，对于扩展 Prisma 以支持专有或小众 SQL 数据库至关重要。

• 完整涵盖 SqlDriverAdapter 与 Transaction 接口的实现，包含原始查询执行与连接管理。

• 提供 SqlQuery、SqlResultSet 与 ColumnTypeEnum 的详细规格，确保 SQL 驱动程序与 Prisma 客户端运行时之间的二进制兼容类型映射。

• 提供事务生命周期协议指南，涵盖 startTransaction、commit 与 rollback 序列。

• 错误处理策略，包含将原生数据库错误转换为标准化的 MappedError 与 DriverAdapterError 类型。

• 验证与测试清单，用于验证适配器是否符合 Prisma 运行时契约。

• 在实现新的 SqlDriverAdapter 或修改生产级应用程序的内部驱动程序适配器行为时，请使用此技能。

• 确保所有 ArgType 定义皆正确传递至 SqlQuery，以防止序列化失败或非预期的运行时类型强制转换。

• 遵循提供的架构图，正确构建您的适配器工厂，并在事务执行期间维持适当的隔离级别。

• 特别注意 SqlResultSet 中的列元数据映射需求，以避免 Prisma 引擎中发生运行时解析错误。

• 专为搭配 @prisma/driver-adapter-utils 使用而设计，确保严格满足所有导入契约。