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

ServBay 是一套支援 macOS 與 Windows 的本機網頁開發環境。它整合了多種程式語言、網頁伺服器及資料庫系統，為開發者打造一站式的開發平台。為了更方便管理 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)： 至 ServBay 的 資料庫 (Databases) 分頁查詢 root 密碼
   • 資料庫 (Database)： 可留空，連線後再選擇；或填入欲連線之具體資料庫名稱
   • 補充選項： 您也可選用 Socket 連線方式，通常比 TCP/IP 稍快且直接
     • 勾選 Use socket file
     • Socket 路徑 (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)： 至 ServBay 的 資料庫 (Databases) 分頁查詢預設密碼
   • 資料庫 (Database)： 通常須選擇初始資料庫，可用預設的 postgres 或您在 ServBay 建立的其他資料庫
   • 補充選項： 亦可選擇 Socket 連線
     • 勾選 Use socket file
     • Socket 路徑 (Socket Path)： /Applications/ServBay/tmp/.s.PGSQL.5432（ServBay PostgreSQL 預設 socket 路徑）
     • 使用 Socket 連線時會忽略 Host 和 Port
3. 測試並儲存連線：
   • 點選 Test 驗證連線
   • 點選 Connect 或 Save

連接 SQLite 3

SQLite 資料庫屬於無伺服器、獨立型態，資料儲存於單一檔案中。ServBay 並不會「運行」一個 SQLite 伺服器，但您的應用可利用 ServBay 提供的 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)： 若有設定 Redis 密碼請輸入。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)： 若有設定 MongoDB 認證請輸入帳號。ServBay 預設安裝可能未開啟認證，此時帳號密碼可空白
   • 密碼 (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. 查詢資料

• 側邊欄選擇資料庫和資料表
• 直接在表格檢視視窗中滾動瀏覽
• 利用頂部篩選框（Filter）快速查找
• 如需複雜查詢，可用 TablePlus 的 SQL 編輯器：
  • 點工具列的 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）
• 瀏覽鍵值： 可直接瀏覽鍵名，利用篩選框搜尋。點選鍵名可查看型態與鍵值。TablePlus 會依型態（字串、雜湊、串列、集合、排序集合等）展示適當格式
• 新增鍵值： 點底部 + Row，選型態，輸入鍵名及值。點左上角 Save
• 編輯鍵值： 雙擊鍵名稱或值區編輯。編輯後點 Save
• 刪除鍵值： 選取一或多個鍵，右鍵選 Delete Row(s)，確認後點 Delete

管理 MongoDB 資料

連線至 MongoDB 實例後：

• 側邊欄顯示 MongoDB 的資料庫列表
• 選擇資料庫後，右側顯示集合（Collections）
• 瀏覽集合資料： 雙擊集合名稱，右側切換到該集合的文件檢視，內容以 JSON 或類似格式顯示
• 新增文件： 集合資料檢視中，點底部 + Row，TablePlus 會產生新空白文件。雙擊欄位編輯，完成點左上角 Save
• 編輯文件： 文件欄位可雙擊編輯，TablePlus 也支援直接修改原始 JSON/BSON。完成點 Save
• 刪除文件： 資料檢視中選取文件，右鍵選 Delete Row(s)，點選確認後刪除
• 新增集合： 側邊欄選擇資料庫，點 Collections 分頁左上角「+」或右鍵空白處選 New Collection...，輸入名稱後點選 Save
• 刪除集合： 側邊欄於 Collections 分頁選取目標集合，右鍵選 Delete Collection(s)，確認後刪除
• 刪除資料庫： 側邊欄選取目標資料庫，右鍵選 Delete Database，確認後刪除

注意事項與常見問答

• ServBay 狀態： 在使用 TablePlus 連接資料庫前請確保 ServBay 應用正在執行，且您欲連線的資料庫服務（如 MariaDB、PostgreSQL、Redis、MongoDB）於 套件 (Packages) 分頁標示「執行中」
• 防火牆： 請確保 macOS 內建防火牆或第三方防護軟體，未阻擋 TablePlus 與本機資料庫埠（3306、5432、6379、27017）的通訊
• 取得憑證： 再次提醒，資料庫預設帳號、密碼可在 ServBay 的 資料庫 (Databases) 分頁查詢。請妥善保存這些資訊
• 修改預設密碼： 為安全請建議於 ServBay 修改預設 root 或預設使用者密碼。資料庫 (Databases) 分頁通常提供重設密碼功能。重設完請同步 TablePlus 連線設定密碼
• Socket vs. Port 連線： Socket 連線是經檔案系統路徑作進程間溝通，多用於同機器且效能優於 TCP/IP (Port) 連線，不受網路環境限制。Port 連線經由 TCP/IP，可用 127.0.0.1 本機或其它伺服器。於 ServBay 本地環境兩種方式皆可
• 可以選用其他管理工具嗎？ 當然可以。除 TablePlus 外，尚有 DBeaver、DataGrip、Sequel Ace（MySQL/MariaDB）、pgAdmin（PostgreSQL）、MongoDB Compass（MongoDB）等著名工具。請依個人偏好及需求選用。只要於 ServBay 資料庫 (Databases) 取得正確連線資訊即可

總結

透過本指南，您已能於 macOS 使用 TablePlus 連線並高效管理 ServBay 本機開發環境中的各類資料庫。TablePlus 強大功能與友善介面，結合 ServBay 的整合本機環境，將大幅提升您的開發效率。記得從 ServBay 應用中正確取得連線憑證，是成功連線的關鍵。祝您開發順利！