<p data-line="0" class="code-line">こんにちは！株式会社Finatextで証券事業のバックエンドエンジニアをしております、@Goryudyumaです。<br>
今日は、私が運用に関わっているGoとMySQLを使ったWebアプリケーションで活用している便利ツールを紹介します。</p>
<p data-line="3" class="code-line">公開できる部分だけを抽出したリポジトリも用意しましたので、ぜひ参考にしてください。<br>
👉 <a href="https://github.com/Goryudyuma/techblog-go-mysql-tools" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Goryudyuma/techblog-go-mysql-tools</a></p>
<p data-line="6" class="code-line">この記事は<a href="https://qiita.com/advent-calendar/2025/finatext" target="_blank" rel="nofollow noopener noreferrer">Finatext Advent Calendar 2025</a> 2日目の記事として書かれました！</p>
<hr data-line="8" class="code-line">
<h2 id="sql-migrate" data-line="10" class="code-line">
<a class="header-anchor-link" href="#sql-migrate" aria-hidden="true"></a> sql-migrate</h2>
<p data-line="12" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__1c54bee5feaea" src="https://embed.zenn.studio/card#zenn-embedded__1c54bee5feaea" data-content="https%3A%2F%2Fgithub.com%2Frubenv%2Fsql-migrate" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/rubenv/sql-migrate" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/rubenv/sql-migrate</a></p>
<p data-line="14" class="code-line">Go製のシンプルなマイグレーションツールです。<br>
CLIとして実行することもできますし、ライブラリとして組み込むことも可能です。<br>
GoのEmbedding機能を使ってマイグレーションファイルをバイナリに組み込めば、デプロイ先の環境に依存せず実行できます。</p>
<hr data-line="18" class="code-line">
<h2 id="tbls" data-line="20" class="code-line">
<a class="header-anchor-link" href="#tbls" aria-hidden="true"></a> tbls</h2>
<p data-line="22" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__5354ce6cff21f" src="https://embed.zenn.studio/card#zenn-embedded__5354ce6cff21f" data-content="https%3A%2F%2Fgithub.com%2Fk1LoW%2Ftbls" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/k1LoW/tbls" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/k1LoW/tbls</a></p>
<p data-line="24" class="code-line">データベースのドキュメントを自動生成できるツールです。<br>
ER図やDBスキーマをGitで管理でき、ER図はMermaid記法で出力するのがおすすめです。<br>
GitHubはMermaidを標準対応しており、画像ファイルを直接埋め込むよりも差分が見やすくなります。</p>
<p data-line="28" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-github"><iframe id="zenn-embedded__4cee8e07ddb23" src="https://embed.zenn.studio/github#zenn-embedded__4cee8e07ddb23" data-content="https%3A%2F%2Fgithub.com%2FGoryudyuma%2Ftechblog-go-mysql-tools%2Fblob%2Fmain%2Fdocs%2Fschema%2FREADME.md" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/Goryudyuma/techblog-go-mysql-tools/blob/main/docs/schema/README.md" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Goryudyuma/techblog-go-mysql-tools/blob/main/docs/schema/README.md</a><br style="display:none">
<img src="https://storage.googleapis.com/zenn-user-upload/a99f725888a4-20251028.png" alt="" class="md-img" loading="lazy"></p>
<p data-line="31" class="code-line">tblsにはLint機能もあり、とくに <code>requireColumnComment</code> が便利です。<br>
これは、カラムにコメントがない場合に警告してくれる機能で、長期間運用されているサービスでありがちな「使われ方がわからないカラムが生まれる」問題を防いでくれます。</p>
<p data-line="34" class="code-line">また、<code>requireColumns</code> によって <code>created_at</code>・<code>updated_at</code> の存在を強制することも可能です。<br>
データの追加・更新日時は調査時に役立つことが多いため、基本的には入れておくのがおすすめです。<br>
もちろん、固定データテーブル（たとえば都道府県マスタのようなもの）では、例外設定を行えばこれらのカラムを除外できます。</p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="39" class="code-line">カラムコメントも、必須カラムも、デフォルトでは「存在を強制」し、必要に応じて「例外を許容」する方針が安全です。<br>
意図しない抜け漏れを防げるので、いざ必要になった時に困りません。</p>
</div></aside>
<hr data-line="43" class="code-line">
<h2 id="gorm%2Fgen" data-line="45" class="code-line">
<a class="header-anchor-link" href="#gorm%2Fgen" aria-hidden="true"></a> gorm/gen</h2>
<p data-line="47" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__7ba9fec82762d" src="https://embed.zenn.studio/card#zenn-embedded__7ba9fec82762d" data-content="https%3A%2F%2Fgorm.io%2Fgen%2Findex.html" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://gorm.io/gen/index.html" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://gorm.io/gen/index.html</a></p>
<p data-line="49" class="code-line"><code>gorm.io/gen</code> を利用して、実際のデータベーススキーマからGoの型を自動生成しています。<br>
型変換やnullable対応、独自の便利メソッド追加なども柔軟に設定できます。<br>
実データベースから生成することで、モデルとスキーマの不整合を防げるのが最大の利点です。</p>
<p data-line="53" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-github"><iframe id="zenn-embedded__0da8e075df16" src="https://embed.zenn.studio/github#zenn-embedded__0da8e075df16" data-content="https%3A%2F%2Fgithub.com%2FGoryudyuma%2Ftechblog-go-mysql-tools%2Fblob%2Fmain%2Ftools%2Fmodelgen%2Fmain.go" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/Goryudyuma/techblog-go-mysql-tools/blob/main/tools/modelgen/main.go" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Goryudyuma/techblog-go-mysql-tools/blob/main/tools/modelgen/main.go</a></p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="56" class="code-line">ORMとしてのgorm自体は使っていません。<br>
モデル定義専用として、<code>gorm.io/gen</code> を単体で利用しています。</p>
</div></aside>
<hr data-line="60" class="code-line">
<h2 id="diff-pr-management" data-line="62" class="code-line">
<a class="header-anchor-link" href="#diff-pr-management" aria-hidden="true"></a> diff-pr-management</h2>
<p data-line="64" class="code-line">ここまで紹介したツールで、ドキュメントやコードを自動生成できるようにしていても、「生成し忘れ」や「git add し忘れ」で不完全なままマージされるリスクがあります。<br>
人間はミスをする生き物なので、こうした部分は機械に任せましょう。CIを整備するのが大切です。</p>
<p data-line="67" class="code-line">そこで活躍するのが <a href="https://github.com/dev-hato/actions-diff-pr-management" target="_blank" rel="nofollow noopener noreferrer"><strong>diff-pr-management</strong></a> です。<br>
あなたがPull Requestを作ると、CI上でブランチをcheckoutし、自動でコード生成を実行します。<br>
もし生成結果とあなたが作ったPRに差分があれば、自動でその修正を行うPR（PRを修正するPR）が作られます。<br>
作られたPRをマージするだけで、あなたの作ったPRは常に正しい状態に保たれます。</p>
<p data-line="72" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-github"><iframe id="zenn-embedded__5b7f2c5afc13c" src="https://embed.zenn.studio/github#zenn-embedded__5b7f2c5afc13c" data-content="https%3A%2F%2Fgithub.com%2FGoryudyuma%2Ftechblog-go-mysql-tools%2Fblob%2Fmain%2F.github%2Fworkflows%2Ftest.yml%23L72-L76" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/Goryudyuma/techblog-go-mysql-tools/blob/main/.github/workflows/test.yml#L72-L76" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Goryudyuma/techblog-go-mysql-tools/blob/main/.github/workflows/test.yml#L72-L76</a><br style="display:none">
以下のようなPRを自動で生成してくれます：<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__0a5014b90fe7d" src="https://embed.zenn.studio/card#zenn-embedded__0a5014b90fe7d" data-content="https%3A%2F%2Fgithub.com%2FGoryudyuma%2Ftechblog-go-mysql-tools%2Fpull%2F3" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/Goryudyuma/techblog-go-mysql-tools/pull/3" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Goryudyuma/techblog-go-mysql-tools/pull/3</a></p>
<hr data-line="76" class="code-line">
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" data-line="78" class="code-line">
<a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> おわりに</h2>
<p data-line="80" class="code-line">以上、Go×MySQL環境で便利に使えるツールを紹介しました。<br>
参考コードを見ながら、ぜひ取り入れてみてください。<br>
他にもおすすめツールがあれば、ぜひコメント欄で教えてください！</p>
<p data-line="84" class="code-line">また、株式会社Finatextでは、開発体験を一緒に改善してくださるエンジニアを募集中です。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__fbcf7555c0ca4" src="https://embed.zenn.studio/card#zenn-embedded__fbcf7555c0ca4" data-content="https%3A%2F%2Fherp.careers%2Fv1%2Ffinatexthd%2FiRI8okPMACP_" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://herp.careers/v1/finatexthd/iRI8okPMACP_" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://herp.careers/v1/finatexthd/iRI8okPMACP_</a></p>
<p data-line="87" class="code-line">カジュアル面談も絶賛募集中です！<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f8032613387e1" src="https://embed.zenn.studio/card#zenn-embedded__f8032613387e1" data-content="https%3A%2F%2Fherp.careers%2Fv1%2Ffinatexthd%2FvZWzSlI_B-qk" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://herp.careers/v1/finatexthd/vZWzSlI_B-qk" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://herp.careers/v1/finatexthd/vZWzSlI_B-qk</a></p>
<p data-line="90" class="code-line">ここまで読んでくださり、ありがとうございました！</p>


GoとMySQLを使ったWebアプリケーションの便利ツール

Discussion