接続する スーパーベース Excel、Google Sheets、AI、RESTへ

3つの侵入方法、どれを選ぶべきか

Supabaseは直接接続と2つのプーラーエンドポイントを提供しており、どちらを選択するかは見た目以上に重要です。エージェントはホストとポートから指定されたエンドポイントを認識し、それに応じて動作します。

• セッションプーラー — pooler.supabase.com ホストのポート 5432。デフォルト設定であり、推奨設定でもあります。なぜなら、セッションモードのプーラーは、まさに長時間接続を維持するために設計されているからです。
• トランザクションプーラー — ポート 6543。認識され、調整された内容：セッションはクローズ時にリセットされず、サーバー側のプリペアドステートメントは無効になっています。これは、トランザクションプーラーがステートメント間でバックエンドを再割り当てするため、プリペアドステートメントが存続しないためです。
• 直接 — db.<project>.supabase.co ホストのポート 5432。Supabase は IPv4 アドオンを購入していない限り、IPv6 でのみこのサービスを提供していることに注意してください。エージェントのネットワークが IPv4 のみの場合、接続は失敗し、エラーメッセージにその旨が表示され、推測するのではなくセッション プーラーを使用するように指示されます。
• ユーザー名の形状はそれぞれ異なります。 — プーラーは postgres.<project-ref> を要求し、ダイレクトはプレーンな postgres を要求します — これは最初のクエリ時ではなく、入力時にチェックされます。

Supabaseの配管ではなく、あなたのスキーマ

Supabaseプロジェクトは、独自のスキーマ内に多くの仕組みを抱えています。それらをそのままにしておくと、テーブルピッカーは誰も報告したくないような情報で溢れかえってしまいます。

• Supabaseホストでは、auth、storage、realtime、supabase_functions、supabase_migrations、pgbouncer、およびその他の項目は一覧表示されません。
• フィルタリングのキーはホストに依存するため、auth という名前のスキーマを持つ通常の PostgreSQL サーバーでも、そのキーは保持されます。Supabase 以外のデータベースからは何も隠蔽されません。
• public はデフォルトのスキーマのままであり、これはクロスソースクエリの中間部分として使用されます。

パスワードが拒否された場合

Supabaseのセットアップで最もよくある失敗の原因は、やや分かりにくいものです。ダッシュボードのログイン情報とデータベースのパスワードは別物であり、必要なのは後者のパスワードです。Postgresが認証情報を拒否した場合、エージェントは生のエラーをそのまま渡すのではなく、どちらのパスワードを使用している可能性が高いかを示します。

-- supabase_app は接続、public は Postgres スキーマです SELECT p.plan, COUNT(*) AS accounts FROM supabase_app.public.profiles p JOIN stripe.stripe.subscriptions s ON s.customer_id = p.stripe_id WHERE s.status = 'active' GROUP BY p.plan