エラー処理

データベース操作では、様々な動的なエラー(実行しないと検知できないエラー)が発生する可能性があります。

  • MySQLが未起動で接続できない
  • 指定したデータベースやテーブルが存在しない
  • SQLの文法が誤っている
  • 型が合わない値を挿入しようとした

これらのエラーに適切に対処するため、try/except文でエラー処理を実装します。main.pyを以下の内容に書き換えます。

import mysql.connector

try:
    # データベースに接続
    connection = mysql.connector.connect(
        host="localhost",
        port=3306,
        user="root",
        password="your_password",
        database="testdb"
    )

    # カーソルを取得
    cursor = connection.cursor()

    # SELECTの実行
    cursor.execute("SELECT id, name, age FROM users")

    # 結果の取得と出力
    rows = cursor.fetchall()
    for row in rows:
        print(f"id: {row[0]}, name: {row[1]}, age: {row[2]}")

except mysql.connector.Error as e:
    print(f"データベース操作でエラーが発生しました: {e}")

finally:
    # リソースの解放
    if 'cursor' in dir() and cursor is not None:
        cursor.close()
    if 'connection' in dir() and connection.is_connected():
        connection.close()
        print("接続を閉じました")

追加したコードを解説します。

try:

tryブロックには、エラーが発生する可能性のある処理を記述します。データベース接続、SQL実行、結果の読み込みなどの処理がこれに該当します。

except mysql.connector.Error as e:
    print(f"データベース操作でエラーが発生しました: {e}")

exceptブロックには、エラーが発生した場合の処理を記述します。mysql.connector.Errorを指定することで、MySQL関連のエラーをキャッチできます。変数eにエラーの詳細情報が格納されます。

finally:
    if 'cursor' in dir() and cursor is not None:
        cursor.close()
    if 'connection' in dir() and connection.is_connected():
        connection.close()
        print("接続を閉じました")

finallyブロックには、エラーの有無にかかわらず必ず実行したい処理を記述します。リソースの解放処理をここに書くことで、エラーが発生した場合でも確実にリソースが解放されます。if 'cursor' in dir()で変数が存在するかを確認してからclose()を呼んでいるのは、接続自体が失敗した場合にカーソルが作成されていない可能性があるためです。

1. エラーの動作確認

エラー処理が正しく動作するか確認するために、わざと誤ったパスワードを指定してプログラムを実行してみます。上記のコードのpasswordを以下のように書き換えてください。

password="wrong_password"

main.py を実行します。以下のようなエラーメッセージが表示されます。

データベース操作でエラーが発生しました: 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

Access deniedというメッセージから、パスワードが誤っているために接続が拒否されたことがわかります。try/exceptにより、プログラムがクラッシュせずにエラーメッセージを表示できていることを確認してください。

確認が終わったら、passwordを正しい値に戻しておきます。

password="your_password"