如何使用 DBeaver 管理 ServBay 資料庫

ServBay 是一款功能完整的本地 Web 開發環境，為開發者提供多種主流的資料庫服務。雖然 ServBay 內建如 phpMyAdmin（針對 MySQL/MariaDB）、pgAdmin（針對 PostgreSQL）以及 Redis Commander（針對 Redis）等 Web 介面資料庫管理工具，但許多開發者更偏好使用功能更強大、介面更一致的桌面端客戶端來管理資料庫。DBeaver 正是一款廣受歡迎的跨平台資料庫工具。

本文將說明如何使用 DBeaver 連接並管理 ServBay 內建的資料庫包含 MariaDB/MySQL、PostgreSQL、SQLite 及 Redis。

什麼是 DBeaver？

DBeaver 是一套免費開源的通用資料庫管理工具，適用於開發者、SQL 程式設計師、資料庫管理員與分析師。它幾乎支援所有主流資料庫系統，包括關聯式資料庫（如 MySQL、PostgreSQL、Oracle、SQL Server、SQLite 等）和 NoSQL 資料庫（如 MongoDB、Redis、Cassandra 等）。

DBeaver 的主要特色包括：

• 廣泛的資料庫支援： 透過同一介面管理多種不同類型的資料庫。
• 友善的使用者介面： 提供直覺的圖形介面，簡化各種複雜的資料庫操作。
• 強大功能： 包含 SQL 編輯器、資料編輯器、元資料瀏覽器、ER 圖自動生成、資料匯入/匯出等許多進階功能。
• 跨平台： 支援 Windows、macOS 與 Linux 作業系統。
• 活躍的社群和不斷的更新： 確保工具穩定、功能持續進化。

對於 ServBay 使用者而言，搭配 DBeaver 能帶來更專業且一致的資料庫管理體驗，尤其是在需同時管理多種資料庫或執行複雜查詢及操作時。

使用 DBeaver 管理 ServBay 的 MariaDB/MySQL 資料庫

ServBay 預設整合了 MariaDB，且與 MySQL 高度相容。以下為利用 DBeaver 連接與管理 ServBay 內 MariaDB/MySQL 資料庫的步驟。

前置條件

• ServBay 已安裝並執行中。
• MariaDB/MySQL 套件於 ServBay 中已啟動。
• DBeaver 客戶端已下載並安裝。你可至 DBeaver 官方網站 取得最新版。

連接 MariaDB/MySQL

1. 開啟 DBeaver。
2. 點擊左上角 「新建資料庫連線」 按鈕（一般為插頭圖示）。
3. 於資料庫類型清單中，搜尋並選擇 「MariaDB」 或 「MySQL」，點選 「下一步」。
4. 輸入連接資訊：
   • 主機（Host）： 127.0.0.1（或 localhost）
   • 埠號（Port）： 3306
   • 使用者名稱（Username）： 預設為 root。
   • 密碼（Password）： 你可於 ServBay 應用介面 資料庫 分頁中找到 MariaDB/MySQL root 使用者密碼。
   • 資料庫（Database）： 可暫時留空，待連線成功後再選擇或建立資料庫。
   • 連線方式（選用）： 除了使用 TCP/IP（主機+埠號）連線，你也可以選用 Socket 連線，這在本機環境下通常更有效率。在 驅動程式屬性（Driver properties） 查找 connectUsing，設為 socket，再於 socket 屬性設定 ServBay MariaDB/MySQL 的 Socket 檔案路徑，預設為 /Applications/ServBay/tmp/mysql.sock。注意：使用 Socket 連線時，主機與埠號一般可不必填寫。
5. 點選 「測試連線」，確認連線資訊無誤。若測試失敗請檢查 ServBay 中 MariaDB 服務是否執行中，和使用者帳密是否正確。如忘記密碼，可在 ServBay 資料庫 分頁重設 MariaDB/MySQL 的 root 密碼。
6. 測試通過後，點選 「完成」 儲存連線。

基本資料庫操作

連線成功後，你可於 DBeaver 的資料庫導覽器看到 ServBay 的 MariaDB/MySQL 資料庫實例。你可執行以下常見操作：

• 建立資料庫： 右鍵點選連線名稱，選擇 「SQL 編輯器」 -> 「新建 SQL 腳本」，輸入 CREATE DATABASE mydatabase_servbay;（將 mydatabase_servbay 替換為你所需名稱），然後點擊執行（綠色三角圖示）。
• 以 SQL 編輯器查詢資料： 右鍵點連線或特定資料庫/資料表，選擇 「SQL 編輯器」 -> 「新建 SQL 腳本」，輸入 SQL 查詢，例如 SELECT * FROM your_table_name;，並執行。
• 瀏覽及編輯資料： 在資料庫導覽器中展開資料庫及資料表，雙擊表名即可在新分頁中瀏覽與編輯表格數據。DBeaver 提供直覺的資料編輯介面。
• 新建、修改與刪除資料表： 右鍵點資料庫下 「表」 節點，選取 「建立新表」，或右鍵現有表進行編修/刪除。
• 匯入/匯出資料： DBeaver 支援多種格式的匯入與匯出，方便資料遷移。

這些操作通常可透過 DBeaver 的圖形介面或內建 SQL 編輯器完成，流程與管理其他資料庫無異。

使用 DBeaver 管理 ServBay 的 PostgreSQL 資料庫

ServBay 亦整合了 PostgreSQL 資料庫。以下為在 DBeaver 連接及管理 ServBay 內 PostgreSQL 的步驟。

前置條件

• ServBay 已安裝並執行中。
• PostgreSQL 套件於 ServBay 已啟動。
• DBeaver 客戶端已安裝。

連接 PostgreSQL

1. 開啟 DBeaver。
2. 點擊左上角 「新建資料庫連線」 按鈕。
3. 於資料庫類型清單搜尋並選擇 「PostgreSQL」，點選 「下一步」。
4. 輸入連線資訊：
   • 主機（Host）： 127.0.0.1（或 localhost）
   • 埠號（Port）： 5432（PostgreSQL 預設埠號）
   • 資料庫（Database）： 預設為 postgres。你也可選擇連接 ServBay 內你建立的其他 PostgreSQL 資料庫。
   • 使用者名稱（Username）： 預設為 servbay。
   • 密碼（Password）： 於 ServBay 應用的 資料庫 分頁可查詢 PostgreSQL 使用者密碼。
   • 連線方式（選用）： 如 MariaDB/MySQL，你亦可選用 Socket 連線。在 驅動程式屬性（Driver properties） 查找 socketFactory 或類似項目，配置 Socket 檔案路徑，預設為 /Applications/ServBay/tmp/.s.PGSQL.5432（若連線失敗，請改用 /Applications/ServBay/tmp）。具體設定可略因 DBeaver 版本而異，通常可於連線屬性進階設定中調整。使用 Socket 連線時，主機及埠號通常可留白。
5. 點選 「測試連線」。若測試失敗，請檢查 ServBay PostgreSQL 服務是否執行，帳密是否正確。如密碼遺忘，可於 ServBay 資料庫 分頁重設 PostgreSQL 密碼。
6. 測試通過後，點選 「完成」 儲存連線。

基本資料庫操作

連線成功後，你可於 DBeaver 的資料庫導覽器看到 ServBay 的 PostgreSQL 實例。大部分關聯式資料庫的基本操作（如建立資料庫、資料表、查詢、編輯資料、匯入/匯出）在 DBeaver 的操作流程與 MariaDB/MySQL 類似，可透過 SQL 編輯器或圖形介面執行。

使用 DBeaver 管理 ServBay 的 SQLite 3 資料庫

ServBay 亦支援 SQLite 3。SQLite 為一套輕量、檔案型資料庫引擎，無需獨立資料庫伺服器進程。

前置條件

• ServBay 已安裝並執行。
• DBeaver 客戶端已安裝。
• 你需具備一個 SQLite 資料庫檔案（.db、.sqlite、.sqlite3 等），如未有可於建立連線時直接新建。

連接 SQLite

1. 開啟 DBeaver。
2. 點擊左上角的 「新建資料庫連線」。
3. 於資料庫類型搜尋並選擇 「SQLite」，點 「下一步」。
4. 輸入連線資訊：
   • 資料庫檔案路徑（Database File）： 點右側資料夾圖示，挑選或輸入完整的 SQLite 資料庫路徑。ServBay 建議將此類檔案存放於 /Applications/ServBay/db/sqlite/，以便管理及備份。
   • 若目標資料庫檔尚不存在，請輸入你想新建的檔名路徑，DBeaver 會於儲存時自動建立。
5. 點選 「測試連線」。如果檔案路徑正確且可存取即會通過。
6. 測試成功後，按 「完成」 儲存連線。

基本資料庫操作（SQLite）

成功連線 SQLite 檔案後，你可如同管理其他資料庫一般操作，惟 SQLite 功能較為簡化。

• 新建資料表： 右鍵連線名稱，選 「建立新表」。
• 使用 SQL 編輯器： 右鍵連線名稱，選 「SQL 編輯器」 -> 「新建 SQL 腳本」，輸入 SQL 並執行。
• 瀏覽與編輯資料： 雙擊表名可檢視和編輯內容。
• 刪除資料表： 右鍵表名，選 「刪除」。
• 刪除資料庫： SQLite 資料庫即檔案，欲刪除資料庫，直接於檔案系統刪除 .db 檔案即可。

使用 DBeaver 管理 ServBay 的 Redis 資料庫

Redis 是一套開源的記憶體資料結構存放系統，可作資料庫、快取與訊息代理。ServBay 同樣提供 Redis 整合。

前置條件

• ServBay 已安裝並執行。
• Redis 套件於 ServBay 已啟動。
• DBeaver 客戶端已安裝。

連接 Redis

1. 開啟 DBeaver。
2. 點擊左上角 「新建資料庫連線」。
3. 於資料庫類型搜尋並選擇 「Redis」，點 「下一步」。
4. 輸入連線資訊：
   • 主機（Host）： 127.0.0.1（或 localhost）
   • 埠號（Port）： 6379（Redis 預設埠號）
   • 密碼（Password）： ServBay 安裝的 Redis 預設無密碼，通常留空即可。若你的 ServBay Redis 有設定密碼，請於此輸入。
5. 點 「測試連線」。如失敗請檢查 ServBay Redis 服務是否啟動、埠號與密碼。
6. 測試成功後按 「完成」 儲存連線。

基本資料管理（Redis）

成功連線 Redis 後，DBeaver 提供圖形介面瀏覽與管理 Redis 的鍵值資料。

• 查看鍵值： 在資料庫導覽器展開連線，選擇資料庫（通常為 DB 0），即可見鍵清單。
• 新增鍵值： 右鍵點資料庫節點或清單空白處，選 「新建鍵」。輸入鍵名稱、型別（String、List、Set、Hash、ZSet 等），再給值。
• 編輯鍵值： 雙擊或右鍵既有鍵，選 「編輯鍵」，可修改值或 TTL（存活時間）。
• 刪除鍵值： 右鍵鍵名稱，選 「刪除鍵」。
• 使用 Redis 主控台： 右鍵連線名稱或資料庫，選 「SQL 編輯器」 -> 「新建 Redis 控制台」，即可直接輸入與執行 Redis 命令。

常見問題與故障排除（FAQ）

• 連線失敗，顯示 Connection Refused（連線被拒）：
  • 請確認 ServBay 應用正在執行。
  • 確定相關資料庫服務（MariaDB/MySQL、PostgreSQL、Redis）在 ServBay 已啟動並維持綠燈狀態。
  • 檢查連線參數中的主機（Host）與埠號（Port）是否正確。連接本機時，一般為 127.0.0.1 及預設埠號（MariaDB/MySQL: 3306, PostgreSQL: 5432, Redis: 6379）。
  • 若用的是 Socket 連線，確保 Socket 檔案路徑正確且服務配置使用此 Socket。
  • 檢查防火牆（或系統安全防護）未阻擋 DBeaver 與本地埠通訊。
• 連線通過但驗證失敗（Authentication Failed）：
  • 檢查輸入的使用者名稱與密碼是否正確。你可於 ServBay 資料庫 分頁查詢或重設 root/預設使用者密碼。
• SQLite 連線時路徑錯誤：
  • 確認檔案路徑輸入正確且完整。
  • 確保 DBeaver 有該路徑的讀寫權限。
• DBeaver 介面異常或顯示不完整：
  • 嘗試重啟 DBeaver。
  • 確定 Java 執行環境（DBeaver 需依賴 Java）無問題。

總結

DBeaver 作為一款功能全面的通用資料庫管理工具，結合 ServBay 本地開發環境，可大幅提升你管理各類資料庫的效率。透過本篇說明，你可以輕鬆將 DBeaver 連接至 ServBay 內建的 MariaDB/MySQL、PostgreSQL、SQLite 和 Redis 資料庫，完成日常開發及管理任務。無論是資料瀏覽、編輯、執行 SQL 查詢，或進行進階的資料庫維運，DBeaver 都能提供一致高效的體驗。配合 ServBay 的便捷環境管理，你的本地開發流程將更順暢高效。