MySQL からのアップグレード

前提条件

• VillageSQL のバイナリ: VillageSQL のバイナリ(ソースからコンパイルしたもの、またはダウンロードしたもの)を用意してください。
• MySQL のバージョン: VillageSQL は MySQL 8.4 LTS に基づいています。MySQL 8.4 からのアップグレードがサポートされる経路です。

ステップ 1: データのバックアップ

オプション A: 論理バックアップ(mysqldump)

mysqldump -u root -p --all-databases --events --routines --triggers > full_backup.sql

オプション B: 物理バックアップ(データディレクトリ)

# Stop the server first (see Step 2)
cp -r /var/lib/mysql /var/lib/mysql-backup

ステップ 2: MySQL サーバーの停止

sudo systemctl stop mysql
# OR
sudo systemctl stop mysqld

sudo service mysql stop

mysqladmin -u root -p shutdown

ステップ 3: バイナリの置き換え

方法 A: インストールディレクトリの入れ替え(推奨)

1. VillageSQL を展開/インストールして、新しいディレクトリ(例: /usr/local/villagesql-8.4)に置きます。
2. シンボリックリンクを更新します。
   # Remove link to old MySQL
   sudo unlink /usr/local/mysql
   
   # Link to VillageSQL
   sudo ln -s /usr/local/villagesql-8.4 /usr/local/mysql
   
3. 権限を確認します。データベースを実行するユーザー(通常は mysql)が新しいバイナリの実行権限を持っていることを確認します。

方法 B: バイナリの上書き

# Assuming you are in the VillageSQL build directory
sudo make install

ステップ 4: 設定の確認

[mysqld]
datadir=/var/lib/mysql  # Should point to your EXISTING data
socket=/var/run/mysqld/mysqld.sock

ステップ 5: VillageSQL の起動

sudo systemctl start mysql

/usr/local/mysql/bin/mysqld_safe --user=mysql &

自動アップグレード

ステップ 6: インストールの確認

mysql -u root -p

SELECT @@version, @@version_comment;

トラブルシューティング

• “Data Dictionary Upgrade Failed”: サーバーが起動を拒否する場合、ダウングレード(例: 8.4 から 8.0)を試みているか、データファイルが破損している可能性があります。エラーログを確認してください。
• 権限エラー: mysql OS ユーザーが datadir と新しい VillageSQL インストールディレクトリを所有していることを確認してください。
  sudo chown -R mysql:mysql /var/lib/mysql
  

関連項目

• MySQL のスキーマ移行 — アップグレード後に安全な DDL 変更を実行する
• MySQL のバックアップ戦略 — アップグレード前にバックアップする
• Docker 上の MySQL — 代わりにコンテナで MySQL または VillageSQL を実行する
• サポート終了後の MySQL 8.0 から 8.4 へのアップグレード — まだ 8.0 の場合は、先に 8.4 に上げる