configuring-connection-pools

此技能為配置 Prisma Client 連線池提供自動化指引，確保應用程式在不同的基礎架構需求下維持穩定的資料庫效能。它專為在生產環境中部署應用程式的軟體工程師與 DevOps 從業人員設計，涵蓋從傳統伺服器到如 AWS Lambda、Vercel 或 Netlify 等水平擴展的無伺服器函式。透過應用基於 CPU 核心數與執行個體擴展策略的特定計算公式，該技能有助於在資源利用率與資料庫容量之間找到最佳平衡點。

• 根據 CPU 核心數計算精確的 connection_limit 值，在不超載資料庫的前提下實現吞吐量最大化。

• 提供針對傳統伺服器、無伺服器架構與容器化部署的環境特定配置。

• 提供診斷步驟，用於識別並解決 P1017 錯誤（連線池逾時）與一般連線池耗盡問題。

• 為需要事務模式連線池的高併發環境提供如 PgBouncer 等外部連線池工具的配置方案。

• 自動化整合可觀測性功能，例如指標回報與查詢記錄，以實時監控連線池健康狀況。

• 支援 PostgreSQL 環境內 SQL 查詢延遲與連線追蹤的除錯模式。

• 輸入包含環境詳細資訊、CPU 規格與目前的 DATABASE_URL 設定。輸出為優化的連線字串參數與 schema.prisma 檔案的配置程式碼片段。

• 當遇到資料庫連線錯誤、高流量期間的效能延遲，或在遷移至無伺服器執行環境時，建議使用這些設定。

• 限制事項包含需根據資料庫 max_connections 上限進行手動調整，並需了解使用 PgBouncer 時的限制，例如對預編譯語句或諮詢鎖的限制。

• 最佳實踐強調在無伺服器環境中使用較低的 pool_timeout 值以實現快速失敗，從而防止 Lambda 函式中出現連鎖逾時反應。