Go言語のDB接続プールを完全解説！sql.DBの仕組みと安全なベストプラクティス
生徒
「Go言語でデータベースを使うとき、毎回つなぐ必要があるんですか？なんだか難しそうです……」
先生
「Go言語では、データベースへの接続をまとめて管理する仕組みがあります。それが接続プールです。」
生徒
「接続をまとめて管理する、というのがよく分かりません。」
先生
「例え話を使いながら、sql.DBの仕組みと正しい使い方を説明していきます。」
1. データベース接続とは何か
Go言語でデータベース操作を行うには、まず「接続」が必要です。接続とは、Go言語のプログラムとデータベースが会話できる状態を作ることです。
これは電話に例えると分かりやすいです。電話番号を押して相手につながるまでが「接続」です。つながっていない状態では、どんな用件も伝えられません。
データベースでも同じで、INSERTやSELECTといった操作は、接続ができて初めて実行できます。
2. 接続を毎回作ると何が問題か
初心者の方は「使うたびに接続すればいい」と考えがちです。しかし、データベース接続はとても重たい処理です。
電話をかけるたびに回線工事をするようなもので、時間もかかり、サーバーにも大きな負担がかかります。アクセスが増えると、動作が極端に遅くなる原因になります。
この問題を解決するために使われるのが「DB接続プール」です。
3. DB接続プールとは何か
DB接続プールとは、あらかじめ複数の接続を用意しておき、必要に応じて使い回す仕組みです。
これは「電話オペレーターの待機席」に例えられます。問い合わせが来たら、空いている席の人が対応し、終わったらまた待機席に戻ります。
Go言語では、この接続プールをsql.DBという型が自動で管理してくれます。
4. sql.DBは接続そのものではない
ここは初心者が最も誤解しやすいポイントです。sql.DBは「接続」ではなく、「接続プールの管理者」です。
一つのsql.DBの中に、複数の実際の接続が存在します。プログラムは、その管理者に「使える接続をください」とお願いするだけです。
そのため、アプリケーション全体でsql.DBは一つだけ作り、使い回すのが基本です。
5. sql.DBの基本的な作り方
db, err := sql.Open("mysql", "user:pass@/dbname")
if err != nil {
panic(err)
}
sql.Openは接続を確立する命令に見えますが、実際には接続プールを準備するだけです。
この時点では、まだデータベースと本当に通信していない場合もあります。
6. 接続プールのサイズ設定
sql.DBでは、接続の最大数や待機数を設定できます。これにより、無限に接続が増えるのを防げます。
db.SetMaxOpenConns(10)
db.SetMaxIdleConns(5)
最大接続数は「同時に使える電話回線の数」、待機接続数は「待機席に座れる人数」と考えると理解しやすくなります。
7. 接続を閉じるタイミング
sql.DBはアプリケーション終了時に一度だけ閉じます。処理ごとに閉じてはいけません。
defer db.Close()
これは「電話センターを丸ごと閉鎖する操作」です。途中で閉じると、他の処理が接続できなくなります。
8. 初心者がやりがちな間違い
よくある間違いは、関数ごとにsql.DBを作ってしまうことです。これでは接続プールの意味がなくなります。
また、接続数を設定せずに放置すると、サーバーに大きな負荷がかかることがあります。
Go言語のデータベース操作では、「sql.DBは一つだけ」「接続プールを意識する」という二点を必ず守りましょう。
