database-driver-design

本技能為開發高效能 Swift 資料庫用戶端程式庫的工程師提供專業架構指導。重點在於網路傳輸、型別安全 API 設計與並行處理的整合，並運用 valkey-swift 和 postgres-nio 等函式庫中成熟的模式。目標是協助開發者超越簡單的封裝，進而建置穩定、低延遲且記憶體安全的生產級伺服器端實作。

• 實作自訂網路通訊協定解析器與序列化器以降低延遲。

• 使用明確的狀態機管理連線生命週期，防止死結與競爭條件。

• 設計非阻塞 IO (NIO) 通道處理器，實現高效的資料庫通訊。

• 使用 unownedExecutor 優化 Actor 與 Event Loop 的對齊，消除不必要的執行緒切換。

• 建置支援背壓控制 (Backpressure) 的串流系統，防止大數據集造成的記憶體耗盡。

• 透過編譯時期型別檢查與 ExpressibleByStringInterpolation 來強制執行參數化查詢，防止 SQL 注入。

• 設計「命令作為型別」(Command-as-Type) 的架構，提升 API 人體工學與回傳型別安全性。

• 目標對象：後端工程師、基礎設施函式庫維護者以及 Swift 伺服器端開發者。

• 典型應用場景：建立新的資料庫驅動程式 (NoSQL 或 SQL)、開發 ORM 底層協定，或優化現有的 NIO 資料庫整合。

• 輸入需求：資料庫規格文件、通訊協定定義 (如長度前綴二進位格式) 與吞吐量/延遲效能目標。

• 實務限制：務必優先採用型別安全模式而非基於字串的動態程式碼。確保與 Swift 6 結構化並行處理保持一致，並確保所有狀態管理皆具備 Sendable 屬性。處理 NIO 緩衝區時，應優先考量零複製 (Zero-copy) 作業與明確的記憶體生命週期管理。