WSL上でのMySQLのインストールとWindowsからの接続 (Ubuntu 22.04.3)

本記事では、WSL上のUbuntuにMySQLをインストールしてサーバーを立ち上げる方法と、WindowsからMySQL WorkbenchによりWSL上のMySQLサーバーに接続する方法を示します。

目次

1. 準備
2. MySQLのインストール
3. MySQLサーバーの起動・停止・再起動
   1. systemctlコマンド
   2. serviceコマンド
4. rootのパスワードの設定
   1. rootのパスワードの設定
   2. rootのパスワードが設定されたことの確認
5. セキュリティ強化のための設定
   1. mysql_secure_installationの実行
   2. パスワード認証のポリシーの変更
6. MySQLサーバーのPortの変更
7. パスワード認証プラグインの確認
8. MySQL WorkbenchによるWSL上のMySQLへの接続
9. まとめ

準備

WSL（Windows Subsystem for Linux）上にLinuxのディストリビューションであるUbuntuをインストールして、その上でMySQLサーバーを立ち上げます。

その準備となるWSLとUbuntuのインストールについては、以下の記事をご覧ください。

記事執筆段階において、

・　Windows 11 Home (22H2, Build 22621.2134)

・　Ubuntu 22.04.3 LTS (GNU/Linux 5.15.90.1-microsoft-standard-WSL2 x86_64)

を使用しております。

MySQLのインストール

MySQLは、オープンソースのリレーショナルデータベース管理システムで、主にウェブアプリケーションやソフトウェアで使用され、データの保存、取得、管理を行います。MySQLは高速で信頼性が高く、多くのプラットフォームで利用できます。データベースのアクセスや操作にはSQL（Structured Query Language）を使用します。MySQLはクライアント／サーバー型を採用しており、多くのユーザーが同時にデータベースにアクセスできる特徴をもっています。

WSL上のUbuntuにMySQLサーバーをインストールする手順を示します。

１．パッケージ一覧を更新します。

$ sudo apt update

2. MySQLをインストールします。

$ sudo apt install mysql-server

3. MySQLのバージョン番号とインストールを確認します。

$ mysql --version
mysql  Ver 8.0.33-0ubuntu0.22.04.4 for Linux on x86_64 ((Ubuntu))

記事執筆時点でのMySQLのバージョンは8.0.33でした。

MySQLサーバーの起動・停止・再起動

常時稼働しているアプリケーションをサービスと呼びます。MySQLはサービスです。Ubuntuではサービスをsystemctlコマンド、または、serviceコマンドで操作します。

systemctlコマンド

systemctlコマンドでmysqlサーバーを操作する基本的な方法を示します。

serviceコマンド

serviceコマンドでmysqlサーバーを操作する基本的な方法を示します。

rootのパスワードの設定

rootのパスワードの設定

次のコマンドでrootユーザーとして、MySQLにログインします。

$ sudo mysql

次に、MySQLサーバーにrootユーザーのパスワードを設定します。

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '〇〇〇〇';

〇〇〇〇の部分に設定するパスワードを記述します。そして、

FLUSH PRIVILEGES;

を実行して、rootユーザーのパスワード変更を反映します。反映した後は、

exit

として、MySQLの対話モードから抜けます。

rootのパスワードが設定されたことの確認

sudoコマンドでMySQLにログインしようとすると、エラーが発生することが確認できます。

$ sudo mysql
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: NO)

これは先ほどMySQLのrootユーザーのパスワードを変更したためです。

rootユーザーでログインする場合には、

$ mysql -u root -p

とします。パスワードを訊かれますので、先ほど設定したパスワードを入力します。以上でrootユーザーのパスワードが設定されたことを確認できました。

セキュリティ強化のための設定

mysql_secure_installationの実行

MySQLサーバーを初めてインストールした後に、セキュリティを強化するためのスプリクトがあります。次のコマンドで実行します。

$ mysql_secure_installation 

パスワードを訊かれますので、設定したrootパスワードを入力します。

すると、いくつかの質問を受けますので、それについて１つ１つ回答していきます。

各質問の意味を以下に示します。

パスワード認証のポリシーの変更

MySQLのパスワード認証ポリシーの確認は、MySQLにログインした後に次のコマンドを用います。

show variables like 'validate_password%';

実行すると次のような表が表示されます。以下はパスワード認証ポリシーをSTRONGとした場合の例です。

mysql> show variables like 'validate_password%';
+--------------------------------------+--------+
| Variable_name                        | Value  |
+--------------------------------------+--------+
| validate_password.check_user_name    | ON     |
| validate_password.dictionary_file    |        |
| validate_password.length             | 8      |
| validate_password.mixed_case_count   | 1      |
| validate_password.number_count       | 1      |
| validate_password.policy             | STRONG |
| validate_password.special_char_count | 1      |
+--------------------------------------+--------+
7 rows in set (0.00 sec)

これらの値を変更するには、Variable_nameの欄の変数〇〇〇に対して、

set global 〇〇〇 = 値 ;

とすれば変更できます。例えば、パスワード認証ポリシーをLOWに変更するには、

set global validate_password.policy = 'LOW';

とします。

MySQLサーバーのPortの変更

WSL上で起動しているMySQLサーバーが動作するデフォルトのポート（3306）を非デフォルトのポートに変更します。

この操作により、WSL上とホストマシーン上に2つの異なるMySQLサーバーを同時に実行することができます。

まず、Bash上で設定ファイルを開きます。

sudo vim /etc/mysql/my.cnf

エディタにvimを使用していますが、nanoでもemacsでも使い慣れたエディタを使用してください。次の文を追加します。

[mysqld]
port = 33061

デフォルトのMySQLのポートは3306です。これを33061に変更する例になります。ポートを変更したら、MySQLサーバーを再起動します。

sudo systemctl restart mysql

これでWSL上のMySQLサーバーのポート番号が33061になりました。ブラウザなどでURLにhttp://localhost:33061/と打ち込むと、WSL上のMySQLサーバーがポート33061で起動していることを確認できます。

パスワード認証プラグインの確認

MySQLには2種類のパスワードの認証プラグインがあります。１つは、caching_sha2_password、もう１つは、mysql_native_passwordになります。

MySQLのデフォルトの認証方法を確認するには、MySQLにログインした後に、次のコマンドを実行します。

show variables like 'default_authentication_plugin';

以下は実行例です。

+-------------------------------+-----------------------+
| Variable_name                 | Value                 |
+-------------------------------+-----------------------+
| default_authentication_plugin | caching_sha2_password |
+-------------------------------+-----------------------+
1 row in set (0.00 sec)

MySQL8.0以降はデフォルトの認証プラグインはcaching_sha2_passwordになっています。caching_sha2_passwordはmysql_native_passwordよりもセキュリティが強化されています。ただし、新しい認証プラグインのため互換性に問題がある場合があります。

一部のアプリケーションやクライアントはcaching_sha2_passwordをサポートしていない場合があり、その場合には認証エラーが発生します。そのようなアプリケーションを使用するときには、mysql_native_passwordへの変更が必要です。

MySQLのデフォルトの変更は、MySQLの設定ファイルを修正します。

sudo vim /etc/mysql/my.cnf

により設定ファイルを開き、[mysqld]に以下の一文を追加します。

[mysqld]
default_authentication_plugin = mysql_native_password

設定ファイルを変更した後、MySQLサーバーを再起動するとデフォルトの認証プラグインがmysql_native_passwordに変更されます。

その他に、ユーザーごとの認証プラグインは次のように確認できます。例えば、rootの認証方法を確認するには次のコマンドを実行します。

select User, Plugin from mysql.user where User = 'root';

以下は実行例です。

+------+-----------------------+
| User | Plugin                |
+------+-----------------------+
| root | mysql_native_password |
+------+-----------------------+
1 row in set (0.00 sec)

rootのパスワードがmysql_native_passwordになっているのは、パスワード設定の際に「ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY...」という形で認証プラグインを指定したためです。

MySQL WorkbenchによるWSL上のMySQLへの接続

MySQLを操作できるツールとしてMySQL Workbenchを使って、WSL上のMySQLサーバーにアクセスします。MySQL WorkbenchはMySQLの公式統合開発環境(IDE)ツールで、データベースの管理から設計・開発までGUIで操作することができます。

WindowsやmacOS、Linuxの主要なプラットフォームで動作し、公式のMySQLウェブサイトから無料でダウンロードできます。

公式ページに飛び「ダウンロードはこちら」というボタンを押します。その後、Windows上にインストールするため、Select Operating Systemで「Microsoft Windows」を選択し、「Go to Download Page >」のボタンを押します。

すると次のページが表示されます。

mysql-installer-web-communityとmysql-installer-communityの2種類がありますが、前者はオンライン状態でインストールを行うためのインストーラ、後者はオフライン状態でインストールするためのインストーラです。

ここでは前者を選択しました。ログインを求められますが、オラクルアカウントをもたない場合には「No thanks, just start my download.」からダウンロードできます。

ダウンロードしたインストーラを実行すると、Setup Typeを選択します。

本記事では、Customを選択し、「Applications」の「MySQL Workbench」のみをインストールしました。再度インストーラを実行することで、後から変更することが可能です。

インストール後にMySQL Workbenchを実行して、WSLへのテスト接続を行います。メニューの「Database」->「Manage Connections」を開きます。

この画面で以下の項目を設定します。

画面右下にあるTest Connectionを実行して、「Successfully made the MySQL connection」というダイアログボックスが表示されたら、WindowsからWSL上のMySQLへの接続ができています。

まとめ

本記事では、WSL上のUbuntuにMySQLをインストールして、MySQL WorkbenchによりWSL上のMySQLへの接続し、以下について説明しました。

・　インストール方法

・　ルートパスワード変更

・　mysql_secure_installationによるセキュリティの簡易設定

・　MySQLサーバーのポート変更

・　MySQL WorkbenchによるWSL上のMySQLサーバーへの接続設定

同じように勉強している方の参考になりましたら幸いです。あたらしいことができるようになるのは楽しいですね！