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 使用而設計，確保嚴格滿足所有匯入契約。