sqlcを新規サービスに採用してみた！

Transcript

1. © GENDA Inc. sqlcを新規サービスに採用してみた！ プロダクト開発部 西尾　健人

2. © GENDA Inc. 01.　　　会社説明 02.　　　sqlcとは 03.　　　sqlcを採用した理由 04.　　　プロダクトでsqlcを使う際のTips 目次

3. © GENDA Inc. 自己紹介 西尾 健人 • GENDA 新卒 •

   FE/BE ◦ Go/TypeScript/Dart(Flutter) ◦ Python • 趣味 ◦ 筋トレ、ボディビル

4. © GENDA Inc. 01. 会社説明

5. © GENDA Inc. 会社概要 社名 代表取締役社長 設立 上場市場 株式会社GENDA 申

   真衣 2018年5月 東京証券取引所グロース市場 資本金 64億6,307万円（資本剰余金含む）2023年8月31日現在 従業員数 連結：11,063名（2024年2月29日時点） 所在地 東京都港区東新橋1-9-1　東京汐留ビルディング17F

6. © GENDA Inc. 世界中の
 人々の人生を
 より楽しく
 Aspiration 人が人らしく生きるために「 楽しさ」は不可欠と考え、 私たちは「世界中の人々の人生をより楽しく

   」という Aspiration（アスピレーション＝大志）を掲げています。

7. © GENDA Inc. 2つの成長戦略 M&A / Finance GENDAグループはM&Aによって事業領域を拡大しており、 それに伴ってテクノロジーを活用する領域も増えていきます。 GENDAにはプロダクト開発に携わる

   プロフェッショナルが集まり、 グループ各社の成長をテクノロジー面でリード しています。 Technology アミューズメント施設会員向け 公式アプリの開発 アミューズメント施設の DX推進 テクノロジーを活用して、 エンターテイメント業界に挑戦 クレーンゲームの オンライン展開 既存事業の成長に加え、 M&Aでの「連続的な非連続な成長」 により 株式価値を高めていくことが成長戦略の柱になっています。

8. © GENDA Inc. GENDAグループ概観

9. © GENDA Inc. プロダクト

10. © GENDA Inc. 02. sqlcとは

11. © GENDA Inc. sqlcとは SQLのクエリからtype-safeなコード を自動生成するパッケージ https://sqlc.dev/

12. © GENDA Inc. sqlcのサポート範囲 Language MySQL PostgreSQL SQLite Go Stable

    Stable Beta Kotlin Beta Beta Beta Python Beta Beta ー TypeScript Beta Beta ー [1] https://docs.sqlc.dev/en/latest/reference/language-support.html v1.26.0 (2024/06/13) 現在 [1]

13. © GENDA Inc. sqlcの使い方 01.　　　DBのスキーマと設定ファイル（sqlc.yaml or sqlc.json）を用意 02.　　　SQLのクエリを書く 03.　　　 $

    sqlc generate 全ての作業は「sqlc playground」[2] で実施しています。 （https://play.sqlc.dev/p/12767f4f5b4a5a6dbda6a51fd6c663cef35515f11bc5df569874a3ab57515b3d） [2] https://play.sqlc.dev

14. © GENDA Inc. 設定ファイル • queries クエリファイルのパス • schema DDL文のパス

    • gen ◦ package 生成されるパッケージ名 ◦ out 生成コードを出力するディレクトリ sqlc.json

15. © GENDA Inc. クエリを書く DDL文 id指定で購入履歴を一つ取得するクエリ

16. © GENDA Inc. コード生成 ← クエリがconstで生成 （設定次第） ← データ取得のコードが生成 ←

    別ファイルに構造体も生成

17. 03. sqlcを採用した理由

18. © GENDA Inc. sqlcを採用した理由 01.　　　コードの安定性の向上 02.　　　生成されるコードの可読性の高さ 03. 　　個人のOSS → 会社化

19. © GENDA Inc. コードの安定性の向上 Go標準 ⚪ 使いやすい（クエリ書いて Scanするだけ） ✖ データのマッピング（テーブルのカラムを追加した時とか大変）

    高度なORMマッパー（GORM、xorm etc.） ⚪ 型安全 ⚪ Goの書き心地でSQLを扱える △ 学習コスト 　　 ✖ データのマッピング

20. © GENDA Inc. コードの安定性の向上 sqlc ⚪ Go標準の使いやすさ ⚪ 型安全 ⚪

    Testもしやすい ⚪ データのマッピング コンパイラがチェックできないエラー（ SQL文のマッピング順と引数の順番）を解決 [4] マッピングをSQL文で管理できる （最近はORMでも自動生成できるものがあるらしい： Gorm GEN [5]) [4] https://conroy.org/introducing-sqlc [5] https://gorm.io/gen/index.html

21. © GENDA Inc. コードの可読性の高さ Goの標準パッケージのみで生成 (context, database/sql, time) データもプリミティブなデータ型で定義さ れる

    ↓ ORMマッパーに慣れていないメンバー も使いやすい（インターン生が多かった） 最悪手動で直せる

22. © GENDA Inc. 個人OSS → 会社化 Coreコントリビューターの方が会社を立ち上げて sqlcをフルタイムでサポート＆スポンサード • プロダクトレベルで導入する上で少し安心

    https://github.com/sqlc-dev/sqlc

23. © GENDA Inc. 04. プロダクトでsqlcを使 う際のTips

24. © GENDA Inc. 集計関数を使用する時の注意点（ MySQL） ← 集計関数を使用したクエリ ← 集計値の型が interfaceとなってしまう

    （具象型は []byte型、詳細はzennへ [6]） [6] https://zenn.dev/genda_jp/articles/b8b8df8e6fc769

25. © GENDA Inc. 生成されたコードにGodocをつける ↑ コメントを残すと、 　生成されたメソッドにGodocも生成される

26. © GENDA Inc. SQL文のLinterを導入する SQL文が常に正となるのでしっかり保守したい • SQLFluff • ◦ PythonベースのSQL

    Linter ◦ 公式のDocker imageもあり扱いやすい [7] [7] https://hub.docker.com/r/sqlfluff/sqlfluff https://sqlfluff.com/

27. © GENDA Inc. 他にも色々 便利な機能はたくさんある 機能 概要 sqlc verify schemaの変更を検知して、これまでのクエリが問

    題ないかを検証してくれる sqlc vet 自分でルールを書いて lintする 特定の操作を禁止したり、実行計画をもとに Slowク エリを特定したりする SQLのmigrationはサポートしていない • up/down migrationをよしなにみてくれる機能はある • 今回はsqldef [8]を使用してスキーマを管理 (sqlcと相性良さそう） [8] https://github.com/sqldef/sqldef

28. © GENDA Inc. Now Hiring!! エンジニア、募集しています！ 他にもプロダクトマネージャーやデータサイエンティスト、 M&A担 当まで幅広く募集しています。

29. END