PythonでMariaDBに接続できない？「mariadb_config not found」エラーの解決方法

MySQLとPythonでMariaDBを利用する際のエラー「mariadb_config not found」の解決方法

この解説では、MySQLとPythonを使ってMariaDBを利用する際に発生するエラー「mariadb_config not found」の原因と解決方法について説明します。このエラーは、pip install mariadbコマンドを実行した際に発生します。

原因

このエラーは、mariadb_configコマンドが見つからないことが原因です。mariadb_configコマンドは、MariaDBのインストールディレクトリに含まれるプログラムで、MariaDBとの接続に必要な情報を提供します。

解決方法

このエラーを解決するには、以下のいずれかの方法を試してください。

MariaDBの開発パッケージをインストールする

多くのLinuxディストリビューションでは、MariaDBの開発パッケージをインストールすることで、mariadb_configコマンドを含むすべての開発ツールをインストールすることができます。

コマンド例

# Ubuntuの場合
sudo apt install libmariadbclient-dev-compat

# CentOSの場合
sudo yum install mariadb-devel

MariaDBのインストールディレクトリにパスを通す

mariadb_configコマンドは、MariaDBのインストールディレクトリに存在します。このディレクトリにパスを通すことで、mariadb_configコマンドをどこからでも実行することができます。

# bashの場合
export PATH=$PATH:/usr/local/mariadb/bin

# zshの場合
export PATH=$PATH:$HOME/.local/bin

pip install mariadbコマンドに--globalオプションを付けることで、mariadb_configコマンドをシステム全体にインストールすることができます。

pip install mariadb --global

補足

• PythonでMariaDBを利用するには、mysqlclientライブラリをインストールする必要があります。

この解説は参考情報として提供されています。この解説の内容によって生じた損害について、いかなる責任も負いません。

import mysql.connector

# データベースへの接続
connection = mysql.connector.connect(
    host="localhost",
    port=3306,
    user="root",
    password="password",
    database="test",
)

# カーソルの作成
cursor = connection.cursor()

# クエリの実行
cursor.execute("SELECT * FROM users")

# 結果の取得
for row in cursor.fetchall():
    print(row)

# カーソルのクローズ
cursor.close()

# データベースとの切断
connection.close()

このコードを実行するには、以下の準備が必要です。

• Python 3.xがインストールされていること
• mysqlclientライブラリがインストールされていること
• MariaDBサーバーが起動していること

mysqlclientライブラリは、pip install mysqlclientコマンドでインストールすることができます。

このコードは、基本的な接続とクエリの実行のみを目的としています。より複雑な操作を行う場合は、MariaDB公式ドキュメントを参照してください。

MariaDBに接続する他の方法

SQLAlchemyは、Python用のORM（Object-Relational Mapping）ライブラリです。SQLAlchemyを使うと、データベースとの接続やクエリの実行をより簡単に記述することができます。

from sqlalchemy import create_engine

# エンジンの作成
engine = create_engine("mysql+pymysql://root:password@localhost:3306/test")

# セッションの作成
session = engine.sessionmaker()

# クエリの実行
users = session.query(User).all()

# セッションのクローズ
session.close()

pymysqlは、MySQL用のPythonライブラリです。mysqlclientライブラリよりも軽量で、シンプルな接続方法を提供します。

import pymysql

# データベースへの接続
connection = pymysql.connect(
    host="localhost",
    port=3306,
    user="root",
    password="password",
    database="test",
)

# カーソルの作成
cursor = connection.cursor()

# クエリの実行
cursor.execute("SELECT * FROM users")

# 結果の取得
for row in cursor.fetchall():
    print(row)

# カーソルのクローズ
cursor.close()

# データベースとの切断
connection.close()

mysqlコマンドは、MariaDBサーバーに直接接続してクエリを実行することができます。

mysql -h localhost -P 3306 -u root -p password -D test -e "SELECT * FROM users"

これらの方法は、それぞれメリットとデメリットがあります。どの方法を使うかは、開発環境や目的に合わせて選択してください。