【Python】Xserverのデータベースを操作する

PythonからXserverのデータベース(MySQL・MariaDB)を操作する方法って、必要な値があちこちの画面に散らばっていて絶妙にわかりにくいですよね
そこで接続に必要な情報の集め方から、そのまま使えるサンプルプログラムまで画像多めでまとめてみました

外部からブログ記事を投入したり、スクレイピングした結果をためたりするのに便利なので、私もわりと肝になる機能として使っています
※MariaDB・MySQLどちらでも同じコードで動きます

Xserverの画面で集める接続情報

プログラムの中で使う値が、Xserverのサーバーパネルのあちこちにちりばめられています
まずは必要な項目を画面ごとに拾っていきましょう

トップ画面で控える項目

取得する項目を赤枠、この先で使う画面を緑枠で囲っています

SSH設定画面で控える項目

まず「SSH設定タブ」で状態をONにするへ切り替えます

この画面でしれっと接続ポートの補足が出ているので控えておきましょう

「公開鍵認証用鍵ペアの生成タブ」ではパスフレーズを設定します

“生成する”ボタンを押すと「{サーバーID}.key」というファイル名の秘密鍵ファイルがダウンロードされます
ここまでやれば設定は完了です

WordPress簡単インストール画面で控える項目

「インストール済みWordPress一覧タブ」まで進むと、設定済みの値が並んでいるので拾うだけです

MySQL設定画面で控える項目

「MySQL情報タブ」に出ているホスト名を取得します

画面に出てこないけど必要な項目

画面からは確認できない(たぶん)けれど、プログラムの中で設定が必要な値もあります

必要なパッケージをインストールする

必要な値が集まったら、Pythonで使うパッケージを入れていきます
今回使うのは次の4つです

• mysql-connector-python … MySQL/MariaDBに接続する純正コネクター
• sshtunnel … XserverへSSHトンネルを張る
• python-dotenv … .envから認証情報を読み込む
• paramiko … sshtunnelが内部で使う(バージョン固定が必要)

データベースに接続するmysql-connector-pythonは、Oracleが出している純正のコネクターなのでこれを使います
SSHトンネルを張るsshtunnel、認証情報を読むpython-dotenv、それに後で説明するparamikoのバージョン固定がセットになります

pip install mysql-connector-python
pip install sshtunnel
pip install python-dotenv
pip install paramiko==3.5.1

paramikoはバージョンを固定しないとエラーになる

ここが今回いちばん伝えたいポイントです
sshtunnelをバージョン指定なしで入れると、内部で使うparamikoが最新版で一緒に入ります
ところがこの組み合わせだと、接続しようとした瞬間に次のエラーで止まってしまいます

AttributeError: module 'paramiko' has no attribute 'DSSKey'

原因は2つのパッケージの世代差です
sshtunnelは2026年6月時点でも2021年公開の0.4.0が最新で、更新が止まっています
その中で、新しいparamikoでは廃止されたparamiko.DSSKey(DSA鍵の処理)を今も呼び出しているんです

新しいparamiko(特に2025年8月の4.0以降)でDSA鍵のサポートが消えたので、組み合わせるとDSSKeyが見つからず落ちる、という流れになります
やっかいなのは、自分が使う鍵がRSAでもこのエラーが出ること
鍵の種類は関係なく、読み込みの段階で止まります

ジャベ雄

このエラー、検索しても古い情報ばかりで半日溶かしました…

回避はシンプルで、paramikoを3系に固定して入れ直すだけです
私の環境ではparamiko==3.5.1で問題なく動いています(2026年6月時点で確認した限り)

認証情報は.envに分けてハードコードを避ける

元の記事では、パスワードや秘密鍵のパスをプログラムに直接書いていました
手元で動かすだけなら手軽ですが、このコードをそのままGitHubなどに上げると、認証情報まで一緒に公開されてしまいます

そこで今回は、パスワードなどの秘密情報を.envという別ファイルに分けて、プログラムからは読み込むだけにします
こうしておけば、うっかり公開してしまう事故を防ぎやすくなります

ジャベ雄

鍵をそのままアップして冷や汗、の前に分けておきたいよね

.envファイルを用意する

プログラムと同じフォルダに.envという名前のファイルを作り、集めてきた値を「キー=値」の形で書いていきます
{}の部分は、自分のXserverの値に置き換えてください

SSH_HOST={サーバー番号}.xserver.jp
SSH_PORT=10022
SSH_USER={サーバーID}
SSH_PASSWORD={パスフレーズ}
SSH_PKEY={秘密鍵ファイルのフルパス}

DB_NAME={MySQLデータベース名}
DB_USER={MySQLユーザー名}
DB_PASSWORD={MySQLパスワード}
DB_HOST={ホスト名}
DB_PORT=3306
DB_CHARSET=utf8

.gitignoreで.envを管理対象から外す

せっかく分けても、.env自体をGitHubに上げてしまっては意味がありません
そこで.gitignoreに.envを書いて、アップロードの対象から外しておきます

.env

.gitignoreは、Gitに「このファイルは管理しないでね(=GitHubにもアップしないでね)」と伝えるためのリストです
ここに.envを1行書いておけば、秘密情報を含む.envがうっかり公開される事故を防げます

📚 Python自動化の独学に効く本PR

退屈なことはPythonにやらせよう 第3版

Al Sweigart

Amazonで見る楽天で見る

Pythonクローリング&スクレイピング 増補改訂版

加藤耕太

Amazonで見る楽天で見る

シゴトがはかどる Python自動処理の教科書

クジラ飛行机

Amazonで見る楽天で見る

私のおすすめからランダムで3冊を表示しています

Pythonのコネクタープログラム

準備ができたら、いよいよ接続用のプログラムです
サンプルと言いつつ、そのままモジュールとして使えるので便利ですよ

db_connector.py(.env対応版)

↓のプログラムが本体です
さきほどの.envから値を読み込むので、パスワードなどをコードに直接書かずに済みます

import os
import mysql.connector
from dotenv import load_dotenv
from sshtunnel import SSHTunnelForwarder

# .env を読み込んで環境変数として使えるようにする
load_dotenv()


class xserver_class:
    def __init__(self):
        self.ssh_host = os.getenv('SSH_HOST')
        self.ssh_port = int(os.getenv('SSH_PORT'))
        self.ssh_user = os.getenv('SSH_USER')
        self.ssh_password = os.getenv('SSH_PASSWORD')
        self.ssh_pkey = os.getenv('SSH_PKEY')

        self.db_name = os.getenv('DB_NAME')
        self.db_user = os.getenv('DB_USER')
        self.db_password = os.getenv('DB_PASSWORD')
        self.db_host = os.getenv('DB_HOST')
        self.db_port = int(os.getenv('DB_PORT'))
        self.db_charset = os.getenv('DB_CHARSET')

    def __connect__(self):
        self.server = SSHTunnelForwarder(
            (self.ssh_host, self.ssh_port),
            ssh_username=self.ssh_user,
            ssh_password=self.ssh_password,
            ssh_pkey=self.ssh_pkey,
            remote_bind_address=(self.db_host, self.db_port),
        )
        self.server.start()
        # connectのリファレンスはコチラ
        # https://dev.mysql.com/doc/connector-python/en/connector-python-connectargs.html
        self.con = mysql.connector.connect(
            host=self.db_host,
            port=self.server.local_bind_port,
            user=self.db_user,
            passwd=self.db_password,
            db=self.db_name,
            charset=self.db_charset,
            use_pure=True,
        )
        # 扱いやすいdict型を指定しておく
        self.cur = self.con.cursor(dictionary=True)
        # コネクションの設定
        self.con.autocommit = False

    def __disconnect__(self):
        self.con.close()
        self.server.stop()

    def fetch(self, sql):
        self.con.ping(reconnect=True)
        self.cur.execute(sql)
        result = self.cur.fetchall()
        return result

    def execute(self, sql):
        self.con.ping(reconnect=True)
        self.cur.execute(sql)
        self.con.commit()

    def open(self):
        self.__connect__()

    def close(self):
        self.__disconnect__()

モジュールとして呼び出すサンプル

try / exceptでエラーハンドリングした方がベターですが、サンプルなので最低限にしています

from db_connector import xserver_class

db = xserver_class()
db.open()

# SELECT の場合はfetchを使ってdict型でレコード取得する
sql = """
    SELECT
        *
    FROM
        sample_table;
    """
ret = db.fetch(sql)
# for でループしながらカラム名を指定してレコード毎にデータ取得できる
for row in ret:
    print(row["{カラム名}"])

# SELECT 以外はexecuteでcommitまでする
sql = """
    INSERT INTO sample_table(id, col1, col2, create_date) 
    values (0, "test", "hoge", NOW());
    """
db.execute(sql)

db.close()

接続が進まないときはuse_pureを付ける

とあるクライアントからの依頼でXserverにデータ登録することになって、まさにこのプログラムで接続していたら、mysql.connector.connectの部分がエラーにもならず処理が止まる事象にぶつかりまして…

結論から言うと、use_pure=Trueを足したらこの事象は解決しました

詳しい説明は↓の公式ページに譲りますが、C拡張機能を使うかどうかの判定らしく、私にはいまいち掴めていません

ちなみに私が契約しているXserverでは、そもそも不要な引数でした
どうやら環境によって要否が変わるようですね

どちらの環境でもuse_pure=Trueならエラーにならなかったので、とりあえず付けています
気になる方は外しても大丈夫かと

https://dev.mysql.com/doc/connector-python/en/connector-python-connectargs.html

https://dev.mysql.com/doc/connector-python/en/connector-python-cext-development.html

AIでMCPサーバを作るときの接続部品にも使える

最近は、ClaudeのようなAIに自分のデータベースを検索させたり書き込ませたりする「MCPサーバ」を自作する人も増えてきました
MCPサーバは、AIに外部のデータや機能を渡すための受け皿のようなものです

このMCPサーバでMySQLを扱う場合、中身はだいたいこの記事と同じ部品でできています
データベースにつなぐmysql-connector-python、認証情報を環境変数で渡すpython-dotenv、そして外部から触るためのsshtunnelとparamiko、顔ぶれは見覚えがありますよね?

とくにXserverのような共用サーバーは外から直接つなげないので、SSHトンネルを張る部分がそのまま必要になります
この記事のコネクターは、その入り口をまるごと用意できるので、MCPサーバの土台として流用しやすいんです

ジャベ雄

自分のデータをAIに渡すMCP、まず詰まるのがこの接続部分なんですよね

MCPサーバそのものの仕組みは、Claude Code拡張機構入門でMCPを含めて解説しているので、興味があればどうぞ

あとがき

純粋なブログ運営にはあまり使い道がないかもしれませんが、私はスクレイピングの結果をXserverへ投入して、その検索ページを作ったりしています
そういう用途では結構肝になる機能なんです

スクレイピングでデータを集める側の話は、CSSセレクタの書き方でまとめているので、あわせてどうぞ

全体像をまとめたページは↓です
Xserverはブログだけじゃないので、参考にしてみてください

あわせて読みたい

【Python】モッピーの情報を収集して発信する Pythonで毎日自動処理するプログラムをいくつか作っているのでその紹介です 24時間365日稼働させるためには相応の環境が必要で、私はWindows Serverを使っていますので...

📚 Python自動化の独学に効く本PR

退屈なことはPythonにやらせよう 第3版

Al Sweigart

Amazonで見る楽天で見る

Pythonクローリング&スクレイピング 増補改訂版

加藤耕太

Amazonで見る楽天で見る

シゴトがはかどる Python自動処理の教科書

クジラ飛行机

Amazonで見る楽天で見る

私のおすすめからランダムで3冊を表示しています