Beekeeper Studio는 PostgreSQL, MySQL, SQLite와 SQL Server 등을 한 화면에서 연결해 SQL을 실행하고 테이블을 탐색하는 데이터베이스 관리 프로그램입니다. 현재 공식 버전은 6.1.4이며 Windows 설치형과 포터블, macOS, Linux 파일을 제공합니다.
Community Edition은 무료 오픈 소스 버전으로 SQL 편집기, 연결과 탭, 테이블 탐색·필터·수정 같은 핵심 기능을 사용할 수 있습니다. 아래에서 파일 선택, 설치, 새 연결 테스트, 첫 SELECT 실행, 연결·인증서·SQLite 잠금 오류 해결까지 순서대로 확인할 수 있습니다.
Beekeeper Studio는 어떤 프로그램인가요?
Beekeeper Studio는 여러 데이터베이스 엔진에 접속하는 데스크톱 SQL 클라이언트입니다. 왼쪽에서 스키마와 테이블을 탐색하고 가운데 SQL 편집기에서 쿼리를 실행하며 아래 결과 표에서 행을 확인합니다.
자동 완성, 쿼리 기록, 테이블 데이터 편집, SSL과 SSH 터널을 지원합니다. Community Edition과 유료 기능은 같은 설치 파일을 사용하므로 무료 핵심 기능만 필요한 사용자도 별도 패키지를 찾을 필요가 없습니다.
Beekeeper Studio 연결·SQL 편집기·실행 결과 실제 화면
Beekeeper Studio 공식 사이트와 공식 문서에 공개된 실제 화면입니다. 데이터베이스 연결 정보, SQL 편집기, 테이블 목록과 실행 결과를 확인할 수 있습니다.
| Windows 설치형 | 243.2MB |
|---|---|
| Windows 포터블 | 242.8MB |
| 지원 OS | Windows 7 이상·macOS·Linux |
| 무료 연결 | PostgreSQL·MySQL·SQLite·SQL Server 등 |
| SQL 편집기 | 자동 완성·기록·트랜잭션 |
| 테이블 | 탐색·필터·편집 |
| 보안 | SSL·SSH 터널 |
| 유료 기능 | 일부 DB·AI·협업 기능 |
Beekeeper Studio 6.1.4 설치형과 포터블 선택
Windows용 공식 파일은 약 243.2MB 설치형과 약 242.8MB 포터블 실행 파일로 나뉩니다. 일반 PC에서는 바탕 화면과 시작 메뉴 등록, 자동 업데이트를 쓰기 편한 설치형을 선택하세요. 관리자 권한이 제한된 PC나 USB에서 실행하려면 포터블 파일이 알맞습니다.
macOS와 Linux 사용자는 공식 다운로드 화면에서 운영체제와 CPU 종류에 맞는 DMG, AppImage, DEB, RPM 등을 선택할 수 있습니다. 이 글의 버튼에는 Windows 64비트 설치형과 포터블을 구분해 두었습니다.
- Windows 설치형 또는 포터블을 선택하세요.
- 설치형은 Setup EXE를 실행하고 포터블은 EXE를 저장한 폴더에서 여세요.
- 새 연결 화면에서 데이터베이스 종류를 고르세요.
- 호스트·포트·사용자 정보를 입력하고 Test를 누르세요.
- Connect 후 SQL을 실행해 결과 표가 보이는지 확인하세요.
Community Edition 무료 사용 범위
Beekeeper Studio Community Edition은 GPLv3 기반 무료 오픈 소스 버전이며 연결, 쿼리와 탭을 제한 없이 만들고 SQL 작성·실행, 테이블 탐색·필터·수정, 스키마와 인덱스 작업을 할 수 있습니다.
공식 안내는 Community Edition을 학생, 개인, 비영리 단체와 직원 10명 미만 또는 연매출 100만 달러 미만의 소규모 조직에 맞춘 버전으로 설명합니다. 더 큰 조직이나 AI Shell, 일부 고급 데이터베이스·협업 기능이 필요하면 유료 플랜 조건을 확인하세요. 무료판과 유료판은 별도 설치 파일이 아니라 같은 앱에서 라이선스로 기능이 활성화됩니다.
Windows 설치형으로 설치
Beekeeper-Studio-Setup-6.1.4.exe를 실행하고 Windows의 게시자 확인 창에서 Beekeeper Studio 배포 파일인지 확인하세요. 설치 위치를 정한 뒤 완료하면 시작 메뉴에서 Beekeeper Studio를 실행합니다.
처음 실행했을 때 체험판 안내가 보이더라도 Community Edition으로 계속 사용할 수 있습니다. 데이터베이스 연결 비밀번호를 저장할 계획이라면 개인 계정으로 로그인한 Windows PC에서 사용하고 공용 PC에서는 Save Passwords를 끄세요.
포터블 버전 실행
Beekeeper-Studio-6.1.4-portable.exe는 설치 과정 없이 바로 실행하는 Windows 64비트 파일입니다. 쓰기 권한이 있는 고정 폴더에 저장한 뒤 실행하고, Windows 보안 창에는 파일 이름과 공식 GitHub 릴리스 주소를 확인하세요.
포터블이라고 해서 데이터베이스 접속 정보가 자동으로 USB에만 보관되는 것은 아닙니다. 연결과 설정 보관 위치는 앱 동작과 Windows 사용자 폴더의 영향을 받으므로 다른 사람의 PC에서는 암호 저장을 끄고 작업 후 저장한 연결을 삭제하세요.
PostgreSQL·MySQL·SQLite 연결 만들기
New Connection에서 PostgreSQL, MySQL, SQLite 등 Connection Type을 선택합니다. 서버형 데이터베이스는 Host, Port, User, Password와 Default Database를 입력하고, SQLite는 데이터베이스 파일을 선택하세요.
바로 Connect를 누르기 전에 Test로 인증과 네트워크 상태를 확인합니다. 성공하면 Connection Name을 적고 필요한 경우에만 Save Passwords를 선택한 뒤 Save와 Connect를 진행하세요. 업무 서버는 쓰기 권한이 없는 읽기 전용 계정을 먼저 사용하는 편이 안전합니다.
SQL 쿼리 실행과 결과 확인
연결되면 왼쪽 Entities에서 테이블과 뷰를 확인하고 새 Query 탭을 엽니다. 예를 들어 SELECT * FROM 테이블명 LIMIT 100;처럼 결과 수를 제한한 조회문을 입력한 뒤 Run을 누르세요.
여러 SQL이 있을 때는 전체 실행, 현재 쿼리 실행, 선택 영역 실행 중 알맞은 범위를 사용합니다. 결과는 편집기 아래 표에 나타나며 실행 시간과 영향받은 행 수를 함께 확인할 수 있습니다. 변경 쿼리는 대상 데이터베이스와 WHERE 조건을 다시 확인한 뒤 실행하세요.
테이블 탐색·필터와 데이터 수정
Entities에서 테이블을 열면 행을 표 형태로 탐색하고 열 기준으로 정렬하거나 필터를 적용할 수 있습니다. Structure 화면에서는 열, 데이터 형식, 인덱스와 관계를 확인합니다.
행을 고칠 때는 Edit Data를 켜고 수정 내용을 검토한 뒤 적용하세요. 운영 데이터베이스에서는 먼저 읽기 전용 연결로 구조를 확인하고, 수정 권한이 필요한 작업은 백업과 트랜잭션 계획을 세운 뒤 진행하는 것이 좋습니다.
SQL 자동 완성과 쿼리 기록 활용
FROM이나 JOIN 뒤에는 테이블 이름, 별칭 뒤 점을 입력하면 열 이름 자동 완성이 나타납니다. 자동 완성이 보이지 않을 때 Ctrl+Space로 직접 호출할 수 있습니다. 데이터베이스 엔진에 맞춰 큰따옴표, 백틱 또는 대괄호도 자동으로 선택됩니다.
편집기 도구 모음의 기록 아이콘을 누르면 현재 연결에서 실행한 쿼리를 다시 찾을 수 있습니다. 자주 쓰는 안전한 조회문은 이름을 붙여 저장하고, 데이터 변경문은 실행 전 데이터베이스 이름과 조건을 다시 확인하세요.
쿼리 결과 저장
SQL을 실행한 뒤 결과 표 오른쪽 아래 Download 메뉴에서 CSV, Excel, JSON, Markdown 또는 스프레드시트에 붙여 넣기 좋은 TSV 형식을 선택할 수 있습니다. 먼저 결과 행 수와 열을 확인한 다음 저장 위치와 파일 이름을 정하세요.
화면 결과는 메모리 보호를 위해 큰 결과 집합이 잘릴 수 있습니다. 수십만 행을 무조건 화면에 불러오기보다 WHERE와 LIMIT로 필요한 범위를 좁혀 확인하고, 대용량 전체 내보내기가 필요하면 사용 중인 에디션의 Run To File 지원 여부와 서버 부하를 함께 점검하세요.
연결 테스트가 실패할 때
Connection refused가 나오면 Host와 Port, 데이터베이스 서버 실행 상태, 방화벽과 VPN을 확인합니다. PostgreSQL 기본 포트는 보통 5432, MySQL은 3306이지만 서버 설정이 다르면 실제 포트를 입력해야 합니다.
Authentication failed가 나오면 사용자 이름과 암호, 대상 데이터베이스 권한을 확인하세요. localhost는 Beekeeper Studio를 실행하는 PC를 뜻하므로 원격 서버 주소 대신 넣으면 연결되지 않습니다. SSL이 필요한 서버는 Enable SSL을 켜고 서버 관리자가 제공한 CA 인증서와 검증 옵션을 사용하세요.
SQLite 파일이 열리지 않을 때
SQLite 연결에서는 서버 주소가 아니라 .db, .sqlite 같은 실제 데이터베이스 파일을 선택합니다. 읽기 전용 폴더나 동기화 중인 클라우드 폴더에 파일이 있으면 잠금 오류가 생길 수 있으므로 복사본으로 먼저 확인하세요.
database is locked가 계속 나오면 같은 파일을 사용하는 다른 프로그램과 진행 중인 트랜잭션을 종료합니다. 원본 파일을 다른 형식으로 바꾸거나 강제로 잠금을 지우지 말고 백업 복사본에서 정상적으로 열리는지 시험하세요.
인증서·SSH 터널 오류 해결
사설망 데이터베이스는 SSH Tunnel을 켜고 SSH 호스트, 포트, 사용자와 키 파일을 입력할 수 있습니다. 데이터베이스 Host에는 터널 안에서 접근 가능한 주소를 사용해야 하므로 SSH 서버 주소와 혼동하지 마세요.
TLS 인증서 오류가 나면 Reject Unauthorized를 임의로 끄기 전에 서버 인증서의 이름과 만료일, CA 파일을 확인하세요. 자체 서명 인증서를 쓰는 환경은 관리자가 제공한 CA를 등록해 검증하는 방식이 안전합니다.
쿼리가 오래 걸리거나 화면이 멈출 때
조건 없는 SELECT와 큰 JOIN은 많은 행을 읽어 앱과 서버를 동시에 느리게 만들 수 있습니다. 먼저 LIMIT 100과 좁은 WHERE 조건으로 결과 구조를 확인하고, 필요한 열만 선택하세요.
실행 중인 쿼리는 취소한 뒤 인덱스와 실행 계획을 데이터베이스 관리자와 점검합니다. 공식 문서는 화면 결과가 5만 행을 넘으면 메모리 보호를 위해 잘릴 수 있다고 안내하므로, 화면에 전부 표시되는 것을 전체 데이터 추출 완료로 보지 마세요.
업데이트 후 연결이 보이지 않을 때
먼저 같은 Windows 사용자 계정에서 실행했는지 확인하고 앱을 연 상태에서 연결을 새로 덮어쓰지 마세요. Beekeeper Studio 설정과 사용자 데이터는 Windows에서 %APPDATA%\beekeeper-studio 아래에 있으므로 백업본이 있다면 앱을 종료한 상태에서 복구 범위를 확인합니다.
포터블과 설치형을 번갈아 썼다면 각 실행 환경에서 연결 저장 위치와 계정을 확인하세요. 서버 암호를 모르면 저장 파일을 직접 편집하기보다 데이터베이스 관리자로부터 새 암호나 연결 정보를 받아 새 연결을 만드는 편이 안전합니다.
설치부터 첫 조회 완료까지
Beekeeper Studio 6.1.4를 설치하거나 포터블로 실행하고 New Connection에서 데이터베이스 종류를 선택하세요. Host, Port, User와 Database를 입력해 Test가 성공하면 Connect합니다.
Entities에서 테이블을 하나 확인하고 새 Query 탭에서 LIMIT를 포함한 SELECT를 실행하세요. 결과 표의 열과 행, 실행 시간을 확인하면 다운로드, 설치, 연결과 첫 SQL 조회까지 한 번에 마칠 수 있습니다.
자주 묻는 질문
Beekeeper Studio는 무료인가요?
Community Edition은 무료 오픈 소스입니다. 일부 데이터베이스, AI와 협업 같은 고급 기능은 유료 플랜에서 제공합니다.
Windows 설치형과 포터블 중 무엇을 받나요?
일반 PC는 자동 업데이트와 바로 가기를 쓰기 편한 Setup 설치형, 관리자 권한이 없거나 USB에서 쓸 때는 포터블 EXE를 선택하세요.
MySQL과 PostgreSQL을 모두 연결할 수 있나요?
네. New Connection에서 엔진을 선택하고 서버별 Host, Port, User, Password와 Database를 입력하면 됩니다.
데이터베이스 비밀번호를 저장해도 되나요?
개인 PC에서 OS 계정이 보호되는 경우에만 필요한 연결에 저장하세요. 공용 PC나 임시 장비에서는 Save Passwords를 끄세요.
연결은 되는데 테이블이 보이지 않는 이유는 무엇인가요?
선택한 Database와 Schema, 사용자 권한을 확인하고 목록을 새로 고침하세요. 계정에 메타데이터 조회 권한이 없으면 서버 관리자에게 권한을 요청해야 합니다.
연결 테스트 뒤 LIMIT 조회로 시작하세요
Beekeeper Studio 6.1.4 설치형이나 포터블을 실행하고 New Connection에서 Test를 먼저 통과시키세요. 연결 후 테이블 하나를 고르고 LIMIT가 있는 SELECT를 실행해 결과 표를 확인하면 설치부터 첫 데이터베이스 조회까지 안전하게 마칠 수 있습니다.
공식 자료와 확인일
Beekeeper Studio 공식 다운로드 · Community Edition 기능과 무료 범위 · 공식 최신 릴리스 · 공식 데이터베이스 연결 문서 · 공식 SQL 편집기 문서 | 2026-09-30T18:29:14.038012+09:00
