neon-postgres
Wzorce eksperckie dla Neon Postgres: pooling, branching i integracja z Prisma/Drizzle
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill zawiera gotowe wzorce konfiguracji dla Neon serverless Postgres. Dowiesz się, jak prawidłowo skonfigurować connection pooling z PgBouncer, zintegrować Prisma Client z pooled connection oraz Direct URL dla migracji, a także użyć Drizzle ORM z driverem HTTP lub WebSocket. Materiał obejmuje ograniczenia (do 10K połączeń), rozróżnienie między pooled endpoint (dla aplikacji) a direct endpoint (dla DDL), oraz najczęstsze problemy przy pracy z bazami serverless.
Jak używać
Zainstaluj skill neon-postgres w swoim projekcie Claude/Copilot, aby uzyskać dostęp do wzorców konfiguracji Neon Postgres.
Dla Prisma: skonfiguruj dwie zmienne środowiskowe — DATABASE_URL (pooled connection dla Prisma Client) i DIRECT_URL (direct connection dla Prisma Migrate). Pooled connection wykorzystuje PgBouncer i obsługuje do 10K równoczesnych połączeń.
Dla Drizzle ORM: wybierz odpowiedni driver w zależności od przypadku użycia — neon-http dla pojedynczych zapytań w środowisku edge/serverless, lub neon-serverless dla transakcji i sesji wymagających WebSocket.
Pamiętaj o ograniczeniach poolingu: maksymalnie 10K połączeń do poolera, każde połączenie konsumuje underlying Postgres connection, a 7 połączeń jest zarezerwowanych dla superusera Neon.
Zawsze używaj pooled endpoint dla aplikacji (Prisma Client, Drizzle queries), a direct endpoint wyłącznie dla operacji DDL (migracje, zmiany schematu).
Zapoznaj się z sekcją Sharp Edges w dokumentacji, aby uniknąć typowych problemów przy pracy z serverless Postgres.