Python×MariaDB完全ガイド｜インストール・接続・CRUD操作・エラーハンドリング

By 佐川 直弘 | Naohiro Sagawa (運営者)

※記事内に広告を含みます。Amazonアソシエイトとして適格販売により収入を得ています。　

1. はじめに

PythonでMariaDBを操作したい方へ

Pythonを使ってMariaDBに接続し、データの操作を行いたいと考えている方は多いでしょう。本記事では、Pythonを使用してMariaDBを操作するための基礎から応用までを詳しく解説します。

こんな悩みはありませんか？

• PythonからMariaDBに接続する方法がわからない
• データの追加・取得・更新・削除をPythonで簡単に操作したい
• よくあるエラーとその対処法を知りたい

本記事で学べること

• MariaDBにPythonから簡単に接続する方法
• CRUD（データの追加・取得・更新・削除）の実装方法
• よくあるエラーとその解決策
• トランザクション処理でデータの整合性を守る方法

本記事を読めば、Pythonを使ってMariaDBをスムーズに扱えるようになります。それでは、具体的な内容を見ていきましょう。

2. 環境の準備（MariaDB & Pythonのインストール）

MariaDBとは？

MariaDBは、オープンソースのリレーショナルデータベース管理システム（RDBMS）であり、MySQLの後継として広く利用されています。MySQLと高い互換性を持ちつつ、パフォーマンスの向上や新機能の追加が行われています。

必要なツール

PythonでMariaDBを扱うためには、以下のツールを準備する必要があります。

• Python（バージョン3.x以上推奨）
• MariaDB（サーバー）
• MariaDBのPythonコネクタ（mariadbライブラリ）

MariaDBのインストール手順（OS別）

Windowsの場合

1. 公式サイトからMariaDBのインストーラーをダウンロード。
2. インストーラーを実行し、指示に従ってインストール。
3. インストール後、以下のコマンドでMariaDBの動作を確認。

mysql -u root -p

4. 正常にログインできれば、インストール完了。

Macの場合

MacではHomebrewを使用して簡単にMariaDBをインストールできます。

1. Homebrewがインストールされていない場合は、以下のコマンドでインストール。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. MariaDBをインストール。

brew install mariadb

3. MariaDBを起動。

brew services start mariadb

4. インストールの確認。

mysql -u root -p

Linux（Ubuntu）の場合

1. パッケージリストを更新し、MariaDBをインストール。

sudo apt update
sudo apt install mariadb-server mariadb-client

2. MariaDBを起動。

sudo systemctl start mariadb

3. MariaDBを有効化（起動時に自動起動するように設定）。

sudo systemctl enable mariadb

4. MariaDBの設定を行う。

sudo mysql_secure_installation

これにより、rootパスワードの設定や不要なデフォルト設定の削除ができます。

Pythonと必要なライブラリのインストール

MariaDBとPythonを連携するには、mariadbライブラリをインストールする必要があります。

1. pipを使用してmariadbライブラリをインストール。

pip install mariadb

2. インストールの確認。

import mariadb
print("MariaDBライブラリが正常にインストールされました。")

エラーが出なければ、インストールは成功しています。

これでPythonとMariaDBを連携させるための環境準備が完了しました。次は、PythonからMariaDBへ接続する方法を解説します。

3. MariaDBへの接続

MariaDBにPythonで接続する方法

必要なライブラリのインポート

MariaDBに接続するために、Pythonのmariadbライブラリをインポートします。

import mariadb

データベースへ接続する基本コード

以下のコードは、PythonでMariaDBに接続する基本的な方法を示しています。

import mariadb

# データベース接続情報
config = {
    "host": "localhost",   # MariaDBサーバーのホスト名
    "user": "root",        # MariaDBのユーザー名
    "password": "password", # MariaDBのパスワード
    "database": "sample_db" # 接続するデータベース名
}

try:
    # MariaDBに接続
    conn = mariadb.connect(**config)
    print("MariaDBに接続しました！")

    # カーソルを作成
    cursor = conn.cursor()

    # 接続が成功したら、接続を閉じる
    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"接続エラー: {e}")

connect() 関数の引数について

サーバーがリモートにある場合は、host にIPアドレスやドメイン名を指定します。

環境変数を使用したセキュアな接続方法

パスワードなどの機密情報をコード内に直接記述するのはセキュリティ上危険です。環境変数を利用することで、より安全に管理できます。

python-dotenv のインストール

まず、環境変数を管理するためのライブラリをインストールします。

pip install python-dotenv

.env ファイルを作成し、接続情報を記述

プロジェクトフォルダに .env ファイルを作成し、次のように接続情報を記述します。

DB_HOST=localhost
DB_USER=root
DB_PASSWORD=password
DB_NAME=sample_db

Pythonスクリプトで環境変数を読み込む

Pythonスクリプト内で .env ファイルを読み込むには、以下のように記述します。

import mariadb
import os
from dotenv import load_dotenv

# .envファイルを読み込む
load_dotenv()

config = {
    "host": os.getenv("DB_HOST"),
    "user": os.getenv("DB_USER"),
    "password": os.getenv("DB_PASSWORD"),
    "database": os.getenv("DB_NAME")
}

try:
    conn = mariadb.connect(**config)
    print("MariaDBにセキュアに接続しました！")
    conn.close()
except mariadb.Error as e:
    print(f"接続エラー: {e}")

よくある接続エラーとその対処法

PythonとMariaDBの接続時に発生する可能性があるエラーとその解決策を紹介します。

Access denied for user 'root'@'localhost'

エラー内容

mariadb.OperationalError: Access denied for user 'root'@'localhost' (using password: YES)

原因

• ユーザーの認証情報が間違っている
• MariaDBの認証設定が適切でない

解決策

1. MariaDBにログインし、ユーザーの権限を確認する。

mysql -u root -p

2. 必要な権限をユーザーに付与する。

GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
FLUSH PRIVILEGES;

3. 再度接続を試みる。

Can't connect to MySQL server on 'localhost'

エラー内容

mariadb.OperationalError: Can't connect to MySQL server on 'localhost' (10061)

原因

• MariaDBサーバーが起動していない
• host の設定が間違っている

解決策

1. サーバーが起動しているか確認。

sudo systemctl status mariadb

2. サーバーが停止している場合は起動する。

sudo systemctl start mariadb

3. host の設定が正しいか確認。

まとめ

このセクションでは、PythonからMariaDBへ接続する方法について解説しました。

• mariadb.connect() を使用した基本的な接続方法
• .env ファイルを活用したセキュアな接続方法
• よくある接続エラーとその対策

4. データベースとテーブルの作成

データベースの作成

MariaDBでは、データを保存するための「データベース」を作成する必要があります。Pythonを使ってデータベースを作成する方法を見ていきましょう。

MariaDB管理ツールでデータベースを作成する

MariaDBのコマンドライン（または MySQL Workbench などのGUIツール）を使って、データベースを作成できます。

CREATE DATABASE sample_db;

作成したデータベースの一覧を確認するには、以下のコマンドを使用します。

SHOW DATABASES;

Pythonを使ってデータベースを作成する

Pythonを使ってデータベースを作成する場合、以下のコードを実行します。

import mariadb

# データベース接続（データベース指定なし）
config = {
    "host": "localhost",
    "user": "root",
    "password": "password"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # データベースの作成
    cursor.execute("CREATE DATABASE IF NOT EXISTS sample_db")

    print("データベース 'sample_db' を作成しました。")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")

IF NOT EXISTS を付けることで、既に同じ名前のデータベースが存在する場合にエラーを防げます。

テーブルの作成

データベースが作成できたら、次にデータを格納する テーブル を作成します。

テーブルの基本構造

テーブルは、以下のような構造を持ちます。

SQLでテーブルを作成

MariaDBのSQLコマンドを使ってテーブルを作成する場合は、以下のように記述します。

USE sample_db;

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    email VARCHAR(100) UNIQUE NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

テーブルの一覧を確認するには、次のコマンドを使用します。

SHOW TABLES;

Pythonを使ってテーブルを作成

Pythonスクリプトを使用して、同じテーブルを作成する方法を紹介します。

import mariadb

# データベース接続
config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # テーブル作成SQL
    table_creation_query = """
    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 DATETIME DEFAULT CURRENT_TIMESTAMP
    )
    """

    cursor.execute(table_creation_query)
    print("テーブル 'users' を作成しました。")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")

IF NOT EXISTS を付けることで、テーブルが既に存在する場合にエラーを防ぎます。

データ型の選び方

テーブル設計を行う際、適切なデータ型を選択することが重要です。MariaDBでよく使われるデータ型を以下にまとめました。

例えば、name フィールドには VARCHAR(100) を使うのが一般的ですが、より長い文字列が必要な場合は TEXT を使用するのも良い選択です。

既存のテーブルを確認・削除する方法

既存のテーブルを確認する

データベース内のテーブルを確認するには、以下のSQLを使用します。

SHOW TABLES;

また、テーブルの詳細な構造を確認する場合は、DESCRIBE コマンドを実行します。

DESCRIBE users;

テーブルを削除する

テーブルを削除するには、DROP TABLE を使用します。

DROP TABLE users;

Pythonから削除する場合は、以下のコードを実行します。

cursor.execute("DROP TABLE IF EXISTS users")

まとめ

このセクションでは、MariaDBでデータを格納するためのデータベースとテーブルの作成方法について解説しました。

• MariaDBのデータベースを作成する方法
• Pythonを使ってテーブルを作成する方法
• 適切なデータ型の選び方
• 既存のテーブルの確認・削除方法

これでMariaDBの基本的なセットアップが完了しました。次のセクションでは、 CRUD操作（データの追加・取得・更新・削除） について詳しく解説します。

5. CRUD操作（データの追加・取得・更新・削除）

MariaDBのデータベースとテーブルの作成が完了したら、次は CRUD操作 を行います。CRUDとは、Create（作成）・Read（取得）・Update（更新）・Delete（削除） の頭文字を取ったもので、データベースの基本的な操作を指します。

このセクションでは、Pythonを使用してMariaDBのデータを操作する方法を解説します。

データの追加（INSERT）

データベースに新しいレコードを追加するには、INSERT 文を使用します。

SQLによるデータ追加

MariaDBのSQLでデータを追加する場合、以下のコマンドを実行します。

INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');

追加したデータを確認するには、SELECT 文を使用します。

SELECT * FROM users;

Pythonでデータを追加する

Pythonを使用してデータを追加する場合、以下のコードを実行します。

import mariadb

# データベース接続設定
config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # データの挿入
    insert_query = "INSERT INTO users (name, email) VALUES (?, ?)"
    data = ("Alice", "alice@example.com")
    cursor.execute(insert_query, data)

    # 変更を保存
    conn.commit()
    print("データを追加しました！")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")

ポイント:

• ? プレースホルダーを使うことで、SQLインジェクションを防ぐことができます。
• conn.commit() を実行しないと、データがデータベースに保存されません。

データの取得（SELECT）

登録したデータを取得するには、SELECT 文を使用します。

SQLによるデータ取得

MariaDBのSQLを使ってデータを取得する方法は以下の通りです。

SELECT * FROM users;

条件を指定して取得する場合、WHERE 句を使用します。

SELECT * FROM users WHERE email = 'alice@example.com';

Pythonでデータを取得する

Pythonを使用してデータを取得するには、以下のコードを実行します。

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # データ取得
    select_query = "SELECT id, name, email FROM users"
    cursor.execute(select_query)

    # 取得したデータを表示
    for (id, name, email) in cursor:
        print(f"ID: {id}, 名前: {name}, メール: {email}")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")

ポイント:

• cursor.execute(select_query) でSQLを実行し、cursor オブジェクトからデータを取得します。
• for ループを使ってデータを1件ずつ処理できます。

データの更新（UPDATE）

登録されたデータを変更する場合は、UPDATE 文を使用します。

SQLによるデータ更新

MariaDBのSQLを使ってデータを更新する場合、以下のコマンドを実行します。

UPDATE users SET name = 'Alice Smith' WHERE email = 'alice@example.com';

Pythonでデータを更新する

Pythonを使ってデータを更新するには、以下のコードを実行します。

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # データの更新
    update_query = "UPDATE users SET name = ? WHERE email = ?"
    data = ("Alice Smith", "alice@example.com")
    cursor.execute(update_query, data)

    # 変更を保存
    conn.commit()
    print("データを更新しました！")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")

データの削除（DELETE）

不要なデータを削除するには、DELETE 文を使用します。

SQLによるデータ削除

MariaDBのSQLを使ってデータを削除するには、以下のコマンドを実行します。

DELETE FROM users WHERE email = 'alice@example.com';

Pythonでデータを削除する

Pythonを使ってデータを削除するには、以下のコードを実行します。

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # データの削除
    delete_query = "DELETE FROM users WHERE email = ?"
    data = ("alice@example.com",)
    cursor.execute(delete_query, data)

    # 変更を保存
    conn.commit()
    print("データを削除しました！")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")

まとめ

このセクションでは、Pythonを使用してMariaDBのデータを操作する方法を解説しました。

• データの追加（INSERT）
• データの取得（SELECT）
• データの更新（UPDATE）
• データの削除（DELETE）

これでPythonを使ってMariaDBの基本的なデータ操作を行うことができるようになりました。

6. トランザクションとロールバック（データ整合性の確保）

データベースを操作する際、データの整合性 を保つために トランザクション を活用することが重要です。
特に、途中でエラーが発生した場合にデータを元の状態に戻す（ロールバック）機能 は、データの一貫性を維持する上で欠かせません。

このセクションでは、Pythonを使ってMariaDBでトランザクションを管理する方法を解説します。

トランザクションとは？

トランザクションとは、一連のデータベース操作を1つの単位としてまとめ、すべての処理が成功した場合にデータを確定（コミット）し、エラーが発生した場合にすべての変更を取り消す（ロールバック）仕組み です。

トランザクションの特徴

• ACID特性
• Atomicity（原子性） ：処理はすべて完了するか、全く行われないかのどちらかである。
• Consistency（一貫性） ：データは整合性を維持する。
• Isolation（独立性） ：同時に実行されるトランザクションは互いに影響を与えない。
• Durability（耐久性） ：処理が完了したら、その変更は永続的に保存される。

トランザクションの基本操作（COMMITとROLLBACK）

MariaDBのトランザクションは、以下のコマンドで制御できます。

Pythonでトランザクションを使う

Pythonを使用してMariaDBのトランザクションを管理する基本的なコードを紹介します。

複数のデータ操作を1つのトランザクションで管理

以下のコードでは、複数のデータを追加する処理を1つのトランザクションとして扱い、すべての処理が成功した場合にコミット（確定）します。

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # トランザクション開始
    conn.start_transaction()

    # データの追加
    cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Bob", "bob@example.com"))
    cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Charlie", "charlie@example.com"))

    # すべての処理が成功したらコミット（確定）
    conn.commit()
    print("データを正常に追加しました。")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"エラー発生: {e}")
    conn.rollback()  # エラーが発生した場合はロールバック（元に戻す）

ポイント

• conn.start_transaction() でトランザクションを開始。
• conn.commit() で変更を確定（確定後は元に戻せない）。
• エラーが発生した場合、conn.rollback() でデータの変更を取り消し、元の状態に戻す。

トランザクションを活用したエラーハンドリング

データベース操作では、途中でエラーが発生する可能性 があります。
例えば、メールアドレスが重複していた場合（UNIQUE制約違反） や サーバーがタイムアウトした場合 などが考えられます。

エラーハンドリング付きのトランザクション管理

次のコードは、途中でエラーが発生した場合にロールバックを実行し、データを元の状態に戻す処理 を追加しています。

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # トランザクション開始
    conn.start_transaction()

    try:
        # データの追加（1件目は成功）
        cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Dave", "dave@example.com"))

        # 2件目の処理でエラー発生（メールアドレスの重複）
        cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Eve", "dave@example.com"))

        # すべての処理が成功したらコミット
        conn.commit()
        print("データを追加しました。")

    except mariadb.Error as e:
        print(f"データ処理中にエラーが発生: {e}")
        conn.rollback()  # エラー発生時は変更を取り消す
        print("データをロールバックしました。")

    cursor.close()
    conn.close()

except mariadb.Error as e:
    print(f"データベース接続エラー: {e}")

まとめ

このセクションでは、トランザクションの基本とPythonを使った実装方法 について解説しました。

• トランザクションの重要性とACID特性
• Pythonで commit() と rollback() を使う方法
• エラーハンドリングを組み合わせたトランザクション管理

7. エラーハンドリング（よくあるエラーと対策）

MariaDBをPythonで操作する際、エラーが発生することがあります。
特に、データベースの接続エラー・SQL文のエラー・データの整合性に関するエラー などはよく発生するため、それぞれの原因と解決策を把握しておくことが重要です。

このセクションでは、よくあるエラーの発生原因とその対処法 を紹介します。

Access denied for user（ユーザー認証エラー）

エラー内容

mariadb.OperationalError: Access denied for user 'root'@'localhost' (using password: YES)

発生原因

• ユーザー名またはパスワードが間違っている
• MariaDBのユーザーに適切な権限が設定されていない

解決策

1. MariaDBにログインしてユーザー権限を確認

   mysql -u root -p

2. ユーザーの権限を設定

   GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
   FLUSH PRIVILEGES;

3. MariaDBを再起動

   sudo systemctl restart mariadb

Can't connect to MySQL server on 'localhost'（接続エラー）

エラー内容

mariadb.OperationalError: Can't connect to MySQL server on 'localhost' (10061)

発生原因

• MariaDBサーバーが起動していない
• host の設定が誤っている

解決策

1. MariaDBサーバーが動作しているか確認

   sudo systemctl status mariadb

2. サーバーが停止している場合は起動

   sudo systemctl start mariadb

3. サーバーを常に起動するように設定

   sudo systemctl enable mariadb

Unknown database 'sample_db'（データベースが存在しない）

エラー内容

mariadb.ProgrammingError: Unknown database 'sample_db'

発生原因

• 指定したデータベースが存在しない
• データベース名のスペルミス

解決策

1. データベース一覧を確認

   SHOW DATABASES;

2. データベースがない場合は作成

   CREATE DATABASE sample_db;

Table doesn't exist（テーブルが存在しない）

エラー内容

mariadb.ProgrammingError: Table 'sample_db.users' doesn't exist

発生原因

• 指定したテーブルが存在しない
• USE sample_db; でデータベースを選択していない

解決策

1. テーブル一覧を確認

   SHOW TABLES;

2. テーブルがない場合は作成

   CREATE TABLE users (
       id INT AUTO_INCREMENT PRIMARY KEY,
       name VARCHAR(100) NOT NULL,
       email VARCHAR(100) UNIQUE NOT NULL,
       created_at DATETIME DEFAULT CURRENT_TIMESTAMP
   );

Duplicate entry（データの重複エラー）

エラー内容

mariadb.IntegrityError: Duplicate entry 'alice@example.com' for key 'users.email'

発生原因

• email カラムに UNIQUE 制約があるため、同じ値を挿入できない

解決策

• データを挿入する前に、重複チェックを行う
• ON DUPLICATE KEY UPDATE を使用する

Pythonで重複を防ぐコード

try:
    cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@example.com"))
    conn.commit()
except mariadb.IntegrityError:
    print("エラー: メールアドレスが既に存在します。")

または ON DUPLICATE KEY UPDATE を使用

INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com')
ON DUPLICATE KEY UPDATE name = 'Alice Updated';

Incorrect number of bindings（パラメータ数の不一致）

エラー内容

mariadb.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 2, and there are 1 supplied.

発生原因

• SQLに必要なパラメータの数と、実際に渡した引数の数が一致していない

解決策

• プレースホルダーの数とデータの数を一致させる

誤ったコード

cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice"))

正しいコード

cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@example.com"))

まとめ

このセクションでは、MariaDBをPythonで操作する際に発生しやすいエラーとその対策について解説しました。

• Access denied for user（認証エラー）
• Can't connect to MySQL server（接続エラー）
• Unknown database（データベースが存在しない）
• Table doesn't exist（テーブルが存在しない）
• Duplicate entry（データの重複エラー）
• Incorrect number of bindings（パラメータ数の不一致）

8. まとめ

この記事では、Pythonを使ったMariaDBの操作方法 について、基礎から応用まで詳しく解説しました。
データベースの基本操作を理解し、エラーハンドリングやトランザクション管理を適切に行うことで、より安全で効率的なデータ操作が可能になります。

記事の振り返り

環境の準備

• MariaDBのインストール方法（Windows / Mac / Linux）
• PythonとMariaDBの接続ライブラリ（mariadb）のインストール

MariaDBへの接続

• 基本的なデータベース接続方法
• 環境変数を利用したセキュアな接続
• 接続時に発生するエラーの解決策

データベースとテーブルの作成

• データベースの作成（SQL・Python）
• テーブルの作成とデータ型の選び方
• 既存のテーブルの確認・削除方法

CRUD操作（データの追加・取得・更新・削除）

• Pythonを使ったデータの基本操作
• SQLインジェクション対策としてプレースホルダーを使用
• 適切なエラーハンドリング

トランザクションとロールバック

• トランザクションの重要性（ACID特性）
• エラー発生時にデータを元に戻す方法（ロールバック）
• AutoCommitを無効化して手動でトランザクションを管理

エラーハンドリング（よくあるエラーと対策）

• 認証エラー (Access denied for user)
• 接続エラー (Can't connect to MySQL server)
• データベース・テーブルが存在しないエラー
• データの重複エラー (Duplicate entry)
• デッドロックの発生とリトライ処理の実装

PythonとMariaDBを組み合わせる際のポイント

1. プレースホルダーを活用する

   cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@example.com"))

→ 直接SQL文を埋め込まず、変数をバインドすることで SQLインジェクションを防ぐ。

2. 適切なトランザクション管理を行う

• conn.commit() を使って 変更を明示的に確定。
• エラー時に conn.rollback() で データの整合性を保つ。

2. エラーハンドリングをしっかり行う

• try-except を活用し、発生しうるエラーを事前にキャッチ。
• OperationalError や IntegrityError など、エラーごとの対応策を準備。

2. パフォーマンスを考慮する

• バルクインサート（複数レコードを一括で追加）
• 適切なインデックス設定（検索速度を向上）

さらなる学習のためのリソース

PythonとMariaDBの連携について、さらに深く学びたい方は以下のリソースを参考にすると良いでしょう。

公式ドキュメント

• MariaDB公式ドキュメント

関連する学習コンテンツ

• SQLの基礎（W3Schools）
• Pythonによるデータベース操作（Real Python）

おすすめの書籍

• 「SQL 第2版 ゼロからはじめるデータベース操作」 – SQLの基礎をしっかり学べる
• 「Effective Python ―Pythonプログラムを改良する90項目」 – Pythonのベストプラクティスを学べる

まとめ

MariaDBとPythonを連携させることで、スクリプトを用いたデータ管理 や 自動化 が可能になります。
基本的なCRUD操作だけでなく、エラーハンドリングやトランザクション管理 を適切に実装することで、より安全で効率的なシステムを構築できます。

次のステップとして、「データの効率的な管理」や「APIとの連携」 について学習し、実践的なデータベース運用に活かしていきましょう。