MySQL Python 接続と使用

MySQL は最も人気のあるオープンソースのリレーショナルデータベースの一つであり、Python は今日最も人気のあるプログラミング言語の一つです。Python と MySQL を組み合わせて使用することで、データベース駆動のアプリケーションを簡単に開発できます。

この記事では、Python を使用して MySQL データベースに接続し操作する方法を詳しく説明します。内容は次のとおりです。

  1. MySQL Python ドライバのインストール方法
  2. データベース接続の確立とクローズ
  3. さまざまな SQL クエリの実行
  4. トランザクション管理とエラー処理
  5. データベース操作のベストプラクティス

事前準備

必要なソフトウェアのインストール

始める前に、以下のソフトウェアがインストールされていることを確認してください。

  • Python(3.6 以降を推奨)
  • MySQL Server(コミュニティ版で十分です)
  • MySQL Connector/Python(Python 用 MySQL ドライバ)

MySQL Connector/Python のインストール

MySQL 公式の Python ドライバは pip でインストールできます:

pip install mysql-connector-python

または、PyMySQL (もう一つの人気のある MySQL Python ドライバ) をインストールします:

pip install pymysql

MySQL データベースへの接続

基本接続の確立

以下はmysql-connector-pythonデータベース接続を確立するための基本コード:

例

import mysql.connector

# 创建数据库连接
db = mysql.connector.connect(
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
)

print("数据库连接成功!")

接続パラメータの説明

  • host: MySQL サーバーのアドレス (ローカルは "localhost")
  • user: データベースのユーザー名
  • password: ユーザーパスワード
  • database: 接続するデータベース名 (オプション)

PyMySQL を使用した接続

PyMySQL を使用する場合は、接続方法が少し異なります:

例

import pymysql

# 创建数据库连接
db = pymysql.connect(
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
)

print("数据库连接成功!")

SQL クエリの実行

カーソルオブジェクトの作成

SQL 文を実行する前に、カーソル (cursor) オブジェクトを作成する必要があります:

例

cursor = db.cursor()

SELECT クエリの実行

例

cursor.execute("SELECT * FROM your_table")

# 获取所有结果
results = cursor.fetchall()

for row in results:
    print(row)

INSERT、UPDATE、DELETE 操作の実行

例

# 插入数据
sql = "INSERT INTO users (name, age) VALUES (%s, %s)"
values = ("张三", 25)
cursor.execute(sql, values)

# 提交事务
db.commit()

print(cursor.rowcount, "条记录插入成功")

パラメータ化クエリの使用

SQL インジェクションを防ぐために、常にパラメータ化クエリを使用する必要があります:

例

sql = "SELECT * FROM users WHERE name = %s"
name = ("张三",)
cursor.execute(sql, name)

トランザクション管理

トランザクションの基本概念

MySQL トランザクションは、一連の原子的な SQL クエリであり、すべてが成功するか、すべてが実行されないかのどちらかです。

トランザクションの使用

例

try:
    # 开始事务
    cursor.execute("START TRANSACTION")
   
    # 执行多个SQL语句
    cursor.execute("UPDATE accounts SET balance = balance - 100 WHERE id = 1")
    cursor.execute("UPDATE accounts SET balance = balance + 100 WHERE id = 2")
   
    # 提交事务
    db.commit()
    print("事务执行成功")
except Exception as e:
    # 发生错误,回滚事务
    db.rollback()
    print("事务执行失败:", e)

エラー処理

データベースエラーの捕捉

例

try:
    cursor.execute("SELECT * FROM non_existent_table")
except mysql.connector.Error as err:
    print("数据库错误:", err)

よくあるエラーコード

  • 1045: アクセスが拒否されました (ユーザー名またはパスワードが間違っています)
  • 1049: 不明なデータベース
  • 1146: テーブルが存在しません
  • 1062: 重複するキー値

接続のクローズ

接続を正しく閉じる

データベース操作が完了したら、カーソルと接続を閉じる必要があります:

例

cursor.close()
db.close()
print("数据库连接已关闭")

with 文の使用

Python のwithwith 文はリソースを自動的に管理できます:

例

with mysql.connector.connect(
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
) as db:
    with db.cursor() as cursor:
        cursor.execute("SELECT * FROM users")
        results = cursor.fetchall()
        for row in results:
            print(row)
# 离开with块后连接会自动关闭

ベストプラクティス

コネクションプール

データベースに頻繁に接続するアプリケーションでは、コネクションプールの使用をお勧めします:

例

from mysql.connector import pooling

# 创建连接池
db_pool = pooling.MySQLConnectionPool(
    pool_name="mypool",
    pool_size=5,
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
)

# 接続プールから接続を取得
db = db_pool.get_connection()

ORM フレームワーク

複雑なアプリケーションでは、SQLAlchemy や Django ORM などの ORM (オブジェクト関係マッピング) フレームワークの使用を検討できます。


その他の拡張