経緯

学習用にOSなしの中古PCを購入してLinux(Ubuntu)をインストールした
何となくWindows端末→Linux端末にリモート接続できるようにした
ある時、MySQLの環境構築を実施
SQLで便利な機能がないかを発掘していたときがあった
データベースやテーブルが徐々に増えたときに「そういえばクライアントツール（以下、GUIツールと記述）を使っていなかったな」とふと思う
「Windows端末のGUIツール→Linux端末のMySQLにリモート接続」って頑張ればできるんじゃない？と興味が湧いたので実現に向け行動を開始

GUIツールの選定

外せない条件

無料で使用できること

候補

候補は以下の３つのどれか

Beekeeper Studio
A5:SQL Mk-2
DBeaver

個人的には「Beekeeper Studio」「DBeaver」の二択

好みなのは「Beekeeper Studio」
使いやすそうなのは「DBeaver」
そんな印象

ツール決定：DBeaver

決め手は２つ

ER図が見れる
画面の雰囲気がどことなく「SQL Server」に似ていて親しみを覚えた

各種設定について

登場するもの

PC1: Linux(Ubuntu)
- リモート接続される側の端末
- MySQL環境はこちらにある
- バージョン: 22.04 LTS
PC2: Windows
- リモート接続する側の端末
- GUIツールの「DBeaver」はこちらにインストールされている

やりたいこと

「PC2:DBeaver→PC1:MySQL」のリモート接続を確立させて、DBeaverの画面上でDB操作を行える状態にする

Linux端末の設定

するべきことはこちら

IPアドレスを把握する
MySQLのポート番号を把握する
MySQLの設定ファイルを編集
リモート接続用のMySQLユーザを追加

IPアドレスを把握する

DBeaverで接続設定するときに必要になる

ip -4 a
このコマンドを実行すれば確認できる

MySQLのポート番号を把握する

基本的には「3306」だと思うが例外もあり得るので調べ方を１つ記載

DB接続したあとに
SHOW VARIABLES LIKE 'port'
このコマンドを実行するとポート番号が可能

-- 実行例
mysql> SHOW VARIABLES LIKE 'port';
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| port          | 3306  |
+---------------+-------+
1 row in set (0.01 sec)

MySQLの設定ファイルを編集

MySQL接続を許可するIPアドレスを管理している項目があるのでそれを編集する
※ちなみに筆者はここに辿り着くまでに結構遠回りしてしまった

対象ファイル: /etc/mysql/mysql.conf.d/mysqld.cnf
変更箇所: bind-address = xxx.xxx.xxx.xxx

初期設定では「bind-address = 127.0.0.1」となっていて、自端末からの接続のみ許可する状態

これを他のIPアドレスからの接続も許可するように変更する

# ファイル編集
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
# 変更前
bind-address = 127.0.0.1
# 変更後
bind-address = 0.0.0.0

今回はIPアドレスを「0.0.0.0」に変えた
どこからの接続でも許可するという意味合い

IPアドレスの範囲を指定することもできるので使用用途に合わせて適宜設定値は変えるべき

リモート接続用のMySQLユーザを追加

DBeaverでMySQL接続するときに使うユーザを追加する必要がある

ユーザ追加権限のあるユーザ（rootとか）でMySQLに接続して

CREATE USER '[user]'@'%' IDENTIFIED BY '[password]'
GRANT SELECT, INSERT, DELETE, UPDATE ON [databese].* TO '[user]'@'%';

このコマンドを順番に実行する
リモート接続用のこのユーザには全権限は与えず最低限の権限を付与した

@以降の'%'は任意のIPアドレスを意味する
このユーザを利用すれば外部からのMySQLも可能となる

これでLinux端末側の設定は終わり

Windows端末の設定

するべきことはこちら

DBeaverの各種設定

こちらは接続する側なのでGUIツールの設定だけで良い

DBeaverの各種設定

DBeaverを起動
画面上部の「データベース」を開く
「新しい接続」を選択
「MySQL」を選択して次へ
接続設定画面
Server Host: 「Linux端末の設定」で確認したIPアドレス
Port: 「Linux端末の設定」で確認したポート番号
Database: 接続対象のデータベース名
ユーザ名: 「Linux端末の設定」で追加したユーザ
パスワード: 「Linux端末の設定」で追加したユーザのパスワード
その他: 初期値のままでOK
入力が終わったら画面左下の「テスト接続」を押下
接続成功すれば設定は完了

これで設定はおわり

まとめ

「WindowsのSQLクライアントツール→LinuxのMySQLのリモート接続を確立する」という目的で環境設定を進めた。

リモート接続の設定が上手くいってDBeaverでテーブルやレコードが表示されたとき、
「おお！」と少しテンションが上がったのはここだけの話。

この経験を活かす機会はあまりなさそうだが、知ってて損はない知識だと思う。