老森常谈 IT 帮助

Synology MariaDB 通过 DBeaver 导入 sql 文件

最近开始把托管的 WordPress 移到 Synology NAS 上，在数据库导入这块，如预期般遇上不少问题，花了不少时间研究才一一解决，把这个过程记录一下，分享给需要的人。

【环境】

Synology 的 MariaDB、phpMyAdmin 已建置完成。
已从托管网站下载 .sql 文件，大小约 250MB。
本地电脑已安装 DBeaver，本地操作系统为 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 即可。