DBeaver를 활용한 ServBay 데이터베이스 관리 방법

ServBay는 개발자들에게 다양한 데이터베이스 서비스를 제공하는 올인원 로컬 웹 개발 환경입니다. ServBay는 phpMyAdmin(MySQL/MariaDB용), pgAdmin(PostgreSQL용), Redis Commander(Redis용) 등 웹 기반 데이터베이스 관리 도구를 기본 제공하지만, 많은 개발자들은 보다 강력하고 통합된 UI를 갖춘 데스크톱 클라이언트로 데이터베이스를 관리하기를 선호합니다. DBeaver는 이러한 요구에 부합하는 인기 있는 크로스플랫폼 데이터베이스 관리 도구입니다.

이 문서는 DBeaver를 사용해 ServBay에 내장된 MariaDB/MySQL, PostgreSQL, SQLite, Redis 데이터베이스를 연결·관리하는 방법을 소개합니다.

DBeaver란 무엇인가?

DBeaver는 개발자, SQL 프로그래머, 데이터베이스 관리자 및 분석가를 대상으로 한 무료 오픈소스 범용 데이터베이스 관리 도구입니다. 거의 모든 주요 데이터베이스 시스템(관계형: MySQL, PostgreSQL, Oracle, SQL Server, SQLite 등과 NoSQL: MongoDB, Redis, Cassandra 등)을 지원합니다.

DBeaver의 주요 특징:

• 폭넓은 데이터베이스 지원: 다양한 종류의 데이터베이스를 통합 UI로 관리 가능
• 사용자 친화적 인터페이스: 직관적 그래픽 UI 제공으로 복잡한 데이터베이스 작업을 쉽게 처리
• 강력한 기능: SQL 에디터, 데이터 에디터, 메타데이터 브라우저, ERD 생성, 데이터 가져오기/내보내기 등 다수의 고급 기능 탑재
• 크로스플랫폼: Windows, macOS, Linux 운영체제 지원
• 활발한 커뮤니티와 지속적인 업데이트: 도구의 안정성과 기능 확장 보장

ServBay 사용자라면, DBeaver와 함께 사용하면 여러 종류의 데이터베이스를 전문적이고 통합적으로 관리할 수 있으며, 복잡한 쿼리나 고급 작업이 필요할 때 특히 유용합니다.

DBeaver로 ServBay 내장 MariaDB/MySQL 데이터베이스 관리하기

ServBay는 MariaDB를 기본 내장하며, MariaDB는 MySQL과 매우 높은 호환성을 제공합니다. 아래는 DBeaver로 ServBay의 MariaDB/MySQL에 연결하고 관리하는 방법입니다.

준비 사항

• ServBay가 설치 및 실행 중일 것
• MariaDB/MySQL 패키지가 ServBay에서 시작되어 있을 것
• DBeaver 클라이언트가 다운로드 및 설치되어 있을 것 (DBeaver 공식 웹사이트 참고)

MariaDB/MySQL 연결 방법

1. DBeaver 실행
2. 좌측 상단 "새 데이터베이스 연결" 버튼(플러그 아이콘)을 클릭
3. 데이터베이스 유형 목록에서 "MariaDB" 또는 **"MySQL"**을 검색 후 선택, "다음" 클릭
4. 아래 정보를 입력:
   • 호스트(Host): 127.0.0.1 또는 localhost
   • 포트(Port): 3306
   • 사용자명(Username): 기본값 root
   • 비밀번호(Password): ServBay 앱의 데이터베이스 탭에서 MariaDB/MySQL root 비밀번호 확인 가능
   • 데이터베이스(Database): 비워둔 후 연결 후 선택 또는 생성
   • 연결 방식(선택): TCP/IP(호스트+포트) 대신 소켓 연결도 가능. **드라이버 속성(Driver properties)**에서 connectUsing을 socket으로 설정 후, socket 속성에 ServBay MariaDB/MySQL 소켓 파일 경로 입력(기본값: /Applications/ServBay/tmp/mysql.sock). 소켓 연결 시 호스트와 포트 입력은 필요 없음.
5. "연결 테스트" 버튼 클릭해 연결 정보가 올바른지 확인. 실패하면 ServBay에서 MariaDB 서비스가 실행 중인지, 사용자명 및 비밀번호가 정확한지 확인. 비밀번호 분실 시 ServBay 데이터베이스 탭에서 MariaDB/MySQL root 비밀번호 초기화 가능.
6. 연결 성공하면 "완료" 클릭하여 저장

기본 데이터베이스 작업

연결 완료 후 DBeaver 데이터베이스 내비게이터에서 ServBay MariaDB/MySQL 인스턴스를 볼 수 있습니다. 주요 작업:

• 데이터베이스 생성: 연결명을 우클릭 → "SQL 에디터" → "새 SQL 스크립트" 선택 후, CREATE DATABASE mydatabase_servbay; 입력(mydatabase_servbay 부분에 원하는 DB명 입력) 후 실행(녹색 삼각형 아이콘 클릭)
• SQL 에디터로 데이터 조회: 연결명이나 특정 DB/테이블 우클릭 → "SQL 에디터" → "새 SQL 스크립트" → 쿼리문(SELECT * FROM your_table_name; 등) 입력 후 실행
• 데이터 탐색 및 수정: DB와 테이블을 펼친 후, 테이블명을 더블클릭하면 데이터 조회/수정 탭이 열림
• 테이블 생성/수정/삭제: DB 하단 "테이블" 노드 우클릭 → "새 테이블 생성" 또는 기존 테이블 우클릭해 수정/삭제
• 데이터 가져오기/내보내기: 여러 형식의 데이터 import/export 지원, 데이터 마이그레이션에 용이

이런 작업은 DBeaver의 그래픽 UI 또는 내장 SQL 에디터를 통해 손쉽게 수행할 수 있습니다.

DBeaver로 ServBay 내장 PostgreSQL 데이터베이스 관리하기

ServBay는 PostgreSQL 데이터베이스도 기본 지원합니다. 아래는 DBeaver로 ServBay PostgreSQL에 연결 및 관리하는 단계입니다.

준비 사항

• ServBay 설치 및 실행 중
• PostgreSQL 패키지 ServBay에서 시작되어 있을 것
• DBeaver 클라이언트 설치됨

PostgreSQL 연결 방법

1. DBeaver 실행
2. 좌측 상단 "새 데이터베이스 연결" 버튼 클릭
3. 데이터베이스 목록에서 "PostgreSQL" 검색 후 선택, "다음" 클릭
4. 아래 정보를 입력:
   • 호스트(Host): 127.0.0.1 또는 localhost
   • 포트(Port): 5432 (PostgreSQL 기본값)
   • 데이터베이스(Database): 기본값은 postgres, ServBay에 생성한 다른 DB에도 연결 가능
   • 사용자명(Username): 기본값 servbay
   • 비밀번호(Password): ServBay 앱 데이터베이스 탭에서 PostgreSQL 비밀번호 확인
   • 연결 방식(선택): MariaDB/MySQL과 마찬가지로 소켓 연결 가능. **드라이버 속성(Driver properties)**에서 socketFactory 또는 유사 속성에 소켓 파일 경로 입력(기본값: /Applications/ServBay/tmp/.s.PGSQL.5432, 연결 오류 시 /Applications/ServBay/tmp로 변경). 구체적인 설정 위치는 DBeaver 버전에 따라 다를 수 있으며, 보통 연결 속성의 고급설정에서 찾을 수 있습니다. 소켓 연결 시 호스트와 포트 입력 필요 없음.
5. "연결 테스트" 버튼 클릭. 실패 시 ServBay PostgreSQL 서비스 실행 여부, 사용자명/비밀번호 확인, 비밀번호 분실 시 ServBay 데이터베이스 탭에서 PostgreSQL 비밀번호 초기화
6. 연결 성공하면 "완료" 클릭하여 저장

기본 데이터베이스 작업

PostgreSQL에 연결 후 DBeaver 내비게이터에서 ServBay의 PostgreSQL 인스턴스를 확인할 수 있습니다. 데이터베이스 생성, 테이블 생성, 쿼리, 데이터 수정, import/export 등 기본적인 관계형 데이터베이스 작업은 MariaDB/MySQL 관리 단계와 거의 동일하게 처리할 수 있습니다.

DBeaver로 ServBay 내장 SQLite 3 데이터베이스 관리하기

ServBay는 SQLite 3 데이터베이스도 지원하며, SQLite는 파일 기반의 경량 데이터베이스 엔진으로 별도의 서버 프로세스가 필요 없습니다.

준비 사항

• ServBay 설치 및 실행 중
• DBeaver 클라이언트 설치됨
• .db, .sqlite, .sqlite3 파일 등 SQLite 데이터베이스 파일 필요(DBeaver에서 신규 연결 시 자동 생성도 가능)

SQLite 연결 방법

1. DBeaver 실행
2. 좌측 상단 "새 데이터베이스 연결" 버튼 클릭
3. 데이터베이스 타입에서 "SQLite" 검색 후 선택, "다음" 클릭
4. 아래 정보를 입력:
   • 데이터베이스 파일 경로(Database File): 오른쪽 폴더 아이콘을 클릭해 SQLite DB 파일의 전체 경로 입력/선택. ServBay에서는 /Applications/ServBay/db/sqlite/ 폴더에 파일 저장을 권장(관리와 백업에 용이)
   • 아직 파일이 없다면, 원하는 경로와 파일명을 입력하면 DBeaver가 연결 시 자동으로 생성함
5. "연결 테스트" 클릭. 파일 경로가 올바르면 정상 연결
6. 연결 성공 시 "완료" 클릭하여 저장

기본 데이터베이스 작업 (SQLite)

SQLite 파일 연결 후 다른 DB와 동일하게 DBeaver에서 관리 가능하며, 기능은 SQLite의 특성상 비교적 단순합니다.

• 테이블 생성: 연결명 우클릭 → "새 테이블 생성"
• SQL 에디터 사용: 연결명 우클릭 → "SQL 에디터" → **"새 SQL 스크립트"**에서 SQL 입력·실행
• 데이터 조회 및 수정: 테이블명 더블클릭
• 테이블 삭제: 테이블명 우클릭 후 "삭제"
• 데이터베이스 삭제: SQLite는 파일 단위이므로 파일 시스템에서 .db 파일을 삭제하면 데이터베이스가 제거됨

DBeaver로 ServBay 내장 Redis 데이터베이스 관리하기

Redis는 데이터베이스, 캐시, 메시지 브로커로 활용되는 오픈소스 인메모리 데이터 구조 저장소입니다. ServBay에서도 Redis를 기본 제공합니다.

준비 사항

• ServBay 설치 및 실행 중
• Redis 패키지가 ServBay에서 시작되어 있을 것
• DBeaver 클라이언트 설치됨

Redis 연결 방법

1. DBeaver 실행
2. 좌측 상단 "새 데이터베이스 연결" 버튼 클릭
3. 데이터베이스 목록에서 "Redis" 검색 후 선택, "다음" 클릭
4. 아래 정보 입력:
   • 호스트(Host): 127.0.0.1 또는 localhost
   • 포트(Port): 6379 (Redis 기본값)
   • 비밀번호(Password): ServBay 기본 설치 Redis는 비밀번호가 설정되어 있지 않아 보통 빈칸. 비밀번호 설정 시 해당 값 입력
5. "연결 테스트" 클릭. 실패 시 ServBay Redis 서비스 실행 및 포트/비밀번호 확인
6. 연결 성공 시 "완료" 클릭하여 저장

기본 데이터 관리 (Redis)

Redis 연결 후 DBeaver UI에서 키-값 데이터를 쉽게 탐색·관리 가능:

• 키 조회: 내비게이터에서 데이터베이스(DB 0 등) 노드를 펼치면 키 목록 확인 가능
• 키 추가: 데이터베이스 노드 또는 키 목록 빈 공간 우클릭 → "새 키 생성", 키명·타입(String, List, Set, Hash, ZSet 등)·값 입력
• 키 수정: 기존 키 더블클릭 또는 우클릭 → **"키 수정"**에서 값 또는 TTL(Time To Live) 변경
• 키 삭제: 키명 우클릭 → "키 삭제"
• Redis 콘솔 사용: 연결명 또는 DB 우클릭 → "SQL 에디터" → **"새 Redis 콘솔"**에서 직접 명령 입력 및 실행 가능

자주 묻는 질문 및 문제 해결 (FAQ)

• 연결 실패 혹은 'Connection Refused' 오류:
  • ServBay 애플리케이션 실행 여부 확인
  • 연결하려는 DB서비스(MariaDB/MySQL, PostgreSQL, Redis)가 ServBay에서 실행 중(녹색 표시)인지 확인
  • 연결 정보의 호스트, 포트가 올바른지 점검(로컬 연결은 보통 127.0.0.1 + MariaDB/MySQL: 3306, PostgreSQL: 5432, Redis: 6379)
  • 소켓 연결 시 해당 소켓 파일 경로, DB서비스 설정 확인
  • 방화벽 설정으로 DBeaver와 로컬 포트 통신이 차단되지 않았는지 점검
• 연결 성공 후 인증 오류(Authentication Failed):
  • 사용자명·비밀번호 정확히 입력, ServBay 데이터베이스 탭에서 root/기본 사용자 비밀번호 확인 또는 재설정
• SQLite 연결 시 파일 경로 오류:
  • 입력 경로가 전체 경로이며 정확한지 확인
  • DBeaver가 파일 경로에 읽기/쓰기 권한이 있는지 점검
• DBeaver UI 표시 이상/깨짐:
  • DBeaver 재시작 시도
  • DBeaver가 사용하는 Java 환경에 문제 없는지 확인

요약

DBeaver는 ServBay 로컬 개발 환경과 결합해 다양한 데이터베이스 관리 효율을 획기적으로 높여주는 범용 DB관리 도구입니다. 본 안내를 따라 DBeaver로 ServBay 내장 MariaDB/MySQL, PostgreSQL, SQLite, Redis 데이터베이스에 손쉽게 연결하고, 실제 개발 및 관리 업무(데이터 조회/수정, SQL 쿼리, 고급 DB 유지관리 등)를 효과적으로 수행할 수 있습니다. ServBay의 편리한 환경 관리 기능과 DBeaver의 강력함을 활용하면, 로컬 개발 워크플로우가 더 매끄럽고 전문적으로 변화할 것입니다.