GraphQL を WunderGraph に移行する

WunderGraph アプリケーションの作成

# Init a new project
npx create-wundergraph-app my-project --example simple
# Move to the project directory
cd my-project
# Install dependencies
npm i

npm スクリプトの追加

次のスクリプトを package.jsonに追加すると、WunderGraph サーバーを実行できるようになります。

{
   "scripts": {
      "start": "wunderctl up --debug",
      "build": "wunderctl generate"
   }
}

WGS サーバーを起動する

npm run start

サーバーを起動すると、WunderGraph によっていくつかのコード生成が行われます。 http://localhost:9991でサーバーのステータスを確認します。

MongoDB Atlas データソースの構成

MongoDB Atlas データソースを構成する必要があります。 wundergraph.config.tsファイル内に以下を追加します。

const Atlas = introspect.mongodb({
   apiNamespace: 'my_db',
   databaseURL: 'YourAtlasURL',
});
configureWunderGraphApplication({
   apis: [Atlas],
});

クエリ操作を追加する

Atlas データを操作するには、クエリ操作を追加する必要があります。 operationsフォルダーに移動し、 Users.graphqlという新しい GraphQL ファイルを作成し、以下を追加します。

{
   Mongo_findFirstusers {
      id
      name
      email
   }
}

GraphQL UI でデータを参照する

WGS サーバーを実行し、クエリ操作を追加したら、GraphQL ユーザー インターフェイスを使用して、GraphQL API から Atlas データを調査できます。 これは、アプリを開発する際に役立ちます。 本番環境のアプリでは、WunderGraph の JSON-RPC インターフェイスを使用することをお勧めします（次のステップを参照）。

1. WunderGraph サーバーが実行されている場合は、 http://localhost:9991/graphqlに移動します。

2. 次のクエリを GraphQL ユーザー インターフェースに追加します。

   query Users {
      db_findManyusers {
         id
         name
         email
      }
   }

3. [ プレイ ] ボタンをクリックします。

本番環境での WunderGraph の JSON-RPC インターフェースの使用

GraphQL は開発に適していますが、本番環境では、Atlas データを操作するために WGS の JSON-RPC インターフェイスを使用することを検討する必要があります。

つまり、WunderGraph は GraphQL 操作を呼び出して使用できる JSON-RPC エンドポイントにコンパイルします。

wunderctl upの実行後、WunderGraph は.wundergraph/operationsディレクトリで*.graphqlファイルを確認し、それらを処理します。 これを機能させるには、各ファイルに 1 つの GraphQL 操作が含まれている必要があります。

各ファイルは JSON-RPC エンドポイントにコンパイルされます。 エンドポイントの名前は、ファイル名によって決まります。

JSON-RPC API クエリの例は次のとおりです。

curl http://localhost:9991/operations/Users

クライアント アプリケーションの更新

GraphQL API エンドポイントを操作するすべてのクライアント アプリケーションを、新しい WundaGraph エンドポイント URL を指すように更新します。

Atlas App Services エンドポイントのシャットダウン

GraphQL API エンドポイントが WGS に完全に移行され、運用されていることを確認したら、MongoDB Atlas App Services アプリを削除して不要なコストを回避できます。 Atlas GraphQL エンドポイントは、 2025 12年 3 月 日以降、サポートされなくなります。