新しいPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2変更履歴を参照 →

エンジニアリング · 10 分読み取り

pg_graphql と Hasura および PostGraphile (Postgres) の比較

Affane Daylami · Fondateur · 2026年7月31日

ブログに戻る

Postgres の GraphQL API は、ツールによって意味が大きく異なります。 PostGraphile は、別のノード サーバーをデプロイします。 Hasura は、データベースの前に GraphQL エンジンをデプロイします。 pg_graphql は Postgres で実行されます。これは Aurabaseが採用するアプローチです。これは実装の詳細ではありません。ホスト、セキュリティ、維持に必要なものが変わります。

このページは自動翻訳されました。英語版が正式です。

pg_graphql は、Supabase によって管理されているオープン ソースの Postgres 拡張機能であり、Aurabase の発明ではありません。私たちが構築したのは、プラットフォームへのネイティブおよびオプトイン統合です。プロビジョニングするサービスではなく、プロジェクトごとにチェックを入れるボックスです。この投稿では、実際のアーキテクチャを詳しく説明し、それを有効にする方法を示し、Hasura および PostGraphile v5 とのトレードオフを正直に比較します。

必需品
  • pg_graphql は SQL 拡張機能として Postgres で実行されます。 Hasura や PostGraphileとは異なり、個別の GraphQL サーバーをデプロイする必要はありません。
  • Aurabase によって提供されるラッパー関数は SECURITY INVOKERです。 RLS ポリシーは自動的に適用され、並行して維持するための 2 番目の権限システムは必要ありません。
  • オプトイン アクティベーションはプロジェクトごとにのみ (aura projects graphql-enable または Studio)、どのプロジェクトでもデフォルトでアクティベートされることはありません。
  • Hasura は、GraphQL エンジンを放棄することなく、2025 年 6 月に正式に PromptQL と AI エージェントに再び重点を置きました。
  • PostGraphile v5 は、2026 年 3 月 24 日に一般公開されました。これは、休止中のプロジェクトではなく、直接のアクティブな競合相手です。
#
概要

pg_graphqlを一文で

pg_graphql は SQL スキーマをイントロスペクトし、Relay 規約 ( <table>Collection、 edges、 node) に準拠した GraphQL スキーマを生成し、列タイプによるフィルター、カーソルによるページネーションを行います。 SDL を手動で記述したり保守したりする必要はありません。GraphQL スキーマは Postgres スキーマに従います。

アーキテクチャにとって重要な点: このスキーマ ジェネレーターは、隣の HTTP プロセスとしてではなく、SQL 関数としてデータベース内に存在します。 Aurabase は、拡張機能の 1.6.1 バージョン (2026 年 5 月 7 日リリース) を Postgres イメージ — Supabaseによって配布されるものと同じ公式 .deb パッケージに固定します。これは、共有クラスターと専用の Postgres インスタンスの両方にインストールされます。

pg_graphql が長い間ネイティブに有効化されてきた Supabaseを使用している場合は、ロジックに馴染みがあるでしょう。詳細な 比較 と 移行ガイド では、RLS スキーマとポリシーの残りの部分について説明していますが、これらは同じです。

#
コンテキスト 2026

Hasura および PostGraphile での変更点

「インスタント GraphQL on Postgres」の 2 つの歴史的な競合他社はどちらも消滅していません。彼らの位置づけは変化しており、更新された記事では 2 年前の状態を引用するのではなく、それを反映する必要があります。

Hasura は 2025 年 6 月に、共同創設者 Tanmai Gopal の署名付きで「GraphQL から PromptQL へ: 新しい章の始まり」という明示的なタイトルの投稿を公開しました。メッセージ: 同社は、AI エージェント向けに設計されたデータ アクセス レイヤーである PromptQLにロードマップを再度焦点を当てています。 GraphQL エンジンは削除されていません - Hasuraのホームページでは依然として「厳しいテスト済み」と表示されています - しかし、もはや優先メッセージではありません。

PostGraphileは、その逆のことを行いました。 2023 年からベータ版として開発が進められてきたバージョン 5 は、Grafast と呼ばれる新しいクエリ プランニング エンジンを備え、2026 年 3 月 24 日に一般公開されました。これは勢いがなくなっているプロジェクトではありません。最後のリリース 5.1.4 は、2026 年 8 月 5 日の日付です。npm パッケージ は、2026 年 8 月 16 日から 22 日の週だけで 119,230 件のダウンロードを記録しました (npm レジストリ、2026 年 8 月 23 日に調査)。

アストゥチェ

実際の結果: 本当の空きスペースは「Postgres上の GraphQL、誰も触らない」というものではなく、ホストするサービスのない、1 つのコマンドでアクティブ化された特定の GraphQL ゼロ構成スロットです。 Hasura は戦略的な選択によってそこから遠ざかります。 PostGraphile はこれをターゲットにしたことはなく、そのモデルは「自分自身を統合するための Node.js ライブラリ」のままです。

#
建築

それぞれのソリューションが実際にどこに向かうのか

運用コスト、攻撃対象領域、レイテンシなど、他のすべてを構成する違いは、GraphQL エンジンが実行される場所です。

どこに転ぶのかSQL 拡張機能 (Postgres)Postgres の前にある別の GraphQL サーバー (Go)Node.js ライブラリ/サーバー、Postgres よりも先に
導入が必要ですなし — プロジェクト フラグによってアクティブ化されますはい — Hasura エンジンをホストおよびスケーリングしますはい - ノードプロセスをホストするか、サーバーと統合します
権限モデルレガシー Postgres RLS (SECURITY INVOKER)Hasura独自の権限システム (ロール/テーブルごと)RLS Postgres pgSettings 経由 — ネイティブ委任も
デフォルトでのイントロスペクション障害者エンジン構成に応じてサーバー構成に応じて
2026 年の位置付けPostgres BaaS のネイティブ オプション2025 年 6 月から PromptQL/IA に再び焦点を当てる2026 年 3 月以降の GA v5、アクティブなプロジェクト
オーラベースハスラポストグラフィック V5

正直に言うと、 PostGraphile は pgSettings とロールの切り替えを介して Postgres にも承認を委任します。ネイティブ RLS は pg_graphqlに限定されません。依然として異なるのは、誰がこのブリッジをホストして構成するかということです。 PostGraphileでは、それはあなたです。 Aurabaseでは、これはすでに完了しています。

#
ボンネットの下で

Aurabase がプロジェクトで pg_graphql をアクティブ化する方法

アクティベーションはプロジェクトごとにオプトインであり、Postgres エンジン プロジェクト用に予約されています。MongoDB プロジェクトはリクエスト (GRAPHQL_UNSUPPORTED_ENGINE) を拒否します。 pg_graphql は Postgres 拡張機能であり、他のエンジンには同等のものはありません。

CLI を使用するか、管理プランを直接呼び出します。

terminalbash
# 冪等: すでにアクティブ化されているプロジェクトを呼び出しても、何も再作成されません。
aura projects graphql-enable <project_id>

# HTTP と同等 (管理プレーン、JWT コンソール)
curl -X POST "$AURA_CONTROL_URL/v1/control/projects/$PROJECT_ID/graphql/enable" \
  -H "Authorization: Bearer $CONSOLE_JWT"

サーバー側では、この呼び出しにより、プロビジョナーが 1 つのトランザクションで実行する graphql_enable ジョブが実行されます。これには、拡張機能のインストール、スキーマでの graphql() 関数の作成、アプリケーション ロールへの GRANT が含まれます。ステップが失敗すると、すべてがキャンセルされます。ラッパーが途中でインストールされることはありません。graphql_enabled は、完全に成功した場合にのみ true に移動します。

これは、共有 Postgres クラスターとプロジェクトごとの専用 CNPG インスタンスの両方で動作します。2 つの異なる Postgres イメージですが、拡張メカニズムは同じです。専用インスタンスでは、拡張機能は直接 SQL ではなく、CNPG 演算子の宣言マニフェストを介してインストールされます (最近の修正)。専用クラスターはアプリケーション スーパーユーザー アクセスなしで実行され、 pg_graphql はその CREATE EXTENSIONに対してまさにこの権限を必要とします。

Studio からは、同じフローが [テーブル構成] タブを通過します。そこにあるボタンにより、プロジェクト レベルで拡張機能が有効になります。これは、上記と同じ HTTP 呼び出しで、収束するまでポーリングが行われます。次に、2 番目のコントロールは、エディターを離れることなく、テーブルごとに @graphql ディレクティブを設定し、GraphQL コレクションの totalCount と集計フィールドをアクティブにするかどうかを設定します。

単一コマンド ビュー: アクティブ化 → スレッド化されたプロビジョニング ジョブ (冪等、すでに実行中の場合は操作なし) → DDL トランザクション (拡張機能、ラッパー関数、GRANT) → 完全な成功後にのみフラグ graphql_enabled が設定される → /rpc/graphql経由でリクエストが可能。

#
セキュリティ

レガシー RLS、保守が必要な 2 番目のシステムではない

Aurabase によって設定された関数は SECURITY INVOKER です。これは Postgresのデフォルトの動作であり、将来のリファクタリングによって誤って変更されないように説明されています。実際の呼び出し元 ( JWT クレームに応じてaura_anon、 aura_authenticated 、または aura_service_role) の権限で実行されるため、 RLS ポリシー は REST リクエストの場合とまったく同じように適用されます。

SECURITY DEFINER を使用しない理由

SECURITY DEFINER 関数は、RLS 全体をバイパスします — 内部的にチェックされます。アプリケーション ロールを変更せずにスーパーユーザー接続で graphql.resolve を呼び出すと、RLS かどうかに関係なく、すべての所有者の行が返されます。この選択により、まさにクロステナントのリスクが回避されます。

Hasuraでは、アーキテクチャの構造が異なります。エンジンは、各 GraphQL クエリを、 Hasuraに固有の権限ルールによって制約された SQL クエリに変換します。これらのルールは、独自のレイヤー内のロールごとおよびテーブルごとに定義されます。つまり、 Postgres RLSへの委任ではなく、 Postgres への並列システムです。アクセス ルールを監査する場所は 1 つではなく 2 つです。

イントロスペクション ({ __schema { ... } }) は、各 Aurabase プロジェクトでデフォルトで無効のままです。これは、プラットフォームの他の部分と一貫した姿勢です。 Apollo Studio やgraphql-codegen などのツールが必要な場合は、COMMENT ON SCHEMA を介してスキーマによってアクティブ化できます。

#
チュートリアル

GraphQL API を有効にしてクエリを実行します

graphql_enabled から trueに移行すると、専用の /graphql ルートがゲートウェイに表示されなくなります。リクエストは、SDK から呼び出される他の Postgres 関数と同様に、汎用 RPC プロキシを経由します。

query.shbash
curl -X POST "$NEXT_PUBLIC_AURABASE_URL/v1/db/$PROJECT_ID/rpc/graphql" \
  -H "apikey: $NEXT_PUBLIC_AURABASE_ANON_KEY" -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"query":"query { postsCollection(first: 10, filter: { published: { eq: true } }) { edges { node { id title created_at } } } }"}'

応答は、追加の Aurabase ラップなしで、GraphQL 仕様 ({ data, errors }) に従います。ゲートウェイは、ターゲットの RPC が graphql であることを検出し、通常の RPC とは異なり、再ラップしません。標準の GraphQL クライアント (Apollo、urql、graphql-request) は、出力をそのまま使用します。

アクティブ化時に、図の @graphql ディレクティブを介して、 max_rows: 1000 および inflect_names: trueという 2 つの設定がデフォルトで設定されます。 pg_graphql のデフォルトの上限はコレクションあたり 10,000 行です。 first:を使用しないと、大きなテーブルがメモリを飽和させる可能性があります。 inflect_names は、SQL テーブルの生のsnake_caseではなく、読み取り可能な型名を提供します。

#
限界

pg_graphql が (まだ) できないこと

このブログの精神に沿って、隠すのではなく文書化すること。

  • ネイティブ GraphQL サブスクリプションがありません。 pg_graphql は、リアルタイム subscriptions ではなく、クエリと変更をカバーします。これは拡張機能自体の制限であり、Aurabase の省略ではありません。リアルタイム Aurabase は存在しますが、GraphQL サブスクリプション ブリッジではなく、別のチャネル (postgres_changes) を介します。
  • Hasuraのような宣言的なアクションはありません。 「GraphQL ミューテーションに接続されたビジネス Webhook」モデルには直接同等のものはありません。 Aurabaseでは、このロジックは専用の GraphQL 構成ではなく、Postgres 関数またはエッジ関数を経由します。
  • Postgres エンジン用に予約されています。 MongoDB プロジェクトではこれを有効にできません。回避策はありません。
情報

アクティベーションがデフォルトではなくオプトインのままである理由: テナント データベースの GRANT/Roles 領域には、リグレッションの文書化された履歴があります。これは、より広範な欠陥を検討する前に、プロジェクトごとに明示的な検証を行わない限り、機能が影響を受けないことを正当化するのに十分です。

#
決定

Aurabase、 Hasura または PostGraphile: コンテキストに応じて

3 つのオプションはすべて正当です。正しい選択は、すでに持っているものと避けたいものによって異なります。

  • Aurabase 上のpg_graphql — RLS データベースとポリシーがすでに Aurabase 上に存在しており、追加の監視サービスを使用せずにクエリを実行する 2 番目の方法が必要な場合。
  • Hasura — 単一の GraphQL スキーマの背後で複数のデータ ソース ( Postgresだけでなく) をフェデレーションする場合、または PromptQL とその AI エージェントのアプローチがロードマップに適合する場合。
  • PostGraphile v5 — プラグイン システム経由で生成されたスキーマを細かく制御する必要があり、それを統合する Node.js サーバーをすでに実行している場合。

完全なクエリ構文 (列タイプによるフィルター、orderBy並べ替え、カーソルによるページネーション、insertInto<Table>Collection 変更) については、公式の pg_graphqlドキュメントを参照してください。以下の Aurabase GraphQL ドキュメントでも、完全なサイクルについて詳しく説明しています。

導入の準備はできていますか?

5 分でバックエンドが完成します。

クレジット カードは不要 · 500 MB 無料 · 50,000 MAU