【要約】Supabase の IPv6 制約と自動 pause：Session Pooler で解決する接続問題 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者が、しばらく利用していなかったSupabaseプロジェクトに接続できない問題に直面する。主な原因は以下の2点に集約される。
- ・7日間の無アクセスによるプロジェクトの自動pause
- ・Direct ConnectionがIPv6のみに対応しており、IPv4環境から接続できないこと
// Approach
接続不能な状態を解消するため、接続方式をSession Poolerへ切り替える。具体的な手順は以下の通りだ。
- ・接続文字列のエンドポイントをSession Poolerのものに変更する
- ・ユーザー名を
postgres.{project_id}形式に修正する - ・PgBouncerのsession modeを利用し、IPv4接続を確保する
// Result
Session Poolerへの切り替えにより、接続の安定性と互換性が向上する。得られる効果は以下の通りだ。
- ・IPv4のみのISP環境からもSupabaseへ接続可能になる
- ・Session modeの利用により、プリペアドステートメントが維持できる
- ・リトライ処理の実装により、pause復旧時の接続失敗を軽減できる
Senior Engineer Insight
> Supabaseの無料プラン運用には、ネットワーク制約とライフサイクル管理の理解が不可欠だ。IPv4環境が主流の現状では、Session Poolerの利用は必須と言える。ただし、Session Poolerは接続数に上限があるため、スケーラビリティには限界がある。本番環境への適用時は、接続数監視と、Transaction Poolerへの移行を見据えた設計が必要だ。