如何使用 MySQL Workbench 管理 ServBay 資料庫

概述

MySQL Workbench 是 Oracle 官方提供的視覺化資料庫工具，為 MySQL 與 MariaDB 資料庫提供了一站式的開發與管理介面。對於使用 ServBay 作為本地 Web 開發環境的開發者來說，MySQL Workbench 不僅功能強大且操作直觀，非常適合設計、開發、管理與維護 ServBay 內建的資料庫實例。

本指南將詳細說明如何設定 MySQL Workbench 以連接 ServBay 提供的 MariaDB 資料庫，並執行常見的資料庫操作，包括建立資料庫、資料表，以及資料的新增、刪除、修改、查詢。

為什麼選擇 MySQL Workbench？

MySQL Workbench 擁有以下主要優勢，使其成為 ServBay 使用者管理資料庫的理想利器：

1. 完整功能組合: 內建資料庫設計（ER 圖建模）、SQL 開發（先進編輯器與除錯器）、資料庫管理（用戶管理、備份、伺服器狀態監控）等多項強大功能。
2. 直覺操作介面: 提供易於導航與上手的圖形化界面，大幅降低資料庫管理的門檻。
3. 效能優化: 針對大型資料庫和複雜查詢進行效能最佳化處理。
4. 跨平台支援: 可於 macOS、Windows 與 Linux 上運作，與 ServBay 的跨平台特色完全相容。
5. 官方支援: 身為官方工具，與 MySQL/MariaDB 關聯的相容性與功能更新皆有保障。

透過 MySQL Workbench，開發者能更高效處理資料庫任務，無論是開發新專案還是維護現有應用，皆可事半功倍。

連接至 ServBay 資料庫

ServBay 預設整合了 MariaDB，一套高效能且與 MySQL 相容的關聯式資料庫管理系統。ServBay 會自動完成 MariaDB 的安裝與啟動。您只需透過 MySQL Workbench 連接這個在本地運行的資料庫實例。

前置條件

• 已安裝並啟動 ServBay。
• 已安裝 MySQL Workbench。可從 MySQL 官方網站 下載最新版。

連線步驟

1. 開啟 MySQL Workbench：啟動您已安裝的 MySQL Workbench 應用程式。

2. 建立新連線：

   • 在 MySQL Workbench 的歡迎畫面或主選單點選「MySQL Connections」面板旁的 + 圖示新增連線。

3. 設定連線參數：

   • Connection Name: 為連線命名，例如 ServBay MariaDB 或 ServBay Local Database。

   • Connection Method: macOS 上使用 ServBay 本機連線時，建議選擇 Local Socket / Pipe 方法，因為比 TCP/IP 更快速且穩定。

   • Socket File: 指定 MariaDB 的 socket 檔案路徑。ServBay 預設為 /Applications/ServBay/tmp/mysql.sock。

   • Username: ServBay 資料庫預設使用者名稱通常是 root。

   • Password: 點擊 Store in Keychain 按鈕旁的輸入框，在彈出的對話框輸入 ServBay 為 root 資料庫用戶設定的密碼。重要提示: 此密碼非空，您可於 ServBay 應用介面的 資料庫 (Database) 分頁中查詢並複製。

   • Default Schema: 可留空，成功連線後再選擇或建立資料庫。

   • 若選擇以 TCP/IP 連線 (Connection Method: Standard (TCP/IP))：

     • Hostname: 127.0.0.1 或 localhost
     • Port: 3306（ServBay 預設埠）
     • Username: root
     • Password: 同樣從 ServBay 資料庫 分頁取得。

   • 注意: 一般而言，本機連線建議優先選用 Socket 檔案方式，速度與穩定性較佳。

4. 測試連線：

   • 點擊 "Test Connection" 按鈕。若所有設定正確，會看到連線成功的提示資訊。
   • 若連線失敗，請檢查 ServBay 是否已啟動、MariaDB 軟體包已啟用，以及您填寫的 socket 路徑、主機名、埠號、使用者名稱與密碼是否正確。

5. 儲存連線：

   • 測試通過後，點擊 "OK" 儲存此連線設定。新連線會顯示於 MySQL Workbench 主畫面。

6. 開啟連線：

   • 雙擊剛剛建立的連線名稱（如 ServBay MariaDB），即可開啟 SQL 編輯與管理介面，開始管理您的資料庫。

資料庫基本操作

連線成功後，您將進入 MySQL Workbench 主介面，通常包括 SQL 編輯區及左側的導航面板（Navigator）。在 Navigator 面板的「SCHEMAS」區塊，可瀏覽當前資料庫實例中的所有資料庫（Schema）。

ServBay 預設安裝的 MariaDB 已帶有多個系統資料庫（例如 information_schema, mysql, performance_schema, sys 等），請避免異動這些系統資料庫。

建立新資料庫 (Schema)

1. 在左側「SCHEMAS」區的空白處點擊右鍵，選擇「Create Schema...」。
2. 在彈出的視窗中輸入新資料庫名稱（如 servbay_demo_db）。
3. 可選擇字元集與校對規則（Charset and Collation），通常建議使用 utf8mb4 及 utf8mb4_unicode_ci，以支援更全面的字元。
4. 點擊「Apply」按鈕。
5. 在彈出的 SQL 腳本確認視窗再次點選「Apply」執行建立動作。
6. 點擊「Finish」。新資料庫即顯示於「SCHEMAS」列表。

建立資料表

1. 展開剛新建的資料庫（如 servbay_demo_db）。
2. 右鍵點擊該資料庫下的「Tables」，選擇「Create Table...」。
3. 在表格編輯介面裡：
   • 輸入資料表名（如 users）。
   • 在「Columns」面板中，於底部空白列開始定義欄位：
     • 輸入欄位名（如 id、username、email、created_at）。
     • 選擇資料型態（如 INT、VARCHAR(255)、DATETIME）。
     • 勾選屬性（如 PK 主鍵, NN 不可為空, UQ 唯一索引, BIN 二進位, UN 無符號, ZF 補零, AI 自動遞增）。例：id 欄位通常設定為 INT, PK, NN, AI。
4. 完成欄位定義後，點右下角「Apply」。
5. 在 SQL 腳本確認視窗再次點擊「Apply」執行表建立。
6. 點擊「Finish」。新建的資料表將出現在該資料庫下的「Tables」列表中。

新增資料

1. 在左側「SCHEMAS」清單找到並展開您的資料庫，再展開「Tables」。
2. 右鍵點擊欲新增資料的表名（如 users），選擇「Select Rows - Limit 1000」，將開啟結果集視窗。
3. 在結果集視窗下方的空白行，可直接輸入新資料。
4. 輸入完成後，點選結果集左下角的「Apply」按鈕。
5. 在 SQL 腳本確認視窗再次點選「Apply」執行新增資料。
6. 點擊「Finish」。資料將新增至資料表中。

查詢資料

1. 右鍵點想查詢的表名，選擇「Select Rows - Limit 1000」，這是最直接的資料瀏覽方式。
2. 若需進階查詢，可於上方 SQL 編輯器輸入查詢語句，如：

   SELECT id, username, email FROM users WHERE id > 10 ORDER BY created_at DESC;

3. 點擊編輯器工具列的閃電圖示（執行 SQL），或按下 Cmd + Shift + Enter (macOS) 執行查詢。結果將顯示於下方結果面板。

更新資料

1. 右鍵點要修改的表名，選「Select Rows - Limit 1000」以開啟結果集視窗。
2. 在結果集直接雙擊欲更改的單元格內容。
3. 編輯資料值。
4. 完成後，點結果集左下角「Apply」。
5. 在 SQL 確認視窗再次點選「Apply」執行更新。
6. 點擊「Finish」。資料即完成更新。

刪除資料

1. 右鍵點欲刪除資料的表名，選「Select Rows - Limit 1000」以開啟結果集。
2. 在結果集中選取你想刪除的一列或多列，可點選行號選取整行。
3. 選定後，右鍵點選區塊並選「Delete Row(s)」。
4. 確認刪除動作。
5. 點選結果集左下角「Apply」按鈕。
6. 在 SQL 確認視窗再次點選「Apply」執行刪除。
7. 點擊「Finish」。資料即會被刪除。

刪除資料表

1. 在左側「SCHEMAS」面板展開有需刪除資料表的資料庫。
2. 展開該資料庫下的「Tables」。
3. 右鍵點想刪除的表名，選「Drop Table...」。
4. 在跳出的確認視窗點選「Drop Now」。
5. 該表會立即被刪除。如需謹慎操作，此步驟無法還原。

刪除資料庫 (Schema)

1. 在「SCHEMAS」區清單中，右鍵點需刪除的資料庫名稱。
2. 選「Drop Schema...」。
3. 在彈出的確定視窗點「Drop Now」。
4. 資料庫及其所有資料表、資料與索引將立即抹除。請特別小心，此動作無法復原。

常見問題 (FAQ)

• Q: 為什麼無法連線 ServBay 資料庫？
  • A: 請先確認 ServBay 應用正在運行，MariaDB 軟體包已啟用並運作正常。檢查您在 MySQL Workbench 輸入的連線參數，特別是 socket 檔案路徑（/Applications/ServBay/tmp/mysql.sock）、TCP/IP 主機 (127.0.0.1)、埠號（3306），以及從 ServBay 資料庫 取得的使用者名稱（root）與密碼。防火牆也可能影響 TCP/IP 連線。
• Q: ServBay 的資料庫 root 密碼在哪裡查詢？能修改嗎？
  • A: 資料庫 root 用戶密碼可在 ServBay 應用介面的 資料庫 (Database) 分頁查看。ServBay 也內建重設密碼功能，相關按鈕可於同一位置找到。
• Q: 可以用其他資料庫管理工具嗎？
  • A: 當然可以。ServBay 的資料庫（MariaDB/MySQL）採用標準協定，您可用任何支援 MySQL 的管理工具，例如 phpMyAdmin（若經 ServBay 安裝）、DBeaver、TablePlus 等。MySQL Workbench 為官方推薦且功能完善的選擇。

總結

透過本指南，您已學會如何以強大的 MySQL Workbench 連接並管理 ServBay 本地開發環境的 MariaDB/MySQL 資料庫。無論是資料庫設計、SQL 程式開發或日常維護，MySQL Workbench 均能高效結合 ServBay，提供最佳開發與管理體驗。熟練掌握這些操作，有助於您善用 ServBay 建構並維護 Web 專案。