如何使用 TablePlus 管理 ServBay 中的資料庫

ServBay 是一款專為 macOS 設計的本地 Web 開發環境，整合多種程式語言、Web 伺服器與資料庫系統，為開發者打造一站式開發平台。為了更方便管理 ServBay 內建的資料庫（如 MySQL/MariaDB、PostgreSQL、SQLite、Redis、MongoDB 等），選用一款功能強大的第三方資料庫管理工具，是提升效率的最佳選擇。TablePlus 便是一款現代化、直觀且支援多類資料庫的客戶端工具，非常適合搭配 ServBay 一起使用。

本文將詳細教學如何在 macOS 上用 TablePlus 連接與管理 ServBay 中提供的各種資料庫。

什麼是 TablePlus？

TablePlus 是一套功能強大又易於使用的資料庫管理 GUI 工具。它支援廣泛的資料庫類型，包括但不限於：

• 關聯式資料庫：MySQL、MariaDB、PostgreSQL、SQLite、SQL Server
• NoSQL 資料庫：Redis、MongoDB
• 其他：Cassandra、Oracle 等

TablePlus 擁有一系列設計，讓資料庫的開發、管理與維護變得簡單：

• 直觀的介面： 簡潔明瞭，操作易上手。
• 反應快速： 為效能最佳化而設計，即使操作大型資料集依然流暢。
• 強大查詢編輯器： 提供語法高亮、自動補全與多分頁查詢。
• 資料編輯和瀏覽： 快速瀏覽、插入、更新與刪除資料。
• 結構管理： 具備可視化的表格、索引、檢視等結構管理工具。
• 安全連線： 支援 SSL/TLS 加密連線。

對於進行本地開發的 ServBay 用戶來說，TablePlus 能極大提升資料庫操作效率。

連接 ServBay 資料庫至 TablePlus

ServBay 會於本地自動啟動多種資料庫服務。你可於 ServBay 應用介面的 軟體包 (Packages) 分頁檢視已安裝與運行中的資料庫狀態。要連接這些資料庫到 TablePlus，需要取得正確的連線參數，這些可於 ServBay 的 資料庫 (Databases) 分頁中找到。

下文說明連結各種 ServBay 資料庫的步驟與參數。

連接 MariaDB 或 MySQL

ServBay 預設安裝並運行 MariaDB（與 MySQL 高度相容）。

1. 下載並安裝 TablePlus：如尚未安裝，請由 TablePlus 官方網站 下載適用於 macOS 的 TablePlus。
2. 啟動 TablePlus 並新增連線：
   • 開啟 TablePlus。
   • 點擊左上角的「+」圖示或選單 File -> New -> Connection...。
   • 彈出視窗時，選擇資料庫類型為 MariaDB 或 MySQL。
3. 設定連線資訊：
   • Name（名稱）： 給連線命名，例如 ServBay MariaDB。
   • Host（主機）： 127.0.0.1（本機連線）
   • Port（連接埠）： 3306（MariaDB/MySQL 預設埠）
   • User（用戶名）： 於 ServBay 的 資料庫 (Databases) 分頁中查找 MariaDB/MySQL 的 root 帳號（一般為 root）。
   • Password（密碼）： 同上，查詢 root 密碼。
   • Database（資料庫）： 可留空，連線後再選擇；或直接輸入要連線的資料庫名稱。
   • Alternative（替代方式）： 也可使用 Socket 連線，通常比 TCP/IP 更快且直接。
     • 勾選 Use socket file。
     • Socket Path（檔案路徑）： /Applications/ServBay/tmp/mysql.sock（為 ServBay MariaDB/MySQL 預設 socket 路徑）
     • 使用 Socket 連線時，Host 和 Port 不需設置。
4. 測試連線並儲存：
   • 點擊右下角 Test 按鈕，測試連線參數是否正確。成功即表示無誤。
   • 點選 Connect 建立連線，或先用 Save 儲存設定方便日後重複使用。

連接 PostgreSQL

ServBay 也支援運行 PostgreSQL。

1. 啟動 TablePlus 並新增連線：
   • 開啟 TablePlus。
   • 點「+」或選單 File -> New -> Connection...。
   • 選擇 PostgreSQL。
2. 設定連線資訊：
   • Name： 例如 ServBay PostgreSQL。
   • Host： 127.0.0.1
   • Port： 5432（PostgreSQL 預設埠）
   • User： 於 ServBay 資料庫 (Databases) 分頁查詢預設用戶名（一般為 servbay）。
   • Password： 查詢預設密碼。
   • Database： 需指定初始資料庫，可用預設 postgres 或自訂資料庫。
   • Alternative： 亦可以 Socket 連線。
     • 勾選 Use socket file。
     • Socket Path： /Applications/ServBay/tmp/.s.PGSQL.5432（為預設 socket 路徑）
     • Socket 連線時，Host 和 Port 不需設置。
3. 測試連線並儲存：
   • 點 Test 驗證連線。
   • 按 Connect 或 Save。

連接 SQLite 3

SQLite 是無伺服器、自給自足的資料庫引擎，資料存在單一檔案中。ServBay 並不「執行」 SQLite 伺服器進程，你的應用可用 PHP PDO SQLite 或 Python sqlite3 模組來存取 SQLite 檔案。而 TablePlus 可直接連接該檔案進行管理。

1. 啟動 TablePlus 並新增連線：
   • 開啟 TablePlus。
   • 點「+」或選單 File -> New -> Connection...。
   • 選擇 SQLite。
2. 設定連線資訊：
   • Name： 例如 ServBay SQLite Project。
   • Database File（資料庫檔）： 點右側資料夾圖示，瀏覽並選定 SQLite 資料庫檔（如 .sqlite、.db、.sqlite3）。建議將資料庫檔存放於專案目錄或 ServBay 推薦的 /Applications/ServBay/db/sqlite 管理。
3. 測試連線並儲存：
   • 點 Test（檔案存在且可讀時）。
   • 點 Connect 或 Save。

連接 Redis

Redis 為高效率鍵值資料庫，ServBay 可安裝與運行 Redis 服務。

1. 啟動 TablePlus 並新增連線：
   • 開啟 TablePlus。
   • 點「+」或選單 File -> New -> Connection...。
   • 選擇 Redis。
2. 設定連線資訊：
   • Name： 例如 ServBay Redis。
   • Host： 127.0.0.1
   • Port： 6379（Redis 預設埠）
   • Password： 若有設定密碼則填寫，ServBay 預設通常無密碼可留空。
3. 測試連線並儲存：
   • 點 Test 驗證。
   • 按 Connect 或 Save。

連接 MongoDB

ServBay 可安裝並執行 MongoDB。

1. 啟動 TablePlus 並新增連線：
   • 開啟 TablePlus。
   • 點「+」或選單 File -> New -> Connection...。
   • 選擇 MongoDB。
2. 設定連線資訊：
   • Name： 例如 ServBay MongoDB。
   • Host： 127.0.0.1
   • Port： 27017（MongoDB 預設埠）
   • User： 如有啟用帳號驗證請填寫，預設未啟動時可留空。
   • Password： 如啟用驗證則填密碼。
   • Authentication Database： 若需驗證請指定，如 admin。
   • Database： 可留空，或指定欲連線的資料庫名。
3. 測試連線並儲存：
   • 點 Test 驗證。
   • 按 Connect 或 Save。

使用 TablePlus 管理關聯式資料庫（MariaDB/MySQL、PostgreSQL、SQLite）

連線成功後，TablePlus 介面與操作流程在 MariaDB/MySQL、PostgreSQL 與 SQLite 這幾類關聯式資料庫都非常類似。

1. 建立資料庫

• 成功連線伺服器後（SQLite 則是連接檔案），左側邊欄會顯示連線資訊。
• MariaDB/MySQL 和 PostgreSQL 點左側 Databases 標籤。
• 點左上「+」或右鍵空白選 New Database...。
• 輸入資料庫名稱、選定字集和排序（如需）。
• 點 Save。

2. 建立資料表

• 在左側邊欄選擇欲新增資料表的資料庫。
• 點左側 Tables 標籤。
• 點左上「+」或右鍵空白選 New Table...。
• 輸入表名。
• 在下方區塊逐一定義欄位：
  • 點「+」新增欄位。
  • 輸入欄位名稱。
  • 選擇資料型態。
  • 設定長度或預設值（如型態需）。
  • 勾選 PK 設為主鍵，NN 為不可為空，UQ 唯一索引，AI 自動遞增等。
  • 可設預設值、加註解。
• 完成後點左上 Save（或快捷鍵 Cmd + S）儲存結構。

3. 新增資料

• 左側選定要操作的資料庫與資料表。
• 點 Tables，再選想新增資料的表。
• 在資料檢視下方點 + Row。
• 新增空白行出現，雙擊欄格輸入內容。
• 填完後，點 Save（或 Cmd + S）儲存。

4. 查詢資料

• 左側選定資料庫與資料表。
• 直接於資料檢視瀏覽或用篩選欄搜尋。
• 進階查詢可用查詢編輯器：
  • 點工具列 SQL Query 或 Cmd + N 新增查詢頁。
  • 輸入 SQL 查詢語句（如 SELECT * FROM your_table WHERE condition;）。
  • 點 Run Current（閃電圖標）或 Cmd + Enter 執行，結果會下方顯示。

5. 編輯資料

• 於資料檢視直接雙擊要改的欄位。
• 輸入新值後，點 Save（或 Cmd + S）儲存。

6. 刪除資料

• 於資料檢視選擇要刪的列。
• 右鍵選 Delete Row(s)。
• 在確認對話中點 Delete。
• 點 Save（或 Cmd + S）儲存。

7. 刪除資料表

• 左側選擇包含欲刪資料表的資料庫。
• 點 Tables。
• 選中要刪的一個或多個表。
• 右鍵選 Delete Table(s)。
• 輸入確認文字後點 Delete。

8. 刪除資料庫

• MariaDB/MySQL 或 PostgreSQL 於左側 Databases 點選要刪的資料庫。
• 右鍵選 Delete Database。
• 輸入確認文字後點 Delete。
• SQLite： 刪除資料庫即實體移除 .sqlite 檔案，需至檔案系統手動刪除。

使用 TablePlus 管理 NoSQL 資料庫（Redis、MongoDB）

TablePlus 對於 Redis 與 MongoDB 有專屬管理介面，操作方式略有不同於關聯式資料庫。

管理 Redis 資料

成功連線 Redis 後：

• 左側邊欄會顯示 Redis 各資料庫（DB0、DB1 ...），預設多用 DB0。
• 選取資料庫後，右側顯示所有鍵（Keys）。
• 瀏覽鍵： 直接瀏覽或用上方搜尋框過濾，點擊可檢視型別與值。無論是 string、hash、list、set、zset 等 TablePlus 都會以適合格式呈現。
• 新增鍵： 點底部 + Row，選型別、鍵名與值。填妥後點 Save。
• 編輯鍵： 雙擊名字或值區域修改，完畢點 Save。
• 刪除鍵： 選中一個或多個鍵，右鍵點 Delete Row(s)，確認後刪除。

管理 MongoDB 資料

連線 MongoDB 後：

• 左側邊欄顯示資料庫清單。
• 選擇資料庫時，右側顯示該庫所有集合（Collections）。
• 瀏覽集合資料： 雙擊集合名稱，右側切到文件視圖，一般以 JSON 格式呈現。
• 新增文件： 於集合頁點 + Row，會產生空文件，雙擊欄位輸入後存檔。
• 編輯文件： 雙擊欄位或內容，TablePlus 亦支援直接編輯原始 JSON/BSON，完畢點存檔。
• 刪除文件： 勾選文件，右鍵 Delete Row(s)，確認後刪除。
• 新增集合： 左側選資料庫，於 Collections 分頁點「+」或右鍵選 New Collection... 輸入名稱存檔。
• 刪除集合： 確認後於 Collections 分頁右鍵選 Delete Collection(s) 刪除。
• 刪除資料庫： 左側資料庫右鍵 Delete Database 並確認。

注意事項與常見問答

• ServBay 狀態： 連線前請確保 ServBay 應用運作中，且欲連接的資料庫服務（如 MariaDB、PostgreSQL、Redis、MongoDB）在 軟體包 (Packages) 分頁顯示為「運行中」。
• 防火牆： 請確認 macOS 防火牆或其他安全軟體未阻擋 TablePlus 與本地埠（3306、5432、6379、27017）通信。
• 取得帳號密碼： 資料庫預設帳號和密碼可於 ServBay 資料庫 (Databases) 分頁查詢，請妥善保存。
• 修改預設密碼： 為安全，強烈建議修改預設 root 或預設用戶密碼。ServBay 的 資料庫 (Databases) 分頁通常提供密碼重設，請同步更新 TablePlus 連線設定。
• Socket 與 Port 差異： Socket 為檔案系統路徑，僅限本機，效能較佳；Port（TCP/IP）可支援本地與網路連線，ServBay 兩種通常皆可用。
• 可用其他工具？ 當然可！如 DBeaver、DataGrip、Sequel Ace（MySQL/MariaDB）、pgAdmin（PostgreSQL）、MongoDB Compass 等都支援，只要取用 ServBay 提供正確連線資料即可。

總結

經由本教學，你已學會如何用 TablePlus 在 macOS 上連接與高效管理 ServBay 本地開發環境中的各種資料庫。TablePlus 的強大功能與友好介面，結合 ServBay 的一體化本地環境，將大幅提升你的開發體驗。記得從 ServBay 應用取得正確的連線資料，是成功連結的關鍵。祝開發順利！