# Neon Postgres

> Padrões especializados para Postgres serverless Neon, branching, connection pooling e integração Prisma/Drizzle Use quando: banco Neon, postgres serverless, database branching, neon postgres, postgres serverless.

- Skill: `artubss/neon-postgres` (Agent Skill)
- Install (CLI): `npx skillmds@latest add artubss/neon-postgres`
- Raw SKILL.md: https://api.skillmd.com/api/skills/artubss/neon-postgres/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: artubss (https://skillmd.com/u/artubss)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/artubss/neon-postgres

---


# Neon Postgres

## Padrões

### Prisma com Conexão Neon

Configure o Prisma para Neon com connection pooling.

Use duas connection strings:
- DATABASE_URL: Conexão pooled para o Prisma Client
- DIRECT_URL: Conexão direta para Prisma Migrate

A conexão pooled usa PgBouncer para até 10K conexões.
Conexão direta necessária para migrações (operações DDL).


### Drizzle com Neon Serverless Driver

Use Drizzle ORM com o driver HTTP serverless do Neon para
ambientes edge/serverless.

Duas opções de driver:
- neon-http: Consultas únicas via HTTP (mais rápido para queries pontuais)
- neon-serverless: WebSocket para transações e sessões


### Connection Pooling com PgBouncer

Neon fornece connection pooling integrado via PgBouncer.

Limites principais:
- Até 10.000 conexões simultâneas para o pooler
- Conexões ainda consomem conexões Postgres subjacentes
- 7 conexões reservadas para superuser Neon

Use endpoint pooled para aplicação, direto para migrações.


## ⚠️ Casos Problemáticos

| Problema | Severidade | Solução |
|----------|-----------|---------|
| Problema | alta | Veja documentação |
| Problema | alta | Veja documentação |
| Problema | alta | Veja documentação |
| Problema | média | Veja documentação |
| Problema | média | Veja documentação |
| Problema | baixa | Veja documentação |
| Problema | média | Veja documentação |
| Problema | alta | Veja documentação |