エラー処理
データベース操作では、様々な動的なエラー(実行しないと検知できないエラー)が発生する可能性があります。
- 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"