FlaskアプリのDB接続プールを最適化！データベース接続を安定させる初心者ガイド

FlaskアプリのDB接続プールを最適化して性能を安定させる手法

先生と生徒の会話形式で理解しよう

生徒

「Flaskで作ったアプリの利用者数が増えてきたら、急にデータベースのエラーが出て動かなくなってしまいました。どうしてですか？」

先生

「それはデータベースとの通信経路、つまり『接続』が足りなくなったり、古くなったりしている可能性がありますね。『接続プール』という仕組みを整える必要があります。」

生徒

「接続プール…ですか？なんだか難しそうですが、初心者でも設定を直せますか？」

先生

「仕組みさえ分かれば、Flaskの設定を少し書き換えるだけで性能がグンと安定しますよ。まずは基礎から順番に解説しましょう！」

1. データベース接続と接続プールとは？

パソコンを触ったことがない方でも分かりやすいように、まずは「電話」に例えて説明します。Webアプリ（Flask）がデータベース（情報の保管場所）にデータを読み書きするとき、その都度、電話をかけて回線をつなぐ必要があります。これを「接続（コネクション）」と呼びます。

しかし、電話をかけるには、ダイヤルを押して相手が受話器を取るまでの「待ち時間」が発生します。たくさんのユーザーが同時にアクセスしてくるたびに電話をかけ直していると、この待ち時間が積み重なってアプリが重くなってしまいます。そこで登場するのが「接続プール」です。

接続プールとは、あらかじめ数台の電話を「通話状態」のままキープして、受付カウンターに置いておくような仕組みです。ユーザーが来たら、その「すでにつながっている電話」をサッと貸し出すことで、つなぐ時間をゼロにできます。これがパフォーマンス最適化の第一歩です。

2. なぜ接続プールの最適化が必要なのか

接続プールを使えば速くなりますが、ただ数を増やせば良いというわけではありません。例えば、電話の回線数には限界があります。データベース側が受け入れられる電話の数を超えてしまうと、「もう電話に出られません！」というエラー（接続拒否）が起きてしまいます。

また、ずっとつなぎっぱなしの電話が、実は相手側で切れてしまっていることもあります。古い接続を使い回そうとしてエラーになるのもよくあるトラブルです。適切な「電話の台数」と「点検の頻度」を決めることが、Flaskアプリの安定稼働には欠かせないのです。これを「チューニング」や「最適化」と呼びます。

3. Flask-SQLAlchemyでの基本設定

Flaskでデータベースを扱うときに最も有名な道具が「Flask-SQLAlchemy」です。これを使うと、プログラムの中に接続プールの設定を簡単に書き込むことができます。まずは、初心者が最初に覚えるべき基本的な設定コードを見てみましょう。


from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
# データベースの場所を指定（例：SQLite）
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///example.db'

# 接続プールの設定
# pool_size: キープしておく電話の台数（通常5台から10台程度）
# max_overflow: 忙しい時に一時的に追加できる電話の台数
app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    'pool_size': 10,
    'max_overflow': 20
}

db = SQLAlchemy(app)

この設定により、普段は10個の接続を確保し、急にアクセスが増えたときだけ追加で20個まで接続を増やす、という柔軟な対応ができるようになります。これにより、急なアクセス集中でもサイトが止まりにくくなります。

4. 接続のタイムアウトとリサイクル設定

次に大切なのが、つながりっぱなしの接続を「いつリフレッシュするか」という設定です。データベース側には「一定時間、通信がない接続は勝手に切る」というルールがあることが多いです。これを知らずに、Flask側で古い接続を使い続けようとするとエラーが発生します。

そこで、pool_recycle という設定を使います。これは「一定時間が経ったら、新しい接続に交換する」という点検ルールです。また、pool_timeout は「電話が空くのを何秒待つか」を指定します。


app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    'pool_size': 5,
    'pool_recycle': 3600,  # 1時間ごとに接続を新しくする
    'pool_timeout': 30     # 空きがないときは30秒待つ
}

この設定を入れておけば、「朝からつなぎっぱなしの電話が実は切れていた」といった事態を防ぐことができ、アプリの信頼性が格段に向上します。

5. 接続が生きているか確認する機能

さらに慎重に安定させたい場合は、電話をユーザーに貸し出す直前に「もしもし、まだ聞こえますか？」と確認する機能を追加できます。これを pool_pre_ping と呼びます。これを True（有効）にするだけで、切れた接続を自動的に検知して作り直してくれます。


app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    'pool_size': 10,
    'pool_pre_ping': True  # 使う前に接続チェックを行う魔法の設定
}

通信環境が少し不安定な海外のサーバーや、クラウドサービスを利用している場合には、この「事前の生存確認」が非常に強力な助けになります。エラー画面を出す前にシステムが裏側で修復してくれるようになるからです。

6. 接続を使い終わったら「返す」のを忘れずに

接続プールを最適化しても、借りた電話を返さないユーザーがいたら、すぐに予備がなくなってしまいます。プログラミングでは、データベースの処理が終わったあとに「接続を閉じる」という作業が必要です。Flask-SQLAlchemyはこれを自動で行ってくれますが、自分で特殊な処理を書くときは注意が必要です。


@app.teardown_appcontext
def shutdown_session(exception=None):
    # アプリの処理が終わるたびに、データベース接続をプールにお返しする
    db.session.remove()

この teardown_appcontext という機能は、一つの注文（リクエスト）が終わるたびに「後片付け」を自動で実行してくれます。机の上を綺麗にしてから次の注文を受けることで、メモリ不足などのパフォーマンス低下を防ぐことができます。

7. 実際の接続数を確認する方法

設定がうまくいっているか不安なときは、データベース側から「今、何台の電話がつながっているか」を確認してみましょう。例えば、多くの開発現場で使われる「PostgreSQL」というデータベースなら、次のような命令（SQL）で現在の接続数を知ることができます。


SELECT count(*) FROM pg_stat_activity;

Flaskアプリを動かしながらこの数字をチェックして、自分が設定した pool_size 通りの数字になっているかを確認しましょう。もし、アプリを動かしていないのに数字が増え続けているなら、どこかで「電話の返し忘れ」が起きているサインです。

8. アプリの規模に合わせた推奨設定

「結局、何台に設定すればいいの？」と迷うかもしれません。目安としては、最初は pool_size=5 くらいから始めるのが安全です。小規模な個人ブログならこれで十分です。もし、1秒間に何十人もアクセスしてくるような人気サイトであれば、10から20程度に増やしてみましょう。

ただし、データベース側の最大接続数（Max Connections）も確認してください。例えば、データベースが100台までしか受け付けないのに、Flask側で「100台キープする」と設定すると、それだけで満杯になってしまい、管理用の操作すらできなくなってしまいます。常に全体の8割くらいに収めるのが、運用のコツです。