SQLDeveloper 오류: Locale not recoginized

오라클의 SQL 툴인 SQLDeveloper를 맥에서 사용할 때, Locale을 인식하지 못하는 에러가 발생할 수 있습니다. 이런 오류는 데이터베이스 커넥션 테스트 과정에서 주로 발생합니다. 특히 OSX를 버전 업그레이드한 다음에 빈번하게 발생합니다.

SQLDeveloper에서 Locale를 인식하지 못하는 문제가 발생할 경우 해결하는 방법을 정리합니다.

- SQLDeveloper이 커넥션 테스트 오류 (OS: OSX, SQLDeveloper 버전: 18.2.0.183)

위 그림은 SQLDeveloper를 실행한 후, 오라클 데이터베이스 접속 설정 후, 접속 테스트를 진행할 때 발생한 오류입니다. 에러가 발생한 실행 환경은 다음과 같습니다.

  • OS: macOS Mojave (버전: 10.14)
  • Java: 1.8.0_161-b12
  • SQLDeveloper: 18.2.0.183

이 문제를 해결하기 위해서는 SQLDeveloper의 설치 파일에 위치하는 “sqldeveloper.conf” 파일에 JVM Locale 설정을 추가해야 합니다.

- SQLDeveoper 설치 디렉터리 이동

Finder에서 SQLDeveloepr를 검색하여, 프로그램 설치 디렉터리로 이동합니다.

- sqldeveloper.conf 파일 위치 확인

“sqldeveoper.conf” 파일은 SQLDeveloper의 설치 디렉터리 아래에 위치합니다. 위 그림과 같이 “sqldeveloper.conf” 파일 위치를 확인하고, 이 파일을 편집기로 오픈합니다.

“sqldeveloper.conf”의 설치 경로는 SQLDeveloper 설치 디렉터리 아래에 다음 경로에 위치합니다.

Contents/Resources/sqldeveloper/sqldeveloper/bin/sqldeveloper.conf

  • sqldeveloper.conf 파일에 Locale 설정

“sqldeveloper.conf” 파일의 마지막에 위 그림과 같은 Locale을 설정합니다.

AddVMOption -Duser.language=ko
AddVMOption -Duser.country=KR 

“sqldeveloper.conf”저장한 후, SQLDeveloper를 재시작하고 데이터베이스 커넥션 테스트를 진행하면 다음 그림과 같이 정상적으로 동작하는 것을 확인할 수 있습니다.

- sqldeveloper.conf 파일에 Locale 설정