neon-postgres について
Neon Postgres を Prisma や Drizzle と使う開発者向けの設定スキルです。接続プールの利用方法と、アプリケーションおよびマイグレーションで接続方式を分ける方法を説明します。
主な機能
- 01Prisma の接続プール設定
- 02Drizzle のサーバーレスドライバー利用
- 03プール接続と直接接続の使い分け
- 04PgBouncer のプール制限の説明
活用シーン
- 01Prisma アプリケーションで Neon を設定
- 02エッジまたはサーバーレス環境で Drizzle を利用
- 03マイグレーション用の直接接続を設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/neon-postgresを入力して読み込まれたか確認します。
詳細
Neon Postgres
パターン
Neon 接続を使用した Prisma
接続プーリングを使用して Prisma を Neon 向けに設定します。
2 つの接続文字列を使用します:
- DATABASE_URL: Prisma Client 用のプール接続
- DIRECT_URL: Prisma Migrate 用の直接接続
プール接続は PgBouncer を使用し、最大 10K 接続に対応します。 マイグレーション（DDL 操作）には直接接続が必要です。
Neon サーバーレスドライバーを使用した Drizzle
エッジ/サーバーレス環境向けに、Neon のサーバーレス HTTP ドライバーを使用して Drizzle ORM を利用します。
ドライバーのオプションは 2 つあります:
- neon-http: HTTP 経由の単一クエリ（単発のクエリに最も高速）
- neon-serverless: トランザクションとセッション向けの WebSocket
PgBouncer による接続プーリング
Neon は PgBouncer による組み込みの接続プーリングを提供します。
主な制限:
- プーラーへの同時接続は最大 10,000 件
- 接続は依然として基盤の Postgres 接続を消費します
- Neon スーパーユーザー用に 7 件の接続が予約されています
アプリケーションにはプール用エンドポイント、マイグレーションには直接接続用エンドポイントを使用します。
⚠️ 注意すべき点
| Issue | Severity | Solution |
|---|---|---|
| Issue | high | See docs |
| Issue | high | See docs |
| Issue | high | See docs |
| Issue | medium | See docs |
| Issue | medium | See docs |
| Issue | low | See docs |
| Issue | medium | See docs |
| Issue | high | See docs |
コメント
Markdown 対応