HeidiSQL은 MySQL, MariaDB, PostgreSQL, Microsoft SQL Server와 SQLite를 그래픽 화면에서 연결하고 관리하는 무료 오픈소스 프로그램입니다. Windows x64 설치형과 Portable을 제공합니다.
이 글에서는 안정 버전 12.21 설치 파일 선택, 세션 연결, SSH 터널, 테이블·데이터·SQL 편집, CSV·덤프 가져오기와 내보내기, 접속·DLL·문자 인코딩 오류 해결을 실제 공식 화면 기준으로 안내합니다.
HeidiSQL은 어떤 프로그램인가요?
여러 데이터베이스 서버의 스키마와 데이터를 트리·그리드·SQL 편집기로 관리하는 데스크톱 클라이언트입니다. 테이블 구조, 인덱스, 사용자, 프로세스와 서버 변수를 확인할 수 있습니다.
서버 프로그램을 대신하지 않으며 접속할 데이터베이스 주소와 계정이 필요합니다. 운영 데이터를 수정할 때는 SELECT 확인, 백업과 트랜잭션을 먼저 준비해야 합니다.
HeidiSQL 세션 관리자·쿼리 편집기·데이터 그리드 화면
HeidiSQL 공식 사이트가 제공하는 실제 연결 설정, SQL 편집과 결과, 테이블 데이터 그리드 화면입니다.
| 지원 DB | MariaDB·MySQL |
|---|---|
| 지원 DB | PostgreSQL·SQL Server |
| 로컬 DB | SQLite |
| 연결 | TCP/IP·SSH 터널 |
| 편집 | 테이블·데이터·SQL |
| 가져오기 | CSV·SQL |
| 내보내기 | SQL·CSV·HTML |
| 배포 | Installer·Portable |
HeidiSQL 12.21 무료 사용 범위와 지원 데이터베이스
HeidiSQL은 MariaDB, MySQL, Microsoft SQL Server, PostgreSQL, SQLite와 Interbase·Firebird 서버를 관리하는 무료 오픈소스 데이터베이스 도구입니다. 세션 연결, 테이블 구조 편집, 데이터 그리드, SQL 실행과 가져오기·내보내기를 한 화면에서 처리합니다.
안정 버전 12.21은 Windows x64 설치형과 Portable ZIP을 제공합니다. 연결하려는 데이터베이스 서버는 별도로 실행 중이어야 하며 HeidiSQL 자체가 MySQL이나 PostgreSQL 서버를 설치해 주는 프로그램은 아닙니다.
Windows x64 설치형과 Portable 선택
일반 설치는 HeidiSQL_12.21.0.7344_Setup.exe(17,813,608바이트)를 실행합니다. 시작 메뉴, 파일 연결과 제거 항목이 필요할 때 적합합니다.
설치 권한이 없거나 USB·작업 폴더에서 실행하려면 HeidiSQL_12.21_64_Portable.zip(29,789,003바이트)을 새 폴더에 모두 풉니다. Portable도 설정과 세션 정보를 저장하므로 공용 PC에서는 비밀번호 저장을 피하세요.
- Windows x64 환경인지 설정 > 시스템 > 정보에서 확인하세요.
- 설치형 EXE 또는 Portable ZIP을 선택하세요.
- 설치형은 마법사를 완료하고 Portable은 전용 폴더에 모두 압축 해제하세요.
- HeidiSQL을 실행하고 세션 관리자에서 새로 만들기를 누르세요.
- 네트워크 유형, 호스트, 사용자, 포트를 입력해 열기로 연결하세요.
세션 관리자에서 첫 연결 만들기
실행하면 세션 관리자가 열립니다. 새로 만들기를 누르고 세션 이름을 정한 뒤 네트워크 유형에서 MariaDB or MySQL, Microsoft SQL Server, PostgreSQL, SQLite 등 대상에 맞는 드라이버를 선택하세요.
호스트명 또는 IP, 사용자, 비밀번호와 포트를 입력하고 열기를 누릅니다. MySQL·MariaDB 기본 포트는 3306, PostgreSQL은 5432, SQL Server는 보통 1433이지만 서버 설정이 다르면 관리자에게 실제 값을 확인하세요.
SSH 터널로 원격 MySQL 연결
외부에서 데이터베이스 포트를 직접 열지 않는 환경은 세션 설정의 SSH tunnel을 사용합니다. SSH 호스트와 포트, 사용자, 개인 키 또는 인증 정보를 입력하고 데이터베이스 호스트는 서버 내부에서 접근하는 주소로 설정하세요.
SSH 연결에는 plink.exe 경로가 필요할 수 있습니다. 키 형식과 권한 오류가 나면 PuTTY 계열에서 읽을 수 있는 키인지 확인하고, 먼저 SSH 클라이언트에서 같은 계정으로 로그인되는지 시험합니다.
데이터베이스와 테이블 구조 확인
연결 후 왼쪽 트리에서 데이터베이스를 펼치면 테이블, 뷰, 저장 프로시저와 이벤트를 확인할 수 있습니다. 테이블을 선택하면 열, 인덱스, 외래 키와 CREATE 문을 탭별로 볼 수 있습니다.
구조를 바꾸기 전 현재 CREATE 문과 백업을 보관하세요. 열 자료형, NULL 허용, 기본값이나 인덱스를 수정하면 HeidiSQL이 생성할 ALTER TABLE 문을 확인한 뒤 저장해야 합니다.
Data 탭에서 행 조회·수정
Data 탭은 테이블 내용을 그리드로 보여 주며 열 정렬, 필터와 행 제한을 적용할 수 있습니다. 셀을 수정한 뒤 다른 행으로 이동하거나 저장 동작을 수행하면 UPDATE 또는 INSERT가 실행됩니다.
운영 데이터는 기본 키가 없는 테이블에서 수정·삭제 범위가 예상보다 넓어질 수 있습니다. 먼저 WHERE 조건이 포함된 SELECT로 대상 행을 확인하고, 트랜잭션과 백업이 가능한 환경에서 작은 범위로 작업하세요.
Query 탭에서 SQL 작성과 실행
새 쿼리 탭에서 SQL을 작성하고 선택 영역 또는 전체 문장을 실행할 수 있습니다. 구문 강조, 자동 완성, 코드 조각과 여러 결과 탭을 지원해 SELECT 결과와 서버 메시지를 함께 확인할 수 있습니다.
UPDATE·DELETE를 실행하기 전에 같은 WHERE 조건의 SELECT로 대상 개수를 확인하세요. 여러 문장을 한 번에 실행할 때는 트랜잭션 지원 여부를 확인하고 오류가 난 문장과 실제 반영 범위를 로그에서 구분합니다.
CSV·텍스트 파일 가져오기
도구의 텍스트 파일 가져오기에서 CSV 또는 구분자 파일을 선택하고 대상 데이터베이스와 테이블, 문자 인코딩, 구분자와 첫 행의 열 이름 여부를 지정합니다. 미리보기에서 열 매핑이 맞는지 확인하세요.
날짜·숫자 형식이나 따옴표가 맞지 않으면 일부 행만 실패할 수 있습니다. 처음에는 복제 테이블에 소량을 가져와 오류 로그, 한글과 NULL 변환을 확인한 뒤 전체 파일을 처리하세요.
SQL 덤프와 데이터 내보내기
데이터베이스 또는 테이블을 오른쪽 클릭해 SQL로 내보내기를 열면 구조, 데이터, DROP·CREATE 문, INSERT 형식과 출력 대상을 선택할 수 있습니다. 한 파일, 테이블별 파일, 다른 서버나 클립보드로 보낼 수 있습니다.
복원 목적이라면 문자셋, 데이터베이스 생성문, 외래 키와 트리거 포함 여부를 확인하세요. 큰 덤프는 저장 공간과 실행 시간을 계산하고 테스트 서버에서 실제 복원이 되는지 확인해야 백업으로 믿을 수 있습니다.
결과 그리드를 CSV·HTML로 저장
쿼리 결과나 Data 그리드는 CSV, HTML, XML, LaTeX, Wiki markup, PHP 배열 등으로 내보낼 수 있습니다. 필요한 행과 열만 선택하고 열 이름 포함, 구분자, 따옴표와 인코딩을 지정하세요.
엑셀에서 한글이 깨지면 UTF-8 BOM 또는 프로그램에서 기대하는 인코딩을 선택해 시험합니다. 개인정보와 비밀번호 해시가 포함된 결과는 공유 폴더에 그대로 저장하지 말고 열과 행을 최소화하세요.
대용량 SQL 파일 열기와 실행
큰 SQL 파일은 편집기에 전체를 읽는 대신 파일을 직접 실행할지 묻는 창이 나타날 수 있습니다. 직접 실행은 메모리 사용을 줄이지만 중간 내용을 편집하기 어려우므로 대상 서버와 데이터베이스를 다시 확인하세요.
가져오기 전 덤프의 문자셋, CREATE DATABASE와 USE 문, 예상 크기를 확인하고 진행 상황과 오류 로그를 저장합니다. 운영 서버에서는 부하가 적은 시간에 실행하고 중단 시 재시작 방법을 준비하세요.
접속 실패와 타임아웃 해결
연결이 거부되면 서버 서비스가 실행 중인지, 호스트와 포트, 방화벽, VPN과 사용자 허용 호스트를 확인합니다. localhost와 127.0.0.1도 서버 설정에 따라 다른 방식으로 인증될 수 있습니다.
타임아웃은 네트워크 경로, SSH 터널, 서버 최대 연결 수와 장시간 쿼리를 구분해야 합니다. 같은 정보로 공식 명령줄 클라이언트에서 연결되는지 시험하면 HeidiSQL 설정 문제와 서버 문제를 나눌 수 있습니다.
vcruntime DLL 누락 오류
공식 다운로드 안내는 일부 드라이버에서 Microsoft Visual C++ Redistributable 라이브러리가 필요하다고 설명합니다. vcruntimeXYZ.dll 누락 메시지가 나오면 임의 DLL 사이트에서 파일을 받지 말고 Microsoft 공식 재배포 패키지를 설치하세요.
설치 뒤 HeidiSQL을 다시 실행하고 같은 드라이버 연결을 시험합니다. 회사 PC에서 설치 권한이 없다면 오류 이름, HeidiSQL 버전과 대상 데이터베이스를 관리자에게 전달하세요.
Portable 설정과 세션 정보 보호
Portable 폴더를 복사하거나 백업할 때 저장된 세션과 비밀번호가 함께 이동할 수 있습니다. 공유 USB나 동기화 폴더에서는 비밀번호 저장을 끄고 필요한 연결 정보만 안전한 암호 관리 도구로 보관하세요.
설치형과 Portable을 번갈아 쓰면 설정 저장 위치가 달라 같은 세션이 보이지 않을 수 있습니다. File 메뉴의 설정 내보내기·가져오기를 사용하고 원본 파일을 보관한 뒤 대상 환경에서 확인하세요.
업데이트와 v13 Preview 구분
12.21은 안정 릴리스이며 다운로드 페이지의 v13 Preview와 최신 자동 빌드는 별도 시험판입니다. 새 기능이 필요하지 않다면 안정 버전을 사용하고 업데이트 전 세션 설정과 중요한 쿼리 탭을 내보내세요.
야간 빌드는 공식 안정 릴리스가 아니며 심각한 버그가 있을 수 있다는 안내가 있습니다. 문제가 해결됐는지 시험할 때만 별도 폴더에서 사용하고 운영 연결 정보와 작업 파일을 안정 버전과 섞지 마세요.
자주 묻는 질문
HeidiSQL은 무료인가요?
네. GNU GPL 오픈소스 프로그램이며 안정 버전 설치형과 Portable을 무료로 제공합니다.
설치형과 Portable 중 무엇을 고르나요?
시작 메뉴와 제거 기능이 필요하면 설치형, 별도 폴더에서 실행하려면 Portable을 고르세요.
MySQL 서버도 함께 설치되나요?
아니요. HeidiSQL은 클라이언트이므로 연결할 데이터베이스 서버가 별도로 필요합니다.
연결이 거부되는 이유는 무엇인가요?
서버 서비스, 호스트·포트, 방화벽, VPN과 계정의 허용 호스트를 확인하세요.
vcruntime DLL 오류는 어떻게 해결하나요?
Microsoft 공식 Visual C++ Redistributable을 설치하고 다시 실행하세요.
파일을 고르고 테스트 세션에서 첫 쿼리를 실행하세요
Windows x64에서 설치형 또는 Portable 12.21을 준비하고 세션 관리자에 서버 유형과 접속 정보를 입력하세요. 연결 뒤 SELECT로 대상 데이터와 권한을 확인하고, 구조 수정·가져오기·내보내기는 백업과 복원 시험을 마친 뒤 진행하면 됩니다.
공식 자료와 확인일
HeidiSQL 공식 다운로드 · HeidiSQL 공식 기능·화면 · HeidiSQL 공식 GitHub | 2026-09-30T13:13:17.564311+09:00
