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 函数中出现连锁超时反应。