GraphQL Subscription とは？

Queryは1回の実行結果を返す操作。Subscriptionはイベントの列を受けて、各イベントから選んだフィールドを実行し、応答の列を返す操作だよ。たとえばチャットの新着メッセージを購読する。データベースのすべての変更を自動で監視する仕組みではないんだ。

宣言だけでは足りないよ。サーバーでイベント元を用意し、購読の条件や利用者の権限と結び付ける必要がある。subscription NewMessages { newMessage(roomId: 123) { sender text } }なら、サーバーがその部屋の新着を発行する実装が必要だね。

必須ではないよ。GraphQL仕様は通信方式を指定しない。graphql-wsなどのWebSocket実装や、graphql-sseのようなSSE実装がある。クライアントとサーバーで同じ通信方式・プロトコルに対応していることを確認するんだ。

ライブラリ名と通信上の名前を区別しよう。graphql-wsが使うWebSocketのサブプロトコル名はgraphql-transport-ws。似た名前の実装でも互換とは限らないので、接続時に合意する名前とメッセージ形式を合わせるんだ。

GraphQL仕様は確認応答、バッファ、再送などを保証していない。再接続、イベントID、履歴からの補完、重複の扱いを必要に応じて実装する。イベント元や複数サーバー間の共有も、Pub/Subを使うかなどアプリで選ぶよ。

1つの購読操作のルートフィールドは1つだよ。その中で複数の下位フィールドを選べる。不要になったら解除し、サーバー側の資源も片付ける。接続が長く続くから、認証期限や権限変更時の扱いも設計しよう。