오라클 SQL 실습 필수품! SQL Developer 한글 깨짐 원인과 폰트/인코딩 세팅 꿀팁
오라클(Oracle) 데이터베이스를 공부하거나 SQLD 자격증 실기 실습을 위해 내 PC에 DB 환경을 구축했다면, 그다음으로 반드시 설치해야 하는 필수 프로그램이 있습니다. 바로 검은색 명령 프롬프트 창 대신 직관적이고 편리한 그래픽 사용자 인터페이스(GUI) 환경에서 쿼리를 작성하고 실행 결과를 볼 수 있게 해주는 오라클의 공식 무료 시각화 툴, 'SQL Developer'입니다. 데이터 분석가나 백엔드 개발자 실무에서도 빈번하게 사용되는 이 툴은 오라클 생태계에서 없어서는 안 될 강력한 단짝입니다. 하지만 처음 SQL Developer를 설치하고 설레는 마음으로 한글 주석을 달거나 한글로 된 데이터를 조회(SELECT)했을 때, 글자가 온통 네모 박스(□□□)나 알 수 없는 물음표(???)로 무참히 깨져 나오는 현상을 마주하고 당황하는 초보자들이 대단히 많습니다. 이는 프로그램 자체가 고장 난 것이 아니라, 툴의 기본 글꼴이 한글을 제대로 지원하지 않거나 자바 가상 머신(JVM)의 문자 인코딩 설정이 맞지 않아 발생하는 아주 흔하고 자연스러운 현상입니다. 오늘은 오라클 공식 홈페이지에서 내 운영체제에 맞는 SQL Developer를 올바르게 다운로드하고 설치하는 방법부터, 골치 아픈 한글 깨짐 오류를 단 1분 만에 영구적으로 해결하는 두 가지 확실한 세팅 비법(글꼴 변경 및 인코딩 설정)까지 아주 상세하고 친절하게 총정리해 드립니다. 쾌적한 환경에서 쿼리 작성에만 온전히 집중해 보세요.
1. 내 PC에 맞는 올바른 SQL Developer 다운로드 방법
가장 먼저 오라클 공식 홈페이지의 다운로드 페이지에 접속하여 설치 파일을 내려받아야 합니다. 윈도우(Windows) 사용자의 경우 다운로드 목록을 보면 파일이 크게 두 가지로 나뉘어 있는 것을 볼 수 있습니다. 하나는 'JDK 포함(with JDK)' 버전이고, 다른 하나는 'JDK 미포함' 버전입니다. SQL Developer는 자바(Java) 기반으로 구동되는 프로그램이기 때문에 PC에 자바 개발 키트(JDK)가 필수적으로 깔려 있어야 합니다. 본인의 컴퓨터에 자바가 설치되어 있는지 잘 모르겠거나 환경 변수 설정이 번거롭다면, 고민할 필요 없이 용량이 조금 더 큰 'Windows 64-bit with JDK included' 버전을 다운로드하시는 것을 강력히 추천합니다. 압축 파일 형태로 다운로드되며, 별도의 복잡한 설치 마법사 과정 없이 원하는 폴더(예: C드라이브)에 압축을 풀고 그 안의 'sqldeveloper.exe' 파일만 더블 클릭하면 프로그램이 즉시 실행되는 포터블(Portable) 형태입니다.
2. 한글 깨짐의 첫 번째 주범, '글꼴(Font)' 문제 파악하기
프로그램을 실행하고 DB에 접속하여 테이블의 데이터를 조회(SELECT)했는데, 영어나 숫자는 멀쩡히 잘 나오면서 유독 한글 데이터만 네모 박스(□□□)로 표시된다면 이는 100% '글꼴(Font)' 문제입니다. SQL Developer가 처음 실행될 때 코드 편집기와 결과창에 기본적으로 적용되는 디폴트 폰트가 영문 전용 폰트인 경우가 많아, 한글 문자를 화면에 그려내지 못하고 깨진 특수기호로 렌더링해 버리는 것입니다. 이는 데이터베이스 내부의 데이터가 손상된 것이 아니라 단지 우리 눈에 보이는 시각적인 출력의 문제일 뿐이므로 크게 당황할 필요가 없습니다. 아주 간단한 환경설정 메뉴 진입만으로 내가 원하는 예쁜 한글 지원 폰트로 변경하여 문제를 단숨에 해결할 수 있습니다.
3. 해결책 1: 환경설정에서 한글 지원 코딩 폰트로 변경하기
폰트 문제를 해결하기 위해 SQL Developer 상단 메뉴 바에서 **[도구(Tools)] -> [환경설정(Preferences)]**을 차례로 클릭합니다. 나타나는 팝업창의 좌측 트리 메뉴에서 **[코드 편집기(Code Editor)] -> [글꼴(Fonts)]** 탭으로 이동합니다. 우측 화면에 글꼴 이름(Font Name)을 선택할 수 있는 드롭다운 메뉴가 나타나는데, 여기서 기본 폰트 대신 한글을 완벽하게 지원하는 폰트로 변경해 주어야 합니다. 윈도우 기본 폰트인 '맑은 고딕(Malgun Gothic)'을 선택해도 좋지만, 개발자와 데이터 분석가들 사이에서 가장 가독성이 좋기로 소문난 네이버의 무료 코딩용 폰트인 **'D2Coding'** 폰트를 PC에 미리 설치한 뒤 적용하는 것을 강력히 추천합니다. 코딩용 폰트는 숫자 '1', 대문자 'I', 소문자 'l' 등을 명확하게 구분해 주어 오타를 획기적으로 줄여줍니다. 폰트를 변경하고 하단의 [확인] 버튼을 누르면 즉시 쿼리창과 결과창의 한글이 정상적으로 출력되는 것을 확인할 수 있습니다.
4. 한글 깨짐의 두 번째 주범, 'UTF-8 인코딩(Encoding)' 문제
만약 글꼴을 한글 폰트로 바꿨음에도 불구하고 여전히 한글이 물음표(???)나 이상한 외계어로 깨져 나오거나, 내가 한글로 작성한 주석 파일을 저장했다가 다시 열었을 때 글씨가 다 망가져 있다면 이는 '인코딩(Encoding)' 문제입니다. 한국어 윈도우 운영체제는 기본적으로 'MS949(또는 EUC-KR)'라는 독자적인 문자 인코딩 방식을 사용하지만, 최근의 데이터베이스와 웹 환경, 그리고 SQL Developer 프로그램은 글로벌 표준인 'UTF-8' 방식을 기본으로 채택하고 있습니다. 이 둘 사이의 문자 해석 방식(인코딩 규칙)이 충돌하면서 컴퓨터가 한글을 제대로 번역하지 못해 외계어가 출력되는 것입니다. 이 문제는 툴 내부의 설정 메뉴에서는 해결할 수 없으며, 프로그램이 구동될 때 읽어 들이는 환경 설정 파일(conf)을 직접 텍스트 편집기로 열어 강제로 UTF-8 세팅을 주입해 주어야만 완벽하게 해결됩니다.
5. 해결책 2: sqldeveloper.conf 파일 수정으로 인코딩 영구 해결
인코딩 오류를 영구적으로 바로잡기 위해서는 먼저 열려 있는 SQL Developer 프로그램을 완전히 종료합니다. 그다음, 처음에 압축을 풀었던 SQL Developer 폴더로 이동하여 `\sqldeveloper\sqldeveloper\bin` 경로를 찾아 들어갑니다. 그곳에 있는 **`sqldeveloper.conf`**라는 이름의 구성 파일을 마우스 우클릭하여 '메모장'이나 'Notepad++' 같은 텍스트 편집기로 열어줍니다. 영어가 가득 적힌 문서가 열릴 텐데, 스크롤을 맨 아래로 내려 가장 마지막 줄 빈칸에 **`AddVMOption -Dfile.encoding=UTF-8`** 이라는 문장을 오타 없이 정확하게 복사해서 붙여넣습니다. (이때 AddVMOption의 대소문자와 띄어쓰기를 철저히 지켜야 합니다.) 메모장 상단의 [파일] -> [저장]을 눌러 수정한 내용을 덮어씌운 뒤 닫아줍니다. 이제 다시 SQL Developer를 실행해 보시면, 자바 가상 머신(VM)이 강제로 UTF-8 환경으로 구동되면서 더 이상 한글 주석이나 데이터가 외계어로 깨지는 일 없이 아주 깨끗하고 완벽하게 출력되는 것을 확인하실 수 있습니다.
