MySQL이나 MariaDB 서버에 접속해 쿼리를 실행하고 테이블 구조를 확인하려면 전용 클라이언트 툴이 필요합니다. DBeaver는 오픈소스 기반의 무료 데이터베이스 관리 도구로, 직관적인 UI와 다중 DBMS 지원으로 개발 현장에서 널리 사용됩니다. 이 글에서는 DBeaver Community Edition 설치부터 MySQL/MariaDB 연결까지 실무 중심으로 정리합니다.
# 함께 보면 좋은 글
 |
| DBeaver무료DB툴설치및MySQLMariaDB연결완벽가이드 |
1. DBeaver Community Edition 다운로드 및 설치
DBeaver는 Eclipse 기반으로 개발되었으며, Windows/macOS/Linux 모두 지원합니다. 설치 과정은 다음과 같습니다.
- 공식 사이트 접속:
https://dbeaver.io/download/에서 Community Edition 다운로드 - 운영체제 선택: Windows는 .exe 인스톨러, macOS는 .dmg, Linux는 .deb 또는 .rpm 패키지 선택
- 설치 실행: 기본 옵션으로 진행하되, JRE(Java Runtime Environment)가 번들로 포함된 버전을 권장합니다. 별도 Java 설치가 필요 없어 의존성 문제를 방지할 수 있습니다.
- 초기 실행: 설치 완료 후 실행하면 Workspace 경로 지정 화면이 나타납니다. 기본 경로를 그대로 사용해도 무방합니다.
주의사항: Enterprise Edition은 NoSQL 및 클라우드 DB 지원이 추가되지만, MySQL/MariaDB 용도로는 Community Edition으로 충분합니다. 라이선스 비용을 지불할 필요가 없습니다.
2. MySQL/MariaDB 드라이버 설정
DBeaver는 JDBC 드라이버를 통해 데이터베이스에 연결합니다. 최초 연결 시 드라이버를 자동으로 다운로드하지만, 사전 확인이 필요합니다.
- 새 연결 생성: 상단 메뉴에서
Database → New Database Connection클릭 - DBMS 선택: 목록에서
MySQL또는MariaDB아이콘 클릭 (MariaDB는 MySQL 프로토콜과 호환되므로 MySQL 드라이버 사용 가능) - 드라이버 다운로드: 처음 연결 시 "Download driver files" 팝업이 표시되면
Download버튼 클릭. 인터넷 연결이 필요하며, 약 1~2MB 용량입니다. - 드라이버 버전: 기본 선택된 최신 버전을 사용하되, 레거시 MySQL 5.x 서버에 연결할 경우 드라이버 버전을 5.1.x로 낮춰야 인증 오류를 피할 수 있습니다.
팁: 회사 내부망에서 외부 다운로드가 차단된 경우, Database → Driver Manager에서 수동으로 JDBC jar 파일을 등록할 수 있습니다.
3. 연결 정보 입력 및 테스트
드라이버 설정이 완료되면 실제 데이터베이스 서버 정보를 입력합니다.
- Server Host: DB 서버 IP 또는 도메인 (로컬 개발 환경이면
localhost또는127.0.0.1) - Port: MySQL 기본 포트는
3306, MariaDB도 동일. 커스텀 포트 사용 시 정확히 입력 - Database: 접속할 스키마명. 비워두면 서버 내 모든 데이터베이스 목록이 표시되지만, 권한이 제한된 계정은 특정 DB만 입력해야 합니다.
- Username / Password: DB 계정 정보 입력.
root계정 사용은 개발 환경에서만 허용하고, 운영 환경에서는 읽기 전용 계정을 별도로 생성할 것을 권장합니다. - Test Connection: 하단의
Test Connection버튼을 클릭해 연결 가능 여부를 사전 검증합니다. "Connected" 메시지가 표시되면 정상입니다.
Troubleshooting: "Public Key Retrieval is not allowed" 오류가 발생하면, 연결 설정 하단의 Driver properties 탭에서 allowPublicKeyRetrieval=true 속성을 추가하십시오. MySQL 8.0 이상에서 발생하는 인증 방식 변경 때문입니다.
4. 연결 완료 후 기본 사용법
연결에 성공하면 좌측 Database Navigator에 서버가 트리 구조로 표시됩니다.
- 테이블 조회: 스키마 → Tables 폴더를 확장하면 테이블 목록이 나타나며, 더블클릭 시 데이터 그리드가 열립니다.
- SQL 편집기: 테이블 우클릭 →
SQL Editor → Open SQL Script로 쿼리 작성 창을 엽니다.Ctrl+Enter(Windows) 또는Cmd+Enter(macOS)로 쿼리를 실행합니다. - ER 다이어그램: 스키마 우클릭 →
View Diagram으로 테이블 간 관계를 시각화할 수 있습니다. 복잡한 스키마 분석 시 유용합니다. - 데이터 Export: 테이블 우클릭 →
Export Data로 CSV, JSON, SQL 등 다양한 형식으로 내보내기 가능합니다.
성능 팁: 대용량 테이블 조회 시 DBeaver는 기본적으로 200행만 fetch합니다. Preferences → Editors → Data Editor → Data Fetch에서 Fetch Size를 조정할 수 있지만, 메모리 사용량을 고려해 1000행 이하로 제한하는 것을 권장합니다.
정리 및 Action Item
DBeaver Community Edition은 무료이면서도 MySQL/MariaDB 연결과 쿼리 실행에 필요한 모든 기능을 제공합니다. 드라이버 자동 다운로드와 직관적인 UI 덕분에 초기 설정 시간을 최소화할 수 있으며, ER 다이어그램과 데이터 Export 기능은 실무에서 즉시 활용 가능합니다. 당장 실행할 것: 로컬 MySQL/MariaDB 서버를 구축했다면, DBeaver를 설치하고 Test Connection까지 완료해 쿼리 실행 환경을 구성하십시오. CLI 기반 mysql 클라이언트보다 생산성이 월등히 높습니다.
# 함께 보면 좋은 글
댓글
댓글 쓰기