ORMとは

データベースを操作する方法には、SQLを直接記述する方法とORM(Object-Relational Mapping)を使う方法の2つがあります。

SQLを直接記述する方法では、PythonコードからSQL文字列をmysql-connectorなどのライブラリに渡し、データベースを操作します。一方、ORMを使う方法では、PythonコードからPythonオブジェクトを操作するだけで、ORMが自動的にSQLを生成してデータベースを操作します。

前の章Pythonでデータベースを操作しようでは、mysql-connector-pythonを使ってSQLを直接記述し、データベースを操作してきました。例えば、ユーザの一覧を取得するには以下のようなコードを書きました。

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]}")

この方法では、SQL文を文字列として記述し、取得した結果もタプルのリストとして扱います。データへのアクセスはrow[0]、row[1]のようにインデックスで行うため、どのカラムの値かがコードから読み取りにくい面があります。

ORM(Object-Relational Mapping)は、データベースのテーブルをPythonのクラスに、レコードをクラスのインスタンスに対応させる仕組みです。ORMを使うと、SQLを直接書く代わりにPythonのコードでデータベースを操作できるようになります。同じ処理を以下のように記述できます。

users = session.exec(select(User)).all()
for user in users:
    print(f"id: {user.id}, name: {user.name}, age: {user.age}")

SQLを直接書く代わりにPythonのコードでデータベースを操作でき、user.nameのように属性名でデータにアクセスできます。

1. ORMのメリット

ORMを使うことで、いくつかのメリットがあります。

まず、SQLを直接書かなくてよいという点です。Pythonの文法でデータベース操作を記述できるため、SQLの記法を意識する必要がありません。

次に、型安全である点です。型ヒントにより、エディタの補完やエラー検知が利用できます。

また、SQLインジェクション対策にもなります。ORMがクエリを自動生成するため、パラメータ化クエリを手動で記述する必要がありません。

💡 ポイント
ORMは便利な仕組みですが、SQLの知識が不要になるわけではありません。ORMが生成するSQLを理解したり、パフォーマンスの問題を調査したりする際には、SQLの基礎知識が役立ちます。前の章でSQLの基本を学んだことは、ORMを使う上でも大きなアドバンテージになります。

2. SQL直接記述とORMの比較

SQL直接記述とORMの違いを以下の表にまとめます。

項目 SQL直接記述(mysql-connector) ORM(SQLModel)
データベース操作の記述 SQL文字列を直接記述する Pythonオブジェクトを操作する
SQLの知識 必須 基本的には不要(ORMが自動生成)
型チェック なし(文字列のため) あり(型ヒントによる補完・検知)
SQLインジェクション対策 手動でパラメータ化が必要 ORMが自動的に対策する
学習コスト SQLの知識があればすぐに使える ORM固有のAPIを学ぶ必要がある
📝 SQLインジェクションとは
SQLインジェクションとは、ユーザの入力値にSQL文を埋め込むことで、意図しないデータベース操作を実行させる攻撃手法です。例えば、ログインフォームの入力欄に' OR 1=1 --のような文字列を入力すると、本来のSQL文の条件が書き換えられ、認証を突破されたりデータを不正に取得されたりする危険があります。SQL直接記述の場合はプレースホルダ(%sや?)を使って入力値を安全に埋め込む必要がありますが、ORMを使う場合はクエリの生成が自動化されるため、この対策が不要になります。