TablePlus로 ServBay 데이터베이스 관리하기

ServBay는 macOS에 최적화된 로컬 웹 개발 환경으로, 다양한 프로그래밍 언어와 웹 서버, 데이터베이스 시스템을 통합하여 개발자에게 원스톱 개발 플랫폼을 제공합니다. ServBay에 내장된 MySQL/MariaDB, PostgreSQL, SQLite, Redis, MongoDB 등 데이터베이스를 보다 효율적으로 관리하려면, 강력한 외부 DB 관리 도구를 활용하는 것이 매우 효과적입니다. TablePlus는 현대적이고 직관적인 다중 DB 클라이언트 툴로 ServBay와 함께 사용하기에 매우 적합합니다.

이 문서에서는 macOS에서 TablePlus를 통해 ServBay의 다양한 데이터베이스에 접속·관리하는 방법을 상세히 안내합니다.

TablePlus란 무엇인가?

TablePlus는 강력하면서도 사용자 친화적인 데이터베이스 관리 GUI 툴입니다. 아래와 같은 다양한 데이터베이스를 지원합니다:

• 관계형 데이터베이스: MySQL, MariaDB, PostgreSQL, SQLite, SQL Server
• NoSQL 데이터베이스: Redis, MongoDB
• 기타: Cassandra, Oracle 등

TablePlus는 데이터베이스 개발, 관리 및 유지보수를 단순화하는 다양한 기능을 제공합니다:

• 직관적인 인터페이스: 깔끔하고 명확한 UI, 쉬운 탐색.
• 빠른 반응 속도: 대용량 데이터도 쾌적하게 처리.
• 강력한 쿼리 에디터: 구문 하이라이트, 자동완성, 다중 탭 쿼리 지원.
• 데이터 편집 및 조회: 쉽고 빠른 데이터 조회·삽입·수정·삭제 가능.
• 구조 관리: 테이블 구조, 인덱스, 뷰 등 시각적 관리.
• 보안 접속: SSL/TLS 암호화 지원.

로컬 개발을 위해 ServBay를 사용하는 개발자에게 TablePlus는 DB 조작 효율을 크게 높여줍니다.

ServBay 데이터베이스를 TablePlus에 연결하기

ServBay는 기본적으로 여러 데이터베이스 서비스를 로컬에서 실행합니다. 설치된 DB 서비스의 상태는 ServBay 앱 내 패키지(Packages) 탭에서 확인할 수 있습니다. TablePlus로 접속하려면 올바른 연결 정보를 입력해야 하는데, 이는 ServBay 데이터베이스(Databases) 탭에서 확인할 수 있습니다.

아래는 ServBay의 각 데이터베이스별 연결 방법과 주요 파라미터에 대한 안내입니다.

MariaDB 또는 MySQL 연결

ServBay는 기본적으로 MariaDB를 설치·구동하며, 이는 MySQL과 높은 호환성을 갖습니다.

1. TablePlus 다운로드 및 설치: 아직 설치하지 않았다면 TablePlus 공식 사이트에서 macOS 버전을 받아 설치하세요.
2. TablePlus 실행 및 새 연결 생성:
   • TablePlus 실행.
   • 좌상단 "+" 아이콘 클릭 또는 메뉴에서 File -> New -> Connection... 선택.
   • 뜨는 창에서 DB 타입으로 MariaDB 혹은 MySQL 선택.
3. 접속 정보 입력:
   • Name: 예시로 ServBay MariaDB 등 이해하기 쉬운 이름 입력.
   • Host: 127.0.0.1 (로컬 접속)
   • Port: 3306 (기본 포트)
   • User: ServBay 데이터베이스(Databases) 탭에서 MariaDB/MySQL의 root 계정명(일반적으로 root) 확인.
   • Password: 같은 탭에서 MariaDB/MySQL의 root 비밀번호 확인.
   • Database: 빈 칸으로 두고 접속 후 선택하거나, 원한다면 특정 DB명을 입력.
   • 대안: Socket 방식으로도 접속 가능하며, 일반적으로 TCP/IP보다 빠르고 간편합니다.
     • Use socket file 체크.
     • Socket Path: /Applications/ServBay/tmp/mysql.sock (ServBay의 기본 소켓 경로)
     • 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 (기본 포트)
   • User: ServBay 데이터베이스(Databases) 탭에서 PostgreSQL 기본 계정명(일반적으로 servbay) 확인.
   • Password: 같은 탭에서 PostgreSQL의 비밀번호 확인.
   • Database: 기본 postgres DB 또는 ServBay에서 별도 생성한 DB명 입력.
   • 대안: Socket 방식도 가능.
     • Use socket file 체크.
     • Socket Path: /Applications/ServBay/tmp/.s.PGSQL.5432 (기본 소켓 경로)
     • Socket 연결 시 Host, Port 무시됨.
3. 연결 테스트 및 저장:
   • Test 클릭 후 성공 여부 확인.
   • Connect 또는 Save 클릭.

SQLite 3 연결

SQLite는 서버 프로세스가 없는 독립형 DB로, 데이터를 파일에 저장합니다. ServBay는 SQLite 서버를 실행하지는 않지만, PHP PDO SQLite나 Python sqlite3 등으로 DB 파일을 활용할 수 있습니다. TablePlus는 해당 파일에 직접 연결하여 관리할 수 있습니다.

1. TablePlus 실행 및 새 연결 생성:
   • TablePlus 실행.
   • "+" 아이콘 클릭 또는 File -> New -> Connection... 선택.
   • DB 타입으로 SQLite 선택.
2. 접속 정보 입력:
   • Name: 예) ServBay SQLite Project
   • Database File: 폴더 아이콘 클릭 후, 해당 .sqlite, .db, .sqlite3 등 확장자의 DB 파일을 선택. 프로젝트 내, 또는 ServBay 추천 디렉토리(/Applications/ServBay/db/sqlite)에 파일을 두는 것을 권장합니다.
3. 연결 테스트 및 저장:
   • Test 클릭(파일이 존재하고 읽기 가능해야 함).
   • Connect 또는 Save 클릭.

Redis 연결

Redis는 빠른 성능을 자랑하는 키-값 저장소입니다. ServBay로 Redis 서비스 설치·실행이 가능합니다.

1. TablePlus 실행 및 새 연결 생성:
   • TablePlus 실행.
   • "+" 아이콘 클릭 또는 File -> New -> Connection... 선택.
   • DB 타입으로 Redis 선택.
2. 접속 정보 입력:
   • Name: 예) ServBay Redis
   • Host: 127.0.0.1
   • Port: 6379 (기본 포트)
   • Password: ServBay의 Redis에 비밀번호를 설정했다면 입력. 기본적으론 비밀번호가 없으므로 비워도 무방.
3. 연결 테스트 및 저장:
   • Test 클릭 후 연결 확인.
   • Connect 또는 Save 클릭.

MongoDB 연결

ServBay는 MongoDB 데이터베이스도 지원·구동합니다.

1. TablePlus 실행 및 새 연결 생성:
   • TablePlus 실행.
   • "+" 아이콘 클릭 또는 File -> New -> Connection... 진입.
   • DB 타입으로 MongoDB 선택.
2. 접속 정보 입력:
   • Name: 예) ServBay MongoDB
   • Host: 127.0.0.1
   • Port: 27017 (기본 포트)
   • User: MongoDB에서 인증을 활성화한 경우 사용자명 입력. ServBay 기본설정은 인증이 비활성일 수 있어 이때는 비워도 됨.
   • Password: 인증을 사용할 경우 비밀번호 입력.
   • Authentication Database: 인증 사용 시 필요하다면 admin 등 인증 DB 지정.
   • Database: 비워두거나, 원하는 DB명 입력 가능.
3. 연결 테스트 및 저장:
   • Test 클릭 후 확인.
   • Connect 또는 Save 클릭.

TablePlus로 관계형 데이터베이스(MariaDB/MySQL, PostgreSQL, SQLite) 관리

연결 성공 이후에는 TablePlus가 일관된 UI로 MariaDB/MySQL, PostgreSQL, SQLite 등 관계형 DB 관리를 지원합니다.

1. 데이터베이스 생성

• DB 서버(또는 SQLite의 경우 파일)에 연결 후, 좌측 사이드바를 확인.
• MariaDB/MySQL, PostgreSQL의 경우 좌측 Databases 탭 클릭.
• 좌상단 "+"(새로 만들기) 클릭이나 빈 공간 우클릭 후 New Database... 선택.
• DB명 입력, 필요에 따라 문자셋 및 정렬 방식 선택.
• Save 클릭.

2. 테이블 생성

• 좌측 사이드바에서 테이블을 등록할 DB 선택.
• 좌측 Tables 탭 클릭.
• 좌상단 "+"(새로 만들기) 클릭 또는 빈 공간 우클릭 후 New Table... 선택.
• 테이블명 입력.
• 하단 영역에서 필드를 정의:
  • "+" 클릭 시 컬럼 추가.
  • 컬럼명 입력.
  • 데이터 타입 선택.
  • 길이/값 입력(필요한 유형만).
  • PK(기본키), NN(NOT NULL), UQ(고유 인덱스), AI(자동 증가) 등 선택.
  • 기본값, 주석 등 추가 설정 가능.
• 모든 필드 정의 후, 좌상단 Save(혹은 Cmd + S)로 테이블 구조 저장.

3. 데이터 추가

• 작업할 테이블이 포함된 DB를 좌측에서 선택.
• Tables 탭에서 테이블 선택.
• 표 데이터 화면에서 하단 + Row 버튼 클릭.
• 새 행이 생성되면 각 셀을 더블클릭해 데이터 입력.
• 입력 후 Save(또는 Cmd + S) 클릭.

4. 데이터 조회

• DB, 테이블을 좌측에서 선택.
• 표 데이터 화면에서 스크롤하며 데이터 탐색.
• 상단 필터 창(검색) 사용해 데이터 신속 조회.
• 복잡한 쿼리의 경우 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 선택.
• 확인 창에 데이터베이스명 입력 후 Delete 클릭.
• SQLite: DB 삭제는 해당 .sqlite 파일을 Finder 등 파일 시스템에서 직접 제거해야 함.

TablePlus로 NoSQL 데이터베이스(Redis, MongoDB) 관리

TablePlus는 Redis, MongoDB에 특화된 관리 UI를 제공하며 관계형 DB와는 조작 방식이 다릅니다.

Redis 데이터 관리

Redis 인스턴스 연결 후:

• 좌측에 Redis 데이터베이스 목록(DB0, DB1, ...)이 표시됨. 일반적으로 DB0 사용.
• DB 선택 시, 우측에 모든 키(키 목록)가 표시됨.
• 키 조회: 리스트에서 키 확인, 상단 필터로 검색. 키를 클릭하면 타입과 값 표시. String, Hash, List, Set, Sorted Set 등 데이터 타입별로 알맞은 포맷으로 값 확인.
• 키 추가: 하단 + 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로 DB에 접속하기 전, ServBay 앱이 실행 중이며 연결하려는 DB 서비스(MariaDB, PostgreSQL, Redis, MongoDB 등)가 패키지(Packages) 탭에서 '실행 중' 상태인지 확인하세요.
• 방화벽: macOS 방화벽 또는 외부 보안 프로그램이 TablePlus의 로컬 DB 포트(3306, 5432, 6379, 27017) 접근을 막지 않았는지 확인하세요.
• DB 계정정보 확인: DB의 기본 사용자명·비밀번호는 ServBay 앱 데이터베이스(Databases) 탭에서 확인할 수 있습니다. 해당 정보를 안전하게 보관하세요.
• 기본 비밀번호 변경: 보안 강화를 위해 ServBay에서 DB의 root 또는 기본 계정 비밀번호를 변경하는 것이 좋습니다. ServBay 데이터베이스(Databases) 탭에서 비밀번호 초기화 기능을 제공하며, 변경 시 TablePlus 설정도 함께 갱신해야 합니다.
• Socket vs. Port 접속: Socket 연결은 파일 시스템을 통한 프로세스 간 통신 방식으로, 동일 기기에서의 접근과 성능이 좋으며, 네트워크 환경에 영향받지 않습니다. Port(TCP/IP) 연결은 네트워크 통신용으로 127.0.0.1로 로컬 접속하거나, 외부 DB 서버에 연결할 때 사용합니다. ServBay 로컬 환경에선 두 방식 모두 활용 가능합니다.
• 다른 툴도 사용 가능한가요? 당연히 가능합니다! TablePlus 외에도 DBeaver, DataGrip, Sequel Ace(MySQL/MariaDB), pgAdmin(PostgreSQL), MongoDB Compass(MongoDB) 등 인기 DB 관리 툴들이 많이 있습니다. 본문내용과 동일하게 ServBay에서 올바른 DB 접속 정보를 입력하면 사용할 수 있습니다.

마치며

이 문서를 참고하시면 macOS에서 TablePlus를 사용해 ServBay 로컬 개발 환경에 내장된 다양한 데이터베이스에 손쉽게 연결하고 효과적으로 관리할 수 있습니다. TablePlus의 강력하고 직관적인 기능, 그리고 ServBay의 통합적 로컬 환경이 조합되어 개발 생산성이 크게 높아질 것입니다. 성공적인 연결을 위해서는 ServBay 앱에서 정확한 데이터베이스 접속 정보를 확인하는 것이 핵심임을 꼭 기억하세요. 즐거운 개발 되세요!