DBeaver를 활용한 ServBay 데이터베이스 관리 가이드

ServBay는 개발자를 위한 다양한 데이터베이스 서비스를 지원하는 올인원 로컬 웹 개발 환경입니다. ServBay에는 phpMyAdmin(주로 MySQL/MariaDB용), pgAdmin(PostgreSQL용), Redis Commander(Redis용)와 같은 웹 기반 데이터베이스 관리 도구가 내장되어 있습니다. 그러나 많은 개발자들은 보다 강력하고 통합된 인터페이스의 데스크탑 클라이언트를 선호합니다. DBeaver는 이러한 요구를 충족시키는 인기의 크로스 플랫폼 데이터베이스 관리 툴입니다.

본 문서는 DBeaver를 활용해 ServBay에 포함된 MariaDB/MySQL, PostgreSQL, SQLite, Redis 등 다양한 데이터베이스에 연결하고 관리하는 방법을 안내합니다.

DBeaver란 무엇인가요?

DBeaver는 개발자, SQL 프로그래머, 데이터베이스 관리자, 데이터 분석가를 위해 설계된 무료 오픈소스 범용 데이터베이스 툴입니다. MySQL, PostgreSQL, Oracle, SQL Server, SQLite 등 주요 관계형 데이터베이스와 MongoDB, Redis, Cassandra 등 주요 NoSQL 데이터베이스를 모두 지원합니다.

DBeaver의 주요 특징은 다음과 같습니다:

• 광범위한 데이터베이스 지원: 하나의 통합 인터페이스로 다양한 데이터베이스를 관리할 수 있습니다.
• 사용자 친화적 인터페이스: 직관적인 그래픽 UI로 복잡한 DB 작업을 쉽게 처리할 수 있습니다.
• 강력한 기능: SQL 에디터, 데이터 편집기, 메타데이터 브라우저, ERD(ER 다이어그램) 생성, 데이터 가져오기/내보내기 등 고급 기능 제공.
• 크로스 플랫폼 지원: Windows, macOS, Linux 운영체제에서 모두 사용 가능.
• 활발한 커뮤니티 & 지속적인 업데이트: 도구의 안정성과 확장성을 보장합니다.

ServBay 사용자라면 DBeaver를 병행 사용함으로써, 여러 종류의 데이터베이스를 동시에 관리하거나 복잡한 쿼리 및 작업이 필요할 때 더욱 전문적이고 통합적인 데이터베이스 관리 경험을 얻을 수 있습니다.

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

ServBay는 기본적으로 MariaDB를 통합하며, 이는 MySQL과 높은 호환성을 가집니다. 아래는 DBeaver를 사용해 ServBay 내 MariaDB/MySQL 데이터베이스에 연결하고 관리하는 방법입니다.

준비사항

• ServBay가 설치 및 실행 중일 것.
• ServBay 내에서 MariaDB/MySQL 패키지가 실행 중일 것.
• DBeaver 클라이언트가 다운로드 및 설치되어 있을 것. 최신 버전은 DBeaver 공식 웹사이트에서 확인하세요.

MariaDB/MySQL 연결 방법

1. DBeaver 실행.
2. 좌측 상단의 "새 데이터베이스 연결" 버튼(플러그 모양 아이콘)을 클릭합니다.
3. 데이터베이스 목록에서 "MariaDB" 또는 **"MySQL"**을 검색해 선택한 후 **"다음"**을 클릭합니다.
4. 연결 정보를 입력합니다:
   • 호스트: 127.0.0.1(또는 localhost)
   • 포트: 3306
   • 사용자명: 기본값은 root
   • 비밀번호: ServBay 앱의 데이터베이스 탭에서 MariaDB/MySQL root 사용자 비밀번호를 확인할 수 있습니다.
   • 데이터베이스: 일단 비워둔 채로 연결 후, 원하는 데이터베이스를 선택하거나 새로 만드세요.
   • 연결 방식(선택사항): 기본 TCP/IP(호스트+포트) 연결 외에도, 로컬에서는 보다 효율적인 소켓 연결 방식을 지원합니다. **드라이버 속성(Driver properties)**에서 connectUsing을 socket으로, 이어서 socket 경로를 /Applications/ServBay/tmp/mysql.sock(기본값)으로 설정하세요. 소켓 연결 시, 호스트/포트 입력이 필요하지 않습니다.
5. "연결 테스트" 버튼을 눌러 정보가 올바른지 확인하세요. 실패 시, ServBay의 MariaDB 서비스 실행 여부 및 아이디/비번을 다시 체크하세요. 비밀번호를 잊었다면 ServBay 데이터베이스 탭에서 재설정할 수 있습니다.
6. 연결 테스트가 성공하면 **"완료"**를 눌러 저장합니다.

기본 DB 작업

연결 후, DBeaver의 데이터베이스 네비게이터에서 ServBay의 MariaDB/MySQL 인스턴스를 확인할 수 있습니다. 주요 작업은 다음과 같습니다:

• 데이터베이스 생성: 연결명 우클릭 → "SQL 에디터" → "새 SQL 스크립트" 선택.
  CREATE DATABASE mydatabase_servbay; (여기서 mydatabase_servbay는 원하는 DB명으로 변경) 입력 후, 실행(초록색 삼각형 버튼) 클릭.
• SQL 에디터로 데이터 조회: 연결 또는 DB/테이블 우클릭 → "SQL 에디터" → "새 SQL 스크립트" → 쿼리 입력(SELECT * FROM your_table_name; 등) 후 실행.
• 데이터 탐색·수정: 네비게이터에서 데이터베이스와 테이블 확장 후, 테이블명 더블 클릭하여 데이터를 직관적 UI에서 조회/수정 가능.
• 테이블 생성·수정·삭제: 데이터베이스 하위의 "테이블" 우클릭 → "새 테이블 생성" 또는 기존 테이블 우클릭 후 수정/삭제.
• 데이터 가져오기/내보내기: 다양한 포맷의 데이터 import/export 지원.

이 밖의 대부분의 DB 작업은 DBeaver의 그래픽 인터페이스 또는 내장 SQL 에디터를 통해, 타 데이터베이스와 같은 방식으로 수행할 수 있습니다.

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

ServBay에는 PostgreSQL DB도 통합되어 있습니다. DBeaver로 ServBay PostgreSQL에 연결하는 방법은 아래와 같습니다.

준비사항

• ServBay가 설치 및 실행 중일 것.
• ServBay에서 PostgreSQL 패키지가 실행 중일 것.
• DBeaver가 설치되어 있을 것.

PostgreSQL 연결 방법

1. DBeaver 실행.
2. 좌측 상단의 "새 데이터베이스 연결" 클릭.
3. 데이터베이스 목록에서 "PostgreSQL" 선택 후 "다음" 클릭.
4. 연결 정보 입력:
   • 호스트: 127.0.0.1(또는 localhost)
   • 포트: 5432(PostgreSQL 기본 포트)
   • 데이터베이스: 기본값은 postgres(다른 DB도 가능).
   • 사용자명: 기본값은 servbay.
   • 비밀번호: ServBay 앱 데이터베이스 탭에서 PostgreSQL 사용자 비밀번호 확인 가능.
   • 연결 방식(선택사항): MariaDB/MySQL과 마찬가지로 소켓 연결도 지원됩니다. **드라이버 속성(Driver properties)**에서 socketFactory 혹은 유사 항목에 /Applications/ServBay/tmp/.s.PGSQL.5432(혹은 실패 시 /Applications/ServBay/tmp) 입력. DBeaver 버전에 따라 위치가 다르니 고급 설정에서 확인하세요. 소켓 연결 시, 호스트/포트 입력은 불필요합니다.
5. "연결 테스트" 클릭. 실패 시 PostgreSQL 서비스와 사용자 정보(비번 등)를 확인하세요. 비번을 잊었다면 ServBay 데이터베이스 탭에서 재설정 가능합니다.
6. 연결 테스트 성공 시 "완료" 클릭하여 저장.

기본 DB 작업

연결 후, DBeaver 네비게이터에서 ServBay의 PostgreSQL 인스턴스를 확인할 수 있습니다. 대다수의 기본 RDB(관계형 데이터베이스) 관리 작업(DB/테이블 생성, 쿼리, 데이터 편집, import/export 등)은 MariaDB/MySQL과 유사하며, SQL 에디터 및 그래픽 UI로 쉽게 실행 가능합니다.

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

ServBay는 SQLite 3 데이터베이스도 지원합니다. SQLite는 별도의 서버 프로세스 없이 파일 단위로 작동하는 경량 DB 엔진입니다.

준비사항

• ServBay 설치 및 실행 중.
• DBeaver 설치됨.
• 사용하고자 하는 SQLite 데이터베이스 파일(.db, .sqlite, .sqlite3 등)이 필요합니다. 없다면 DBeaver에서 새로 생성할 수 있습니다.

SQLite 연결 방법

1. DBeaver 실행.
2. 좌측 상단의 "새 데이터베이스 연결" 클릭.
3. 데이터베이스 목록에서 "SQLite" 선택 후 "다음" 클릭.
4. 연결 정보 입력:
   • 데이터베이스 파일 경로: 오른쪽 폴더 아이콘 클릭 후, SQLite 데이터 파일 전체 경로를 지정.
     ServBay에서는 /Applications/ServBay/db/sqlite/ 경로 사용을 추천(관리·백업에 유리).
   • 새 데이터베이스 파일을 만들려면 원하는 경로+파일명을 입력하면 DBeaver가 파일을 생성합니다.
5. "연결 테스트" 클릭. 경로에 접근 가능하면 정상 연결됩니다.
6. 테스트가 성공되면 **"완료"**로 저장.

SQLite 기본 작업

SQLite 파일에 연결한 뒤에도 다른 DB처럼 다양한 관리를 할 수 있습니다. 단, SQLite는 기능이 비교적 단순합니다.

• 테이블 생성: 연결명 우클릭 → "새 테이블 생성".
• SQL 에디터 사용: 연결명 우클릭 → "SQL 에디터" → "새 SQL 스크립트" → SQL 작성 및 실행.
• 데이터 보기·수정: 테이블명 더블 클릭.
• 테이블 삭제: 테이블명 우클릭 → "삭제".
• 데이터베이스 삭제: SQLite 데이터베이스는 파일이므로, 해당 .db 파일을 파일 시스템에서 삭제하면 됩니다.

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

Redis는 인메모리 데이터 구조 저장소(DB, 캐시, 메시지 브로커 용도)로, ServBay에 기본 포함되어 있습니다.

준비사항

• ServBay 설치 및 실행 중.
• Redis 패키지 실행 중.
• DBeaver 설치 완료.

Redis 연결 방법

1. DBeaver 실행.
2. 좌측 상단의 "새 데이터베이스 연결" 클릭.
3. 데이터베이스 목록에서 "Redis" 선택 후 "다음" 클릭.
4. 연결 정보 입력:
   • 호스트: 127.0.0.1(또는 localhost)
   • 포트: 6379(Redis 기본 포트)
   • 비밀번호: 기본적으로 ServBay의 Redis는 비밀번호 없이 설치됩니다. 설정된 비밀번호가 있다면 입력하세요.
5. "연결 테스트" 클릭. 실패 시 Redis 서비스 실행 및 포트·비밀번호 확인 필수.
6. 테스트 성공하면 **"완료"**로 저장.

Redis 데이터 관리 기본

Redis에 성공적으로 연결되면, DBeaver의 그래픽 UI에서 다양한 키-값 자료를 쉽게 관리할 수 있습니다.

• 키 조회: 네비게이터에서 연결을 확장해 데이터베이스(예: DB 0)를 선택하면 키 목록을 볼 수 있습니다.
• 키 추가: 데이터베이스 노드 또는 키 목록에서 빈 공간 우클릭 → "새 키 생성".
  키 이름, 타입(String, List, Set, Hash, ZSet 등), 값 입력 가능.
• 키 수정: 기존 키 더블 클릭 또는 우클릭 → "키 수정" (값/TTL 변경).
• 키 삭제: 키명 우클릭 → "키 삭제".
• Redis 콘솔 사용: 연결명 또는 데이터베이스 우클릭 → "SQL 에디터" → **"새 Redis 콘솔"**로 이동, Redis 명령어 직접 실행 가능.

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

• 연결 실패 및 'Connection Refused' 오류:
  • ServBay 앱이 실행 중인지 확인.
  • MariaDB/MySQL, PostgreSQL, Redis 등 연결 대상 DB 서비스가 ServBay에서 실행(초록 상태) 중인지 확인.
  • 호스트(127.0.0.1)와 포트(기본: MariaDB/MySQL: 3306, PostgreSQL: 5432, Redis: 6379) 번호가 맞는지 확인.
  • 소켓 연결 시 파일 경로가 정확하며, 서비스가 해당 소켓을 사용 중인지 확인.
  • 방화벽 설정으로 DBeaver의 로컬 네트워크 접근이 차단되지 않았는지 점검.
• 연결 성공하지만 인증 실패(비밀번호 오류) 발생:
  • 입력한 아이디/비밀번호가 올바른지 확인. ServBay 데이터베이스 탭에서 사용자 비번 확인 및 초기화 가능.
• SQLite 파일 경로 오류:
  • 입력한 경로가 완전하고 정확한지, DBeaver가 해당 경로에 읽기/쓰기 권한이 있는지 확인.
• DBeaver UI가 비정상/화면 일부 미출력:
  • DBeaver를 재실행 해보세요.
  • DBeaver가 필요로 하는 Java 환경에 문제가 없는지 확인하세요.

요약

DBeaver는 범용성, 강력한 기능, 사용자 친화적 UI를 갖춘 뛰어난 데이터베이스 관리 툴입니다. 이를 ServBay 로컬 개발 환경과 함께 사용하면 MariaDB/MySQL, PostgreSQL, SQLite, Redis 등 다양한 데이터베이스를 빠르고 효율적으로 관리할 수 있습니다. 본 가이드에 따라 DBeaver와 ServBay의 연동 방법을 익히면 데이터 탐색, 편집, SQL 쿼리 실행, 고급 유지보수 작업까지 모두 하나의 통합 인터페이스로 처리할 수 있습니다. ServBay가 제공하는 편리한 환경 관리와 DBeaver의 전문적인 DB 관리 기능을 결합해, 여러분의 로컬 개발 워크플로우를 한 단계 더 업그레이드 해보세요.