okpy

Pythonエンジニア兼テックリーダーが、多くのプロジェクトとチーム運営から得た実践的な知識を共有するブログです。

PythonでMySQLを操る：まだ手動でデータを管理して消耗していませんか？

lib python

PythonでMySQLを操る：まだ手動でデータを管理して消耗していませんか？

📝 TL;DR (3行要約) - PyMySQLとは？: PythonからMySQLデータベースに接続し、データの保存・取得・更新を自由自在に行うための「純粋なPython製」ライブラリです。 - いつ使う？: Webアプリのユーザー情報管理、スクレイピングデータの蓄積、業務自動化でのログ記録など、永続的なデータ管理が必要なあらゆる場面で活躍します。 - 利点は？: C言語のコンパイラが不要でインストールが非常に簡単であり、標準的なSQL文を使って直感的にデータベースを操作できる点にあります。

1. 🤔 一体PyMySQLとは何？（核心的な役割と主な使用例）

核心的な役割：PythonとMySQLを繋ぐ「専属の通訳者」

プログラミングを学び始めたばかりの頃、データは変数やリスト、辞書に保存するでしょう。しかし、プログラムを終了すればそのデータは消えてしまいます。そこで登場するのが「データベース（MySQLなど）」です。

PyMySQLの役割を比喩で表現するなら、「Pythonという大統領」と「MySQLという巨大な図書館の館長」の間を取り持つ「熟練の通訳者」です。

Python（大統領）が「新しいユーザー情報を登録してくれ」と日本語（Pythonコード）で命令しても、MySQL（館長）はSQLという独自の言語しか理解できません。PyMySQLはこの間に入り、Pythonの命令をSQLに翻訳してMySQLに伝え、MySQLからの返答（検索結果など）をPythonが扱いやすい形式に変換して戻してくれるのです。

特にPyMySQLが優れているのは、「Pure Python（純粋なPython）」で書かれている点です。他のライブラリでは、インストール時に複雑な設定やC言語のコンパイルが必要になることがありますが、PyMySQLは「pip install」一つで、どんな環境でもすぐに「通訳者」として働き始めてくれます。

主な使用例：PyMySQLが真価を発揮するシーン

このライブラリは、単なるデータの保存以上の価値を提供します。代表的な活用シーンを挙げてみましょう。

  1. Webアプリケーションのバックエンド（会員管理システム） ユーザーが会員登録フォームに入力した名前やパスワードを、Pythonを通じてMySQLデータベースに安全に保存します。ログイン時には、入力された情報がデータベースにあるものと一致するかをPyMySQL経由で照合します。DjangoやFlaskといったフレームワークと組み合わせて、動的なサイトを作る際の心臓部となります。

  2. データ分析・スクレイピング結果の蓄積 Webサイトから収集した大量の価格情報やニュース記事を、CSVファイルで管理するのは限界があります。PyMySQLを使えば、数万、数百万件のデータを構造化してデータベースに格納できます。一度保存してしまえば、後から「特定の期間のデータだけを抽出する」といった操作も一瞬で行えるようになります。

  3. 業務自動化（RPA）における実行ログの記録 毎日実行する自動化プログラムが、「いつ」「どのタスクを」「成功させたか失敗させたか」という履歴をMySQLに残すことができます。これにより、後からエラーの原因を特定したり、月間の処理件数を集計してレポートを作成したりすることが容易になります。

2. 💻 インストール方法

PyMySQLの導入は非常にシンプルです。ターミナル（WindowsならコマンドプロンプトやPowerShell、Macならターミナル）を開き、以下のコマンドを入力してください。

pip install PyMySQL

もし、特定のプロジェクト環境で実行している場合は、仮想環境（venvなど）が有効になっていることを確認してから実行しましょう。これだけで、あなたのPython環境に強力な「データベース操作能力」が備わります。

3. 🛠️ 実際に動作するサンプルコード

ここでは、データベースへの接続から、テーブルの作成、データの挿入、そして検索までの一連の流れを網羅したコードを紹介します。

※実行前に、MySQLサーバーが起動しており、操作権限のあるユーザーが存在することを確認してください。

import pymysql

# 1. データベースへの接続設定
connection = pymysql.connect(
    host='localhost',
    user='your_username',      # あなたのMySQLユーザー名に書き換えてください
    password='your_password',  # あなたのMySQLパスワードに書き換えてください
    database='test_db',        # あらかじめ作成したデータベース名
    charset='utf8mb4',
    cursorclass=pymysql.cursors.DictCursor
)

try:
    # 2. カーソル（操作用の窓口）の作成
    with connection.cursor() as cursor:
        # 3. テーブルの作成（存在しない場合のみ）
        create_table_sql = """
        CREATE TABLE IF NOT EXISTS users (
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100) NOT NULL,
            email VARCHAR(100) UNIQUE NOT NULL,
            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
        )
        """
        cursor.execute(create_table_sql)
        print("✅ テーブルの準備が完了しました。")

        # 4. データの挿入（プレースホルダを使用）
        insert_sql = "INSERT INTO users (name, email) VALUES (%s, %s)"
        user_data = ("Python初心者", "beginner@example.com")
        cursor.execute(insert_sql, user_data)
        
        # 5. 変更を確定させる（重要！）
        connection.commit()
        print(f"✅ データを挿入しました：{user_data[0]}")

        # 6. データの検索
        select_sql = "SELECT id, name, email FROM users WHERE name = %s"
        cursor.execute(select_sql, ("Python初心者",))
        result = cursor.fetchone()
        
        if result:
            print(f"🔍 検索結果: ID={result['id']}, 名前={result['name']}, メール={result['email']}")

except Exception as e:
    # エラーが発生した場合はロールバック（変更を取り消し）
    connection.rollback()
    print(f"❌ エラーが発生しました: {e}")

finally:
    # 7. 接続を閉じる
    connection.close()
    print("🔌 データベースとの接続を終了しました。")

4. 🔍 コードの詳細説明

初心者の方が特に理解しておくべきポイントを、意味のある塊（チャンク）ごとに解説します。

① 接続の確立 (pymysql.connect)

まず最初に行うのが、MySQLサーバーへの「電話をかける」ような作業です。host, user, password, database などの情報を渡して、通信経路を確保します。ここで注目したいのが cursorclass=pymysql.cursors.DictCursor です。これをつけることで、検索結果を「リストの中の辞書形式」で受け取れるようになり、result['name'] のように直感的にデータを扱えるようになります。

② カーソル (cursor) の生成と操作

cursor（カーソル）は、データベースに対してSQL命令を運ぶ「トレイ」のようなものです。with 構文を使うことで、操作が終わった後に自動的にカーソルを閉じてくれるため、メモリの無駄遣いを防ぐことができます。cursor.execute() メソッドにSQL文を渡すことで、実際にデータベースが動きます。

③ データの挿入とコミット (commit)

ここが最も重要なポイントの一つです。データの追加、更新、削除（INSERT, UPDATE, DELETE）を行った際、execute() を呼んだだけではデータベースに恒久的には反映されません。connection.commit() を呼び出すことで初めて、変更が「確定」します。これを忘れると、プログラム上は成功したように見えても、データベースを覗くと何も変わっていないという事態に陥ります。

④ プレースホルダによる安全な実行

サンプルコードの insert_sql で %s を使っている部分に注目してください。これは「プレースホルダ」と呼ばれます。変数の中身を直接SQL文に埋め込むのではなく、PyMySQLに安全に流し込んでもらう手法です。これにより、後述する「SQLインジェクション」という重大なセキュリティリスクを回避できます。

⑤ 例外処理と接続の終了 (try-except-finally)

データベース操作は、ネットワークエラーやパスワード間違いなど、予期せぬトラブルが起こりやすい領域です。try-except でエラーをキャッチし、問題があれば rollback() で中途半端な変更を破棄します。そして最後に finally で必ず connection.close() を行い、リソースを解放するのがプロの開発者の作法です。

5. ⚠️ 注意点またはヒント

初心者が陥りやすい罠は、主に「セキュリティ」と「接続管理」に集中しています。

🚨 罠：SQLインジェクションに注意！

絶対にやってはいけないのが、以下のようなコードです。

# ❌ 非常に危険な例
user_input = "hacker' OR '1'='1"
sql = f"SELECT * FROM users WHERE name = '{user_input}'"
cursor.execute(sql)

このように文字列のフォーマット（f-stringなど）でSQLを組み立てると、悪意のある入力によってデータベースの中身を全て盗まれたり、破壊されたりする「SQLインジェクション」という攻撃を受けてしまいます。必ず cursor.execute(sql, (value1, value2)) の形式で、第2引数にデータを渡すように徹底してください。

💡 ヒント：コネクションプールを意識しよう

小規模なスクリプトなら毎回接続して閉じる方法で問題ありませんが、アクセスが多いWebアプリなどでこれをやると、接続のオーバーヘッドで動作が重くなります。将来的に「遅いな」と感じたら、接続を使い回す「コネクションプール」という概念を調べてみてください。PyMySQL単体ではなく、後述するSQLAlchemyなどを使うと簡単に実現できます。

6. 🔗 一緒に見ておくと良いライブラリ

PyMySQLをマスターした次に学ぶべきは、「SQLAlchemy（エスキューエル・アルケミー）」です。

PyMySQLはSQLを直接書く必要がありますが、SQLAlchemyは「ORM（Object Relational Mapper）」と呼ばれるツールで、SQLを意識せずにPythonのオブジェクトを操作する感覚でデータベースを扱えるようになります。

  • なぜ学ぶべきか？: 実務のプロジェクトでは、生のSQLを書くよりもSQLAlchemyのようなORMを使う方が保守性が高く、コードも綺麗になるためです。PyMySQLはSQLAlchemyの「裏側（エンジン）」として動くことが多いので、先にPyMySQLを学んだ今のあなたなら、SQLAlchemyの仕組みもスムーズに理解できるはずです。

7. 🎉 まとめ

本日は、PythonからMySQLを自由自在に操るための強力なツール「PyMySQL」について学びました。

  • PyMySQLは、PythonとMySQLを繋ぐ軽量で強力なブリッジです。
  • インストールは簡単で、複雑な環境構築も不要です。
  • 基本の流れは「接続 → カーソル作成 → SQL実行 → コミット → 終了」の5ステップです。
  • セキュリティのために、必ずプレースホルダ（%s）を使いましょう。

さて、知識を定着させるために一つ「挑戦課題」を出します！

【今日の挑戦課題】

サンプルコードを参考に、「住所録プログラム」を作ってみてください。> 1. address_book というテーブルを作る。> 2. ユーザーから「名前」と「電話番号」を input() で受け取る。> 3. 受け取ったデータを PyMySQL でデータベースに保存する。> 4. 保存された全データを画面に表示する。

これができれば、あなたはもう「データを永続的に管理できるPython開発者」の仲間入りです。一歩ずつ、着実にスキルアップしていきましょう！応援しています！

🔖 推奨タグ (ハッシュタグ)

  • Web開発

  • PyMySQL