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는 데이터베이스 개발·관리·유지를 간소화하는 다양한 기능을 제공합니다:
- 직관적인 인터페이스: 깔끔하고 명확한 UI로 탐색과 조작이 쉽습니다.
- 빠른 반응 속도: 대용량 데이터도 효율적으로 처리하는 최적화된 성능.
- 강력한 쿼리 에디터: 구문 하이라이트, 자동 완성, 멀티 탭 쿼리 지원.
- 데이터 편집 및 조회: 데이터의 삽입, 수정, 삭제, 조회를 신속하게 할 수 있습니다.
- 구조 관리: 테이블 구조, 인덱스, 뷰 등을 시각적으로 관리.
- 보안 연결: SSL/TLS 암호화 연결 지원.
ServBay로 로컬 개발을 진행하는 개발자라면 TablePlus를 통해 데이터베이스 작업 효율을 크게 향상시킬 수 있습니다.
ServBay 데이터베이스를 TablePlus에 연결하기
ServBay는 여러 데이터베이스 서비스를 로컬에서 기본적으로 실행합니다. ServBay 앱의 패키지(Packages) 탭에서 설치 및 실행 중인 데이터베이스 서비스를 확인할 수 있습니다. TablePlus에서 이를 연결하려면 올바른 연결 정보를 알아야 하며, 해당 정보는 ServBay의 데이터베이스(Databases) 탭에서 찾을 수 있습니다.
아래는 ServBay의 각 데이터베이스별 연결 방법과 필요한 정보입니다.
MariaDB 또는 MySQL 연결하기
ServBay는 기본적으로 MariaDB(상호 호환되는 MySQL 포함)를 설치 및 구동합니다.
- TablePlus 다운로드 및 설치: 아직 설치하지 않았다면 TablePlus 공식 웹사이트에서 macOS용 클라이언트를 다운로드 후 설치하세요.
- TablePlus에서 새 연결 만들기:
- TablePlus를 실행합니다.
- 좌상단 "+" 아이콘 클릭 또는 메뉴
File
->New
->Connection...
선택. - 새 창에서 데이터베이스 타입을
MariaDB
나MySQL
로 지정합니다.
- 연결 정보 입력:
- Name: 예:
ServBay MariaDB
와 같이 알아보기 쉬운 이름. - Host:
127.0.0.1
(로컬 연결) - Port:
3306
(MariaDB/MySQL 기본 포트) - User: ServBay의 데이터베이스(Databases) 탭에서 확인한 root 사용자명(보통
root
) - Password: ServBay의 데이터베이스(Databases) 탭에서 확인한 root 비밀번호
- Database: 비워두거나, 연결할 데이터베이스 이름 입력
- 대체 방법: Socket 방식 연결도 가능. TCP/IP보다 빠르고 직관적일 수 있습니다.
- Use socket file 선택.
- Socket Path:
/Applications/ServBay/tmp/mysql.sock
(ServBay MariaDB/MySQL 기본 소켓 경로) - Socket 연결 시
Host
와Port
는 무시됩니다.
- Name: 예:
- 연결 테스트 및 저장:
- 우하단의
Test
버튼으로 연결정보를 검증합니다. 성공 시 설정이 올바른 것입니다. Connect
로 연결하거나,Save
로 저장해 두었다가 이후 사용할 수 있습니다.
- 우하단의
PostgreSQL 연결하기
ServBay는 PostgreSQL 데이터베이스도 지원합니다.
- TablePlus에서 새 연결 만들기:
- TablePlus를 실행합니다.
- "+" 아이콘 클릭 또는 메뉴
File
->New
->Connection...
선택. PostgreSQL
타입을 선택합니다.
- 연결 정보 입력:
- Name: 예:
ServBay PostgreSQL
- Host:
127.0.0.1
- Port:
5432
(기본 포트) - User: ServBay의 데이터베이스(Databases) 탭에서 확인한 사용자명(일반적으로
servbay
) - Password: 같은 탭에서 확인한 기본 비밀번호
- Database: 최초 연결할 데이터베이스명(기본
postgres
또는 생성한 DB명) - 대체 방법: Socket 연결 사용 가능
- Use socket file 선택
- Socket Path:
/Applications/ServBay/tmp/.s.PGSQL.5432
(기본 소켓 경로) - Socket 방식에서는
Host
와Port
가 무시됩니다.
- Name: 예:
- 연결 테스트 및 저장:
Test
버튼으로 연결 확인Connect
또는Save
클릭
SQLite 3 연결하기
SQLite 데이터베이스는 서버리스이며 파일로 데이터를 저장합니다. ServBay는 SQLite 서버 프로세스를 별도로 구동하지 않으며, PHP PDO SQLite, Python sqlite3
등으로 파일을 직접 접근합니다. TablePlus 역시 해당 SQLite 파일에 직접 연결할 수 있습니다.
- TablePlus에서 새 연결 만들기:
- TablePlus를 실행합니다.
- "+" 아이콘 또는 메뉴
File
->New
->Connection...
클릭 SQLite
타입 선택
- 연결 정보 입력:
- Name: 예:
ServBay SQLite Project
- Database File: 우측 폴더 아이콘을 눌러
.sqlite
,.db
,.sqlite3
등 확장자를 가진 데이터베이스 파일을 선택합니다. 프로젝트 디렉토리 또는 ServBay 추천 디렉토리/Applications/ServBay/db/sqlite
에 보관하는 것이 관리에 편리합니다.
- Name: 예:
- 연결 테스트 및 저장:
- 파일이 존재하고 읽을 수 있으면
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의 Redis에 비밀번호를 설정했다면 입력. 기본값은 비밀번호 없음(공란).
- Name: 예:
- 연결 테스트 및 저장:
Test
버튼으로 연결 확인Connect
혹은Save
클릭
MongoDB 연결하기
ServBay에서 MongoDB를 설치 및 구동할 수 있습니다.
- TablePlus에서 새 연결 만들기:
- TablePlus를 실행합니다.
- "+" 아이콘 또는 메뉴
File
->New
->Connection...
선택 MongoDB
데이터베이스 타입 선택
- 연결 정보 입력:
- Name: 예:
ServBay MongoDB
- Host:
127.0.0.1
- Port:
27017
(MongoDB 기본 포트) - User: MongoDB에 인증을 설정한 경우 사용자명을 입력. 기본 설치 시 인증이 꺼져 있을 수 있어 공란 가능.
- Password: 인증을 설정했다면 비밀번호 입력
- Authentication Database: 인증이 있을 경우 예시로
admin
지정 - Database: 연결 후 선택하거나, 특정 데이터베이스명을 입력
- Name: 예:
- 연결 테스트 및 저장:
Test
버튼으로 연결 확인Connect
혹은Save
클릭
TablePlus로 관계형 데이터베이스(MariaDB/MySQL, PostgreSQL, SQLite) 관리하기
연결이 완료되면 TablePlus는 여러 관계형 데이터베이스(MariaDB/MySQL, PostgreSQL, SQLite)를 유사한 인터페이스와 절차로 관리할 수 있습니다.
1. 데이터베이스 생성
- 서버(혹은 SQLite 파일)에 연결하면, 좌측 사이드바가 보입니다.
- MariaDB/MySQL, PostgreSQL은 Databases 탭 클릭.
- 좌상단 "+"(새로 만들기) 버튼 또는 빈 공간을 오른쪽 클릭 후
New Database...
선택. - 데이터베이스명 입력, 필요시 문자셋 및 정렬 지정.
Save
클릭.
2. 테이블 생성
- 좌측 사이드바에서 테이블을 만들 DB를 선택합니다.
- Tables 탭 클릭.
- "+"(새로 만들기) 또는 빈 곳을 오른쪽 클릭 후
New Table...
선택. - 테이블명 입력.
- 아래 영역에서 컬럼 정의:
- "+"로 컬럼 추가
- 컬럼명 입력
- 데이터 타입 지정
- 타입에 따라 길이 입력
PK
(기본키),NN
(NOT NULL),UQ
(유니크 인덱스),AI
(AUTO_INCREMENT) 등 필요 옵션 선택- 기본값, 설명(Comment) 등 설정 가능
- 모든 컬럼 정의 후 좌상단
Save
또는Cmd + S
로 저장.
3. 데이터 추가
- 사이드바에서 작업할 테이블 포함 DB 선택.
- Tables 탭에서 테이블 선택.
- 테이블 데이터뷰 하단의 + Row 버튼 클릭.
- 새 행이 생기면 셀을 더블 클릭해 데이터 입력.
- 입력 완료 후 좌상단
Save
또는Cmd + S
저장.
4. 데이터 조회
- 사이드바에서 DB와 테이블 선택.
- 테이블 데이터뷰에서 스크롤로 데이터 탐색.
- 상단 필터(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. 테이블 삭제
- 사이드바에서 테이블 포함 DB 선택
- Tables 탭 클릭
- 삭제할 테이블 선택
- 오른쪽 클릭 후
Delete Table(s)
선택 - 확인 창에 보통 테이블명을 입력하고
Delete
클릭
8. 데이터베이스 삭제
- 사이드바에서 MariaDB/MySQL 또는 PostgreSQL의 Databases 탭 클릭
- 삭제할 DB 선택
- 오른쪽 클릭 후
Delete Database
선택 - 확인 창에 DB명 입력 후
Delete
- SQLite는 DB 삭제 시 해당
.sqlite
파일을 직접 파일 시스템에서 삭제해야 합니다.
TablePlus로 NoSQL 데이터베이스(Redis, MongoDB) 관리하기
TablePlus는 Redis와 MongoDB 전용 관리 인터페이스를 제공하며, 관계형 DB와는 다소 다른 방식으로 동작합니다.
Redis 데이터 관리
Redis 인스턴스에 연결하면:
- 좌측 사이드바에 Redis DB 목록(DB0, DB1, ...)이 나옵니다. 기본적으로 DB0을 사용합니다.
- DB 선택 시 우측에 키(Keys) 목록이 표시됩니다.
- 키 조회: 목록에서 키 이름을 탐색. 상단 필터로 특정 키 검색 가능. 키 클릭 시 타입 및 값이 출력되며, 문자열, 해시, 리스트, 집합, 정렬 집합 등 타입별로 데이터가 적합한 형식으로 나타납니다.
- 키 추가: 하단 + Row 버튼 클릭. 키 타입, 이름, 값을 입력 후 좌상단
Save
. - 키 수정: 키 이름 또는 값 영역 더블 클릭 후 편집. 완료 시
Save
. - 키 삭제: 키 선택 → 오른쪽 클릭 →
Delete Row(s)
→ 확인창에서Delete
클릭.
MongoDB 데이터 관리
MongoDB 인스턴스에 연결하면:
- 좌측 사이드바에 MongoDB DB 목록이 나옵니다.
- DB 선택 시 우측에 컬렉션(집합)이 표시됩니다.
- 컬렉션 조회: 컬렉션 이름 더블 클릭 시 문서(데이터)가 오른쪽에 표시됩니다. 문서는 JSON 등으로 출력.
- 문서 추가: 컬렉션 문서뷰에서 하단 + Row 클릭해 새 문서 생성, 필드와 값을 더블 클릭해 입력 후
Save
. - 문서 수정: 문서 내 필드 또는 값 더블 클릭 후 편집. 원본 JSON/BSON 직접 편집도 지원. 완료 후
Save
. - 문서 삭제: 문서 선택 → 오른쪽 클릭 →
Delete Row(s)
→ 확인창에서Delete
클릭. - 컬렉션 생성: 사이드바에서 DB 선택, Collections 탭→ 좌상단 "+" 또는 빈 공간 오른쪽 클릭 후
New Collection...
→ 컬렉션명 입력 후Save
. - 컬렉션 삭제: 사이드바에서 DB 선택, Collections 탭→ 삭제할 컬렉션 선택→ 오른쪽 클릭→
Delete Collection(s)
→ 확인 - 데이터베이스 삭제: 사이드바에서 DB 선택→ 오른쪽 클릭→
Delete Database
→ 확인
주의사항 및 FAQ
- ServBay 실행 상태: TablePlus로 연결 전에 ServBay가 실행 중인지, 해당 DB 서비스(MariaDB, PostgreSQL, Redis, MongoDB)가 패키지(Packages) 탭에서 '실행 중'임을 반드시 확인하세요.
- 방화벽: macOS 방화벽 혹은 서드파티 보안 프로그램이 TablePlus와 로컬 DB 포트(3306, 5432, 6379, 27017)의 통신을 막고 있지 않은지 확인하세요.
- 자격 정보 확인: 데이터베이스 기본 사용자명과 비밀번호는 ServBay 앱의 데이터베이스(Databases) 탭에서 찾을 수 있습니다. 정보는 안전하게 보관하세요.
- 기본 비밀번호 변경: 보안을 위해 ServBay에서 DB root 또는 기본 사용자 비밀번호를 변경하는 것이 좋습니다. 비밀번호 재설정 기능은 보통 ServBay의 데이터베이스(Databases) 탭에서 확인 가능하며, 변경 후 TablePlus 연결정보도 갱신해야 합니다.
- Socket과 Port 연결: Socket 방식은 파일 경로를 통한 직접 프로세스 통신입니다. 같은 머신에서는 TCP/IP(Port) 대비 성능이 다소 뛰어나고 네트워크에 영향받지 않습니다. Port 방식은 TCP/IP로,
127.0.0.1
을 통해 로컬 연결 혹은 네트워크의 외부 DB에도 접근 가능합니다. ServBay 로컬에서는 두 방식 모두 사용할 수 있습니다. - 다른 툴도 사용 가능한가요? 네, 가능합니다. DBeaver, DataGrip, Sequel Ace(MySQL/MariaDB), pgAdmin(PostgreSQL), MongoDB Compass(MongoDB) 등 다양한 인기 DB 관리 툴이 있습니다. 어떤 툴을 쓰든 ServBay 데이터베이스(Databases) 에서 정확한 연결정보만 확인하면 됩니다.
요약
이 가이드에서 macOS 환경에서 TablePlus를 활용해 ServBay 로컬 개발 환경의 다양한 데이터베이스를 연결하고 효율적으로 관리하는 방법을 배웠습니다. TablePlus의 강력하고 친숙한 인터페이스와 ServBay의 통합 로컬 환경은 개발 효율성을 크게 높여줍니다. 꼭 ServBay 앱에서 정확한 DB 연결 정보를 확인하는 것이 성공적인 연결의 핵심입니다. 즐거운 개발 되세요!