老森常譚 IT Help

Synology MariaDB를 통해 DBeaver로 SQL 파일 가져오기

　　最近開始把代管的 WordPress 移到 Synology NAS 上，在資料庫匯入這塊，如預期般的遇上不少問題，花了不少時間研究才一關一關的解決，把這個過程記錄一下，分享給需要的人。

【環境】

Synology 的 MariaDB、phpMyAdmin 已建置完成。
已從代管網站下載 .sql 檔，大小約 250MB。
本地端電腦已安裝 DBeaver，本地端的OS為 Manjaro。

[重點步驟]

透過 SSH 在 MariaDB 新增一個可以從非 localhost 連線的계정。因為一般계정의 預設설정都只能從 localhost (就是NAS自己)連線。
將 MariaDB 的 max_allowed_packet 제한調大。預設只有 1M。
在本地端安裝 maria-clients，以供 DBeaver 使用還原資料庫所需的指令。

《새 MariaDB 계정 추가》

# 透過 SSH 連線 Synology NAS
ssh myaccount@192.168.1.1 # myaccount 為 Synology 帳戶；192.168.1.1 為 Synology 位址

# 確認 bind-address 為 0.0.0.0 （預設值）
more /volume1/@appstore/MariaDB10/usr/local/mariadb10/etc/mysql/my.cnf | grep bind-address

# 確認 port 為 3306，且 Synology 上的防火牆有開啟對應的 port
more /var/packages/MariaDB10/etc/my_port.cnf

# 以 root 身份登入資料庫
/volume1/@appstore/MariaDB10/usr/local/mariadb10/bin/mysql --user=root --port=0 --password --host=localhost

# 檢視資料庫現有的使用者 
SELECT User, Host FROM mysql.user; # 記得最後要輸入分號

# 建立一個 dbeaver-restore 帳戶，密碼為 superstrongpassword，並允許其從 192.168.*.* 登入
CREATE USER 'dbeaver-restore'@'192.168.%' IDENTIFIED BY 'superstrongpassword';

# 給予 dbeaver-restore 存取所有資料庫的權限
GRANT ALL PRIVILEGES ON *.* TO 'dbeaver-restore'@'192.168.%' WITH GRANT OPTION;

# 斷開資料庫連線
exit

《MariaDB 패킷 한도 조정》

#  確認目前 [mysqld] 底下的 max_allowed_packet 的數值
more /volume1/@appstore/MariaDB10/usr/local/mariadb10/etc/mysql/my.cnf

# Synology 建議不要修改預設的 my.cnf 檔案
# 而是使用下面路徑 my.cnf 檔來套用自訂值 
sudo vim /var/packages/MariaDB10/etc/my.cnf

# 在 vim 按 i 後，貼上下面文字
[mysqld]
max_allowed_packet = 500M # 設成大於 sql 檔大小的數值

# 按 ESC 後，存檔離開
:wq!

# 重啟 MariaDB 服務
sudo /usr/syno/bin/synopkg restart MariaDB10

《DBeaver를 통해 SQL 데이터베이스 복원》
1. DBeaver는 mariadb 또는 mysql을 통해 데이터베이스를 복원해야 하므로，먼저 로컬에 'mariadb-clients' 또는 'mysql-client' 패키지를 설치해야 합니다。

2. which mysql 명령어를 통해 mysql 위치 확인，기본 위치는 /usr/bin/mysql。

which mysql

3. DBeaver에서 데이터베이스 연결 설정 화면에서，'로컬 클라이언트'에서 mysql 위치를 설정해야 합니다。
在「本地客戶端」點選「瀏覽」。

4. 新增一個 mysql 的位置。
◎ 依 DBeaver 官方文件說明，如果 mysql 的位置在 /usr/bin/mysql，那麼這邊設定成 /usr 即可，略過後面的 /bin/mysql。
◎ 如果 DBeaver 是從 Snap 套件庫下載的版本，這邊的路徑可能會被轉換成 /run/…，這會導致後續執行失敗。如果有遇到這情形，改安裝官方套件庫的 DBeaver 即可。