GoのGraphQLライブラリgqlgenを使ったリスト取得の実装.pdf

by fujiwaram

Slide 1

Slide 1 text

1 GoのGraphQLライブラリgqlgenを使ったリスト取得の実装藤原学

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Copyright©HRBrain, Inc. All Rights Reserved https://gqlgen.com/ https://github.com/99designs/gqlgen GraphQLサーバを簡単に作るためのGo製のライブラリ・GraphQLスキーマからコードを自動生成してくれる・型安全・GitHubのStar数が9.1K（2023/8/21時点）今日は、こちらを使った実装について話します。 5 gqlgen

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Copyright©HRBrain, Inc. All Rights Reserved gqlgenをインストールし以下のコマンドを実行するとスケルトンを作成してくれる go run github.com/99designs/gqlgen init schema.graphqlsのスキーマを変更して以下のコマンドを実行するとスキーマに合わせた型定義やResolverが呼ばれるまでの処理を自動生成してくれる go run github.com/99designs/gqlgen 詳細な手順はこちらを参照 https://gqlgen.com/getting-started/ 7 スキーマを元にコードを自動生成

Slide 8

Slide 8 text

Copyright©HRBrain, Inc. All Rights Reserved クエリを実行するときに呼ばれるResolverという関数があるここは自動生成で空の関数だけが用意されるので、中身の実装が必要 SQLを実行し、DBから取得した値を変数に詰めて返すだけ上記はsqlxを使用した実装例 8 Resolverの実装 Resolverはフィールド毎に用意することが可能 Query直下のフィールドは必ずResolverが生成されるスキーマの定義でResolverを用意するかどうかを指定できる

Slide 9

Slide 9 text

Copyright©HRBrain, Inc. All Rights Reserved ユーザーの一覧を取得して、さらにユーザー配下の友達の一覧を取得するクエリこのときのResolverの呼ばれ方👇 9 もう少し複雑なクエリスキーマ実行するクエリ - queryResolver.UserList：ユーザーの一覧を取得（ユーザー1,2,3,4…） - userResolver.Friends：ユーザー1の友達一覧を取得 - userResolver.Friends：ユーザー2の友達一覧を取得 - userResolver.Friends：ユーザー3の友達一覧を取得 - userResolver.Friends：ユーザー4の友達一覧を取得　　︙

Slide 10

Slide 10 text

Copyright©HRBrain, Inc. All Rights Reserved 10 入れ子の一覧取得クエリで発生する課題 - queryResolver.UserList：ユーザーの一覧を取得（ユーザー1,2,3,4…） 👉SELECT * FROM users; - userResolver.Friends：ユーザー1の友達一覧を取得 👉SELECT * FROM users WHERE id IN (2, 3, 4); - userResolver.Friends：ユーザー2の友達一覧を取得 👉SELECT * FROM users WHERE id IN (1); - userResolver.Friends：ユーザー3の友達一覧を取得 👉SELECT * FROM users WHERE id IN (1, 6); - userResolver.Friends：ユーザー4の友達一覧を取得 👉SELECT * FROM users WHERE id IN (1, 8); 　　︙ こうなる GraphQLでよく課題となるN+1問題がこれ

Slide 11

Slide 11 text

Copyright©HRBrain, Inc. All Rights Reserved Dataloaderという仕組みが用意されている同じクエリをまとめて実行してくれる - userResolver.Friends：ユーザー1の友達一覧を取得 👉SELECT * FROM users WHERE id IN (2, 3, 4); - userResolver.Friends：ユーザー2の友達一覧を取得 👉SELECT * FROM users WHERE id IN (1); - userResolver.Friends：ユーザー3の友達一覧を取得 👉SELECT * FROM users WHERE id IN (1, 6); - userResolver.Friends：ユーザー4の友達一覧を取得 👉SELECT * FROM users WHERE id IN (1, 8); - userResolver.Friends：ユーザー1,2,3,4,...の友達一覧を取得 👉SELECT * FROM users WHERE id IN (2, 3, 4, 1, 6, 8); 11 N+1問題の解決策① 詳しくはこちら https://gqlgen.com/reference/dataloaders/

Slide 12

Slide 12 text

Copyright©HRBrain, Inc. All Rights Reserved ◯ Resolverを分けないで親の階層でのデータ取得時に一緒に取得する分かりやすいけど、GraphQLの利点である必要なデータだけ取得することができなくなる ◯ ただ、今回の例では親と子が同じデータ(User)なので、親で取得したデータをオンメモリで保持しておき、各子供のResolverで一致するデータを返して上げるという方法もあり 12 N+1問題の解決策②