Oracle ORA-12714 오류 원인과 해결 방법 완벽 가이드

ORA-12714
2026년 09월 16일 | DBMS Error 가이드

이 글에서 다루는 내용

ORA-12714 에러의 원인 분석, 해결 SQL, 예방 방법을 실무 관점에서 정리합니다.

ORA-12714 invalid national character set specified 는?

ORA-12714 에러는 Oracle 데이터베이스에서 국가 문자 집합(National Character Set) 을 잘못 지정했을 때 발생하는 에러입니다. Oracle은 국가 문자 집합으로 오직 AL16UTF16 또는 UTF8 두 가지만 허용하며, 이 외의 값을 지정하면 즉시 이 에러가 발생합니다. 주로 데이터베이스 생성(CREATE DATABASE) 시, NCHAR/NVARCHAR2/NCLOB 타입 사용 시, 또는 NLS 관련 파라미터를 잘못 설정할 때 나타납니다.

주요 발생 원인

1. 데이터베이스 생성 시 잘못된 NATIONAL CHARACTER SET 지정

데이터베이스를 처음 생성할 때 CREATE DATABASE 구문 안에 NATIONAL CHARACTER SET 절에 Oracle이 지원하지 않는 문자 집합 이름을 명시하면 이 에러가 발생합니다. 예를 들어 KO16MSWIN949, KO16KSC5601, UTF-8(하이픈 포함) 처럼 일반 문자 집합 이름이나 오탈자가 있는 이름을 입력하면 즉각 거부됩니다. Oracle의 국가 문자 집합은 유니코드 기반의 두 가지 값만 허용되므로 반드시 정확한 이름을 사용해야 합니다.

2. NLS_NCHAR_CHARACTERSET 파라미터 수동 변경 시도

ALTER SYSTEM 또는 ALTER DATABASE 구문으로 NLS_NCHAR_CHARACTERSET 파라미터를 허용되지 않는 값으로 변경하려 할 때 이 에러가 발생합니다. 이 파라미터는 데이터베이스 생성 이후에는 일반적인 방법으로 변경할 수 없으며, 무리하게 변경을 시도하면 ORA-12714와 함께 다른 심각한 에러가 연쇄적으로 발생할 수 있습니다. DBA가 잘못된 문서나 타 DBMS 경험을 바탕으로 파라미터를 조작하려 할 때 자주 발생하는 패턴입니다.

3. DBCA(Database Configuration Assistant) 또는 스크립트 오타/잘못된 값

DBCA를 사용하지 않고 수동 스크립트로 데이터베이스를 생성할 때, 템플릿 스크립트의 NATIONAL CHARACTER SET 값을 잘못 수정하거나 복사-붙여넣기 과정에서 오탈자가 발생하면 이 에러가 나타납니다. 특히 AL16UTF16을 AL16UTF-16, AL16UTF 16, al16utf16(소문자) 등으로 잘못 입력하는 경우가 실무에서 빈번하게 보고됩니다. 자동화 스크립트나 CI/CD 파이프라인에서 환경 변수로 문자 집합을 주입할 때도 동일한 문제가 발생할 수 있습니다.

해결 방법

원인 1 해결: 올바른 NATIONAL CHARACTER SET으로 데이터베이스 생성

Oracle이 허용하는 국가 문자 집합은 AL16UTF16과 UTF8 두 가지뿐입니다. 아래와 같이 정확한 값을 사용하세요.

-- 잘못된 예시 (ORA-12714 발생)
CREATE DATABASE mydb
  CHARACTER SET AL32UTF8
  NATIONAL CHARACTER SET KO16MSWIN949;  -- 허용되지 않는 값

-- 올바른 예시 1: AL16UTF16 사용 (권장)
CREATE DATABASE mydb
  CHARACTER SET AL32UTF8
  NATIONAL CHARACTER SET AL16UTF16;

-- 올바른 예시 2: UTF8 사용
CREATE DATABASE mydb
  CHARACTER SET AL32UTF8
  NATIONAL CHARACTER SET UTF8;

> 실무 팁: Oracle 12c 이후부터는 AL16UTF16을 기본값으로 권장합니다. UTF8은 구형 호환성을 위해 남겨져 있으며, 신규 구축 시에는 반드시 AL16UTF16을 사용하세요.

원인 2 해결: 현재 NLS_NCHAR_CHARACTERSET 값 확인 및 대응

먼저 현재 데이터베이스의 국가 문자 집합을 정확히 확인합니다.

-- 현재 국가 문자 집합 확인
SELECT *
FROM   NLS_DATABASE_PARAMETERS
WHERE  PARAMETER = 'NLS_NCHAR_CHARACTERSET';

-- 또는 V$NLS_PARAMETERS 뷰로 확인
SELECT PARAMETER, VALUE
FROM   V$NLS_PARAMETERS
WHERE  PARAMETER = 'NLS_NCHAR_CHARACTERSET';

-- 전체 NLS 파라미터 한꺼번에 확인 (참고용)
SELECT PARAMETER, VALUE
FROM   NLS_DATABASE_PARAMETERS
ORDER  BY PARAMETER;

만약 국가 문자 집합을 변경해야 한다면, 일반적인 ALTER 명령으로는 불가능합니다. Oracle의 Character Set Scanner(csscan) 유틸리티 또는 DMU(Database Migration Assistant for Unicode) 를 통해 데이터 손실 여부를 먼저 검토한 후, 공식 절차에 따라 변경해야 합니다.

-- 잘못된 시도 (ORA-12714 또는 ORA-02231 발생)
ALTER DATABASE CHARACTER SET UTF8;  -- 이 방법으로는 NCHAR 집합 변경 불가

-- NLS_NCHAR_CHARACTERSET은 일반 ALTER SYSTEM으로 변경 불가
-- 아래는 에러 발생 예시
ALTER SYSTEM SET NLS_NCHAR_CHARACTERSET = 'AL16UTF16';  -- 에러 발생

원인 3 해결: 스크립트 값 검증 및 수정

자동화 스크립트나 수동 스크립트를 사용할 경우, 다음 쿼리로 허용 값을 미리 확인할 수 있습니다.

-- Oracle에서 지원하는 국가 문자 집합 목록 확인
SELECT NLS_CHARSET_NAME(CHARSETID) AS CHARSET_NAME,
       CHARSETID
FROM   V$NLS_VALID_VALUES
WHERE  PARAMETER = 'CHARACTERSET'
  AND  NLS_CHARSET_NAME(CHARSETID) IN ('AL16UTF16', 'UTF8');

-- 실제 허용되는 국가 문자 집합만 필터링
SELECT *
FROM   V$NLS_VALID_VALUES
WHERE  PARAMETER = 'NCHARACTERSET';

-- 문자 집합 ID로 이름 조회 (검증용)
SELECT NLS_CHARSET_NAME(2000) FROM DUAL;  -- AL16UTF16의 CHARSETID는 2000
SELECT NLS_CHARSET_NAME(871)  FROM DUAL;  -- UTF8의 CHARSETID는 871

예방 방법

1. 데이터베이스 생성 전 표준 템플릿 문서화 및 검토 프로세스 수립

신규 데이터베이스 생성 스크립트는 반드시 팀 내 검증된 표준 템플릿을 사용하고, 문자 집합 관련 파라미터는 코드 리뷰 또는 이중 확인(double-check) 프로세스를 적용하세요. CI/CD 파이프라인에서 데이터베이스를 자동 생성하는 경우, 문자 집합 값을 하드코딩하거나 허용 목록(whitelist)으로 검증하는 단계를 반드시 포함시켜야 합니다. AL16UTF16 또는 UTF8 이외의 값이 입력될 경우 스크립트 자체에서 실행을 중단하는 가드(guard) 로직을 추가하는 것이 좋습니다.

2. 운영 환경 NLS 파라미터 모니터링 및 변경 통제 정책 적용

운영 데이터베이스의 NLS 관련 파라미터는 변경 관리(Change Management) 프로세스 없이 수정하지 않도록 정책을 수립하세요. 정기적으로 NLS_DATABASE_PARAMETERS 뷰를 조회하여 문자 집합 값이 초기 구성과 일치하는지 점검하고, 변경 이력을 관리 대장에 기록해야 합니다. Oracle Audit 기능을 활용하여 ALTER DATABASE, ALTER SYSTEM 명령에 대한 감사 로그를 활성화하면 무단 변경 시도를 사전에 차단하거나 추적할 수 있습니다.