Convex

Convexとは？

Convex は、データベース、サーバー関数、クライアントライブラリを組み合わせたリアクティブなバックエンドです。クエリはデータベースと共に動く TypeScript コードで、購読した結果は保存データの変更に応じて更新されます。

Convex のリアルタイムデータベースは、JSON に似たドキュメントを保存しながらリレーショナルデータモデルを使用します。スキーマは任意で、ドキュメントは別テーブルのドキュメントを参照でき、アプリのコードは SQL ではなく JavaScript API で読み書きします。

Convex は AI Gateway を通じてマネージド AI モデルへのアクセスも提供します。バックエンドのアクションから呼ぶサービスで、プロバイダーの認証情報は Convex が保持し、短期アクセストークンはデプロイ単位に限定されます。

主な機能

クエリ、ミューテーション、アクション

関数の種類で実行境界が異なります。

• クエリはデータを読み取り、キャッシュされ、リアクティブな購読に対応します。
• ミューテーションはデータを書き込み、データベーストランザクションとして実行されます。
• アクションは外部 API を呼び出します。トランザクションではなく、キャッシュされません。
• HTTP アクションは webhook または独自クライアント用のエンドポイントを公開します。

マネージドモデルへのアクセス

AI Gateway はテキスト生成、埋め込み、判断、画像、動画、音声生成、文字起こしのルートを提供します。Decisions、Voice、画像・動画生成はアルファ版で、リクエストとレスポンスの形式が変わる場合があります。

ガイド

React インターフェースの接続

既存の Convex バックエンドは次の要素で React インターフェースに接続できます。

1. デプロイ用の ConvexReactClient を作成し、コンポーネントツリーを囲む ConvexProvider に渡します。
2. useQuery と生成された api オブジェクトでバックエンドデータを読み取ります。開発コマンドは convex/_generated/api.js にオブジェクトを生成し、JavaScript の自動補完とエンドツーエンドの TypeScript 型を提供します。
3. useMutation でデータを変更します。この hook は非同期関数を返し、引数を付けて呼び出すとミューテーションが実行されます。

Convex の利用例

• ライブチャット画面： Convex は、メッセージを永続保存しリアルタイム更新するチャットアプリのチュートリアルを提供します。
• 意味検索と推薦： ベクトル検索は指定ベクトルに類似するドキュメントを探します。文書化された用途には LLM アプリのコンテキストや関連コンテンツの推薦があります。
• 永続的なエージェント： Agent コンポーネントは会話履歴をセッション間で保存し、長時間の AI 処理をリアクティブな UI から分離します。その履歴に対するベクトル・テキストのハイブリッド検索と、RAG コンポーネントまたは独自実装を通じた他の情報源による RAG ベースのプロンプト拡張にも対応します。
• 遅延・定期処理： スケジュール関数は後で一度実行され、cron ジョブは繰り返し実行されます。歓迎メールやアカウント照合などに利用でき、Workpool と Workflow コンポーネントは再試行や遅延を伴うキューや永続的なフローを追加します。

対象ユーザー

• JavaScript・TypeScript アプリ開発者： TypeScript バックエンドは JavaScript も受け付け、関数はクライアントライブラリ API を通じて公開されます。画面とサーバーのコードを両方担当するチームに適します。
• ホスティング運用を求めるチーム： Convex はホスト型製品を運用負担がより少ないものとして位置付けています。セルフホストでは現在のバックエンドコードをチーム自身のサーバーで実行します。

プラットフォーム

• React クライアント： ConvexReactClient は WebSocket を使い、ポーリングなしで結果をプッシュし、接続断後に再接続します。
• フロントエンドホスティング： フロントエンドはバックエンドのデプロイとは別に Vercel、Netlify、独自ホスティングを利用できます。
• 認証： 接続・呼び出しには OpenID Connect JWT を使用します。Convex Auth はクライアント側の React と React Native の登録・ログインフローに対応しますが、まだベータ版で第三者統合より機能が少ない状態です。
• データリージョン： 北バージニア、アイルランド、シドニー、カナダ中部にデプロイできます。米国外の使用には 30% の追加料金（標準料金の 1.3 倍）がかかります。

デプロイを支えるすべてのインフラは選択リージョンでホストされます。リージョン変更には新しいプロジェクトまたはデプロイとデータのエクスポート・インポートが必要で、既存デプロイをそのまま移動することはできません。

価格

価格は 2026 年 11 月 2 日取得の米国東部基準で、米ドル表示です。含まれるリソースはリージョン間で共有されます。

プランと開発者アクセス

Business は月額最低 $2,500 と記載し、デプロイクラスとインフラの単価は別途公表しています。Enterprise は年間コミットメント割引を記載していますが、割引率や年間総額は示していません。

Free、Starter、Professional のリソース

各セルに含有量と追加料金を示します。最初の列では有料超過分が Starter に適用され、Free は固定枠です。ストレージは GB/月単位、その他は各記載の単位で課金されます。

サーバーレスのクエリ・ミューテーション計算は無料です。呼び出しにはクライアント呼び出し、スケジュール、購読更新、ファイルアクセスが含まれます。ファイルストレージにはバックアップ、データ送信には関数のファイルアクセスとバックアップの生成・復元が含まれます。テキスト・ベクトルのインデックスとクエリはそれぞれの検索メーターを共有します。

使用量はチームの全プロジェクトで合算され、プロジェクトや開発者ごとに別配分されません。Free プランでの長期的な超過は HTTP エラーを招く場合がありますが、Convex は、書き込みに成功したミューテーション記録をリソース超過で削除しないとしています。FAQ は Starter に言及し、継続トラフィックについて「Starter Plus」という名称も使います。別料金の階層があるとは推定しません。

Business と Enterprise のデプロイ料金

米国東部の月額表は 4 クラスで、稼働中のデプロイは日割りです。他の単位は各行に示します。

次のインフラメーターもデプロイクラスと併せて適用されます。

ダッシュは公表値を示し、無料や権利の包含を意味しません。

AI 料金と支出管理

AI Gateway には有料チームが必要で、クラウドの本番・開発デプロイまたはプロジェクトに紐づくローカルデプロイに対応します。Free とセルフホストのデプロイでは利用できません。セルフホストのアクションは独自キーでプロバイダーを呼び出せます。

Gateway の費用はモデル、タイミング、キャッシュ済みトークン、画像・動画の解像度と長さ、または音声の文字数・秒数・トークンによって変わります。Convex の請求書に表示され、送信済み動画リクエストのキャンセルでも生成費用が生じる場合があります。

クラウドデプロイは AI Gateway の日次・月次の無効化しきい値に対応し、モデルリクエストだけでなくデプロイ全体を無効化します。開発以外のデプロイでは警告しきい値も使えます。プロジェクト接続されたローカルリクエストはチームの支出上限を共有し、上限到達後も処理中のリクエストや発行済み短期認証情報を使うリクエストが完了する場合があります。

更新と返金

料金は明示的な契約上の例外を除きキャンセル・返金できません。Order Form が月次・年次サイクルを定め、セルフサービスの超過分は自動課金され、請求しきい値到達時に途中請求される場合があります。

Order Form のサブスクリプションは、いずれかの当事者が満了の 60 日以上前に不更新を通知しない限り、同じ期間で自動更新されます。顧客が自動更新しないことを選択した場合、現行の条件と価格で月単位に移行し、いずれの当事者も 30 日前の書面通知で終了できます。

Convex が重大な違反の書面通知を受領してから 30 日以内に是正しない場合、違反していない当事者である顧客は書面通知により契約または影響を受ける Order Form を終了できます。この条項で顧客が契約を終了した場合、Convex は終了効力発生日時点の、終了した Order Form の残期間に対応する前払い未使用料金を比例配分して返金します。これは契約上の例外で、一般的な試用返金期間ではありません。

Convex の代替製品

Supabase はプロジェクト単位の Postgres、認証、Row Level Security を備えたストレージ、リアルタイムサービス、Edge Functions を提供します。Postgres を基盤とするため SQL を重視するチームにとって関連する代替候補です。

Firebase Cloud Firestore はモバイル・ウェブ・サーバー向けの NoSQL データベースとリアルタイムリスナー、モバイルとウェブのオフライン対応を提供します。文書化されたオフライン動作は接続断時のアクセスに対応しますが、Convex に同等の動作があることを示すものではありません。

制限事項

トランザクションと実行の境界

• 外部への副作用： 外部リクエストが既に作用した可能性があるため、エラー時にアクションは自動再試行されません。再試行は呼び出し側が処理し、戻り後の未完了 promise は完了する場合もしない場合もあります。
• 別個のトランザクション： アクションはクエリとミューテーション経由で間接的にデータベースにアクセスします。別々の runQuery/runMutation 呼び出しは一貫した状態を共有するとは限らず、1 つにまとめたクエリ・ミューテーションには一貫したトランザクション境界があります。
• ドキュメントサイズ： 1 ドキュメントは最大 1 MiB、ネスト深度は最大 16 です。
• トランザクションサイズ： 1 回のクエリまたはミューテーションで最大 16 MiB の読み取りと 16 MiB の書き込みができます。スキャン後にフィルターで除外されたデータも読み取り量に含まれます。

アクションガイドは 10 分でタイムアウトすると記載します。一方、制限リファレンスは Convex ランタイムのアクションが 30 分、Node ランタイムが 10 分、さらにクエリ・ミューテーションのユーザーコードがデータベース操作を除き 1 秒と記載しています。公開説明は一致していません。

検索と生成の境界

ベクトル検索はアクション専用の近似最近傍検索で、コサイン類似度を使います。結果に含まれる項目自体はリアクティブではありませんが、別のクエリで各結果のデータをリアクティブに保てます。取得前にレコードが変化または消失する場合があります。テーブルあたり 4 つのベクトルインデックスを持て、次元数は 2～4,096 です。

画像・動画生成はアルファ版で、要求・応答形式が変わる場合があります。画像はテキストプロンプトを使い、入力画像やマスクによる編集には対応しません。同期動画は約 5 分後に失敗し、64 MiB のダウンロードが可能です。キャンセル・タイムアウト・レスポンス消失でも費用が発生する場合があります。非同期処理は 7 日後に期限切れとなり、プロバイダーの動画保存期間はそれより短い場合があります。

セルフホストのライセンス

バックエンドの FSL Apache 2.0 フェアソースライセンスは、ホスト型 Convex Cloud と競合するよう設計された製品の作成を除外します。コードは作成から 2 年後に Apache 2.0 に変わり、現在のリリースは初日から無制限の Apache 2.0 ではありません。

指定された Beta Features は評価専用で契約上の Platform の対象外であり、サービスの約束、サポート、保証、利用に関する責任がありません。Convex は提供を中止できます。

データの権利とモデルでの扱い

顧客・ライセンサーは Customer Data の権利を保持し、プラットフォームの提供、保守・サポート・改善、顧客が開始した統合、法的義務のための限定的な処理ライセンスを Convex に付与します。これは顧客からプラットフォームへのライセンスであり、データ所有権の移転ではありません。

Convex は Aggregated Data を所有し、分析、製品開発、ベンチマークを含む正当な事業目的に使用できます。顧客・ユーザーを特定せず、その情報を識別可能な形で含まず、合理的に再識別を可能にしない必要があります。

AI 条項は顧客の事前の書面同意なしに Customer Data を使って Convex または第三者の基盤モデルを訓練・改善することを禁じます。似た入力から似た出力が生じる場合があり、正確性、完全性、無誤り、目的適合性は保証されません。

ZDR マーカーは最終更新時のゼロ保持カタログとの一致を記録します。ルーティングはリクエストごとに有効化する必要があり、適格なエンドポイントがないと失敗します。マーカーだけでは保証になりません。画像・動画・音声ルートはこのオプションを受け付けません。

プライバシー、削除、処理場所

Convex のプライバシーポリシーはアプリの Customer Data を対象外とし、これは顧客契約とアプリのポリシーに従います。ポリシー対象情報について、IP・デバイス識別子、おおよその位置と活動データを収集し、cookie と分析ツールを使用する場合があります。

ポリシー対象情報は米国を含む世界で処理・保存され、サービス利用中や収集目的、提供、紛争、監査、法的防御、事業目的、権利行使、法的義務のために保持される場合があります。共通の固定期間は記載されていません。

DPA に基づき Convex は契約満了または終了時に Customer Personal Data を削除しなければなりません。バックアップ・アーカイブのコピーは保持スケジュールに従って削除されます。法律で保持が必要なコピーは隔離し、適用法が要求する場合を除き追加処理から保護する必要があります。サブプロセッサー一覧はインフラ・データベースサービスを選択リージョンに結び付ける一方、米国のサポート、分析、請求、AI ルーティングと、ドイツのコミュニティ管理も挙げています。

Convex は顧客コード、データベース、ファイル、検索インデックスの AES-256 保存時暗号化、通信の暗号化、本番アクセスの制限、SOC 2 Type 2 への準拠を表明しています。Convex によれば HIPAA の対象事業者は Business Associate Agreement に署名すればプラットフォームで PHI を処理できます。このベンダー声明は各顧客のアプリのコンプライアンスを証明しません。

よくある質問

Q1. すべての Convex 関数にリアルタイム性とトランザクションの保証がありますか？

いいえ。クエリはキャッシュ・購読可能で、ミューテーションはトランザクションですが、外部アクションは同じ保証を継承しません。

Q2. Free プランに AI Gateway は含まれますか？

いいえ。有料チームが必要で、モデル利用は別途従量課金されます。セルフホストのデプロイは独自のプロバイダー認証情報を使います。

Q3. 欧州リージョンを選ぶとすべての種類のデータがそこに留まりますか？

いいえ。デプロイインフラ、ポリシー対象の個人情報、サブプロセッサー、モデルルーティングの保持範囲は異なります。