如何使用 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 高度相容）。

下載並安裝 TablePlus：如尚未安裝，請由 TablePlus 官方網站下載適用於 macOS 的 TablePlus。
啟動 TablePlus 並新增連線：
- 開啟 TablePlus。
- 點擊左上角的「+」圖示或選單 File -> New -> Connection...。
- 彈出視窗時，選擇資料庫類型為 MariaDB 或 MySQL。
設定連線資訊：
- 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 不需設置。
測試連線並儲存：
- 點擊右下角 Test 按鈕，測試連線參數是否正確。成功即表示無誤。
- 點選 Connect 建立連線，或先用 Save 儲存設定方便日後重複使用。

連接 PostgreSQL

ServBay 也支援運行 PostgreSQL。

啟動 TablePlus 並新增連線：
- 開啟 TablePlus。
- 點「+」或選單 File -> New -> Connection...。
- 選擇 PostgreSQL。
設定連線資訊：
- 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 不需設置。
測試連線並儲存：
- 點 Test 驗證連線。
- 按 Connect 或 Save。

連接 SQLite 3

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

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

連接 Redis

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

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

連接 MongoDB

ServBay 可安裝並執行 MongoDB。

啟動 TablePlus 並新增連線：
- 開啟 TablePlus。
- 點「+」或選單 File -> New -> Connection...。
- 選擇 MongoDB。
設定連線資訊：
- Name： 例如 ServBay MongoDB。
- Host： 127.0.0.1
- Port： 27017（MongoDB 預設埠）
- User： 如有啟用帳號驗證請填寫，預設未啟動時可留空。
- Password： 如啟用驗證則填密碼。
- Authentication Database： 若需驗證請指定，如 admin。
- Database： 可留空，或指定欲連線的資料庫名。
測試連線並儲存：
- 點 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 應用取得正確的連線資料，是成功連結的關鍵。祝開發順利！

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

什麼是 TablePlus？ ​

連接 ServBay 資料庫至 TablePlus ​

連接 MariaDB 或 MySQL ​

連接 PostgreSQL ​

連接 SQLite 3 ​

連接 Redis ​

連接 MongoDB ​

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

1. 建立資料庫 ​

2. 建立資料表 ​

3. 新增資料 ​

4. 查詢資料 ​

5. 編輯資料 ​

6. 刪除資料 ​

7. 刪除資料表 ​

8. 刪除資料庫 ​

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

管理 Redis 資料 ​

管理 MongoDB 資料 ​

注意事項與常見問答 ​

總結 ​