如何使用 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。
• 在 ServBay 中已啟動 MariaDB/MySQL 套件。
• 已下載並安裝 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。
• 在 ServBay 中已啟動 PostgreSQL 套件。
• 已安裝 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 執行個體。多數關聯式資料庫基本操作（包含新建資料庫、資料表、查詢、編輯及匯入/匯出）皆與 MariaDB/MySQL 管理流程一致，可利用 SQL 編輯器或視覺化介面輕鬆完成。

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

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

必要條件

• 已安裝並啟動 ServBay。
• 已安裝 DBeaver 客戶端。
• 需準備一個 SQLite 資料庫檔案（如 .db、.sqlite 或 .sqlite3 等）。若尚未有資料檔，DBeaver 可於新增連線時自動建立。

連接 SQLite

1. 開啟 DBeaver。
2. 點擊左上角 「新增資料庫連線」 按鈕。
3. 在資料庫類型列表中搜尋並選擇 「SQLite」，然後點擊 「下一步」。
4. 輸入連線資訊：
   • 資料庫檔案路徑 (Database File)： 點選旁邊的資料夾圖示，選擇或輸入你的 SQLite 資料庫完整路徑。建議將資料檔存放於 /Applications/ServBay/db/sqlite/ 目录，便於管理與備份。
   • 若指定的資料庫檔尚不存在，可直接輸入欲建立的檔案名稱，DBeaver 會自動於連線時建立該檔。
5. 點擊 「測試連線」。若路徑正確且可存取，便可成功連線。
6. 測試成功後，點擊 「完成」 保存連線。

基本資料庫操作（SQLite）

成功連接 SQLite 檔案後，可如管理其他資料庫般於 DBeaver 進行操作，雖然 SQLite 功能較為簡單。

• 建立資料表： 於資料庫連線名稱右鍵選單選擇 「建立新表」。
• 使用 SQL 編輯器： 右鍵連線名稱，選擇 「SQL 編輯器」 → 「新增 SQL 腳本」，輸入 SQL 指令並執行。
• 瀏覽及編輯資料： 雙擊資料表即可檢視及編輯內容。
• 刪除資料表： 於資料表名稱右鍵選單選擇 「刪除」。
• 刪除資料庫： SQLite 為檔案式資料庫，欲刪除只需於檔案系統移除對應的 .db 檔即可。

使用 DBeaver 管理 ServBay 內建的 Redis 資料庫

Redis 為開源的記憶體型資料結構儲存引擎，可做資料庫、快取及訊息代理。ServBay 也預設整合了 Redis。

必要條件

• 已安裝並啟動 ServBay。
• 在 ServBay 中已啟動 Redis 套件。
• 已安裝 DBeaver 客戶端。

連接 Redis

1. 開啟 DBeaver。
2. 點擊左上角 「新增資料庫連線」 按鈕。
3. 在資料庫類型列表中搜尋並選擇 「Redis」，然後點擊 「下一步」。
4. 輸入連線資訊：
   • 主機 (Host)： 127.0.0.1（或 localhost）
   • 連接埠 (Port)： 6379（Redis 預設埠）
   • 密碼 (Password)： 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 的環境管理優勢，你的本地開發流程將更加順暢高效。