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

ORA-14401
2026년 09월 24일 | DBMS Error 가이드

이 글에서 다루는 내용

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

ORA-14401 inserted partition key is beyond highest legal partition key 는?

ORA-14401 에러는 Oracle 파티션 테이블에 데이터를 INSERT할 때, 삽입하려는 행의 파티션 키 값이 해당 테이블에 정의된 마지막(최상위) 파티션의 상한 경계값을 초과할 경우 발생합니다. 즉, 테이블이 수용할 수 있는 값의 범위를 벗어난 데이터를 넣으려 할 때 Oracle이 이를 거부하는 것입니다. 주로 RANGE 파티션 테이블에서 발생하며, 날짜 기반 파티션 테이블에 미래 날짜 데이터가 들어오거나 숫자 범위 파티션에 예상 범위 밖의 값이 입력될 때 자주 나타납니다.

주요 발생 원인

1. RANGE 파티션 테이블에 MAXVALUE 파티션이 없는 경우

RANGE 파티션 테이블을 설계할 때 마지막 파티션에 VALUES LESS THAN (MAXVALUE)를 지정하지 않으면, 정의된 상한값을 초과하는 데이터는 어느 파티션에도 할당될 수 없어 ORA-14401이 발생합니다. 예를 들어 2024년 12월까지만 파티션을 정의했는데 2025년 1월 데이터가 들어오면 즉시 에러가 발생합니다. 이는 실무에서 가장 흔한 원인으로, 파티션 관리 자동화가 되어 있지 않은 환경에서 특히 빈번하게 발생합니다.

2. 파티션 추가(ADD PARTITION) 작업 누락 또는 지연

운영 중인 시스템에서 정기적으로 새 파티션을 추가해야 하는데, 담당자의 실수나 배치 스크립트 장애로 파티션이 제때 추가되지 않은 경우 발생합니다. 월별 또는 연도별로 파티션을 나누는 테이블에서 신년이나 월초에 갑자기 이 에러가 터지는 상황이 이에 해당합니다. 배치 잡이 실패했거나 DBA의 수동 작업이 누락된 경우가 대부분이며, 모니터링 부재가 근본 원인인 경우가 많습니다.

3. 애플리케이션에서 예상치 못한 미래 날짜 또는 극단값 데이터 입력

애플리케이션 버그, 사용자 입력 오류, 또는 외부 시스템과의 연동 과정에서 비정상적인 날짜(예: 9999-12-31, 2099년 데이터 등)나 극단적으로 큰 숫자가 파티션 키 컬럼에 입력되는 경우입니다. 파티션 키가 날짜 컬럼일 때 DEFAULT 값 설정 오류나 ETL 변환 로직 오류로 인해 발생하기도 하며, 이 경우 데이터 품질 문제와 함께 에러가 동반됩니다.

해결 방법

원인 1 해결: 새로운 파티션 추가

현재 파티션 현황을 확인한 후, 필요한 파티션을 추가합니다.

-- 현재 파티션 목록 확인
SELECT partition_name, high_value, partition_position
FROM user_tab_partitions
WHERE table_name = 'SALES'
ORDER BY partition_position;

-- 파티션 추가 예시 (날짜 기반)
ALTER TABLE sales
ADD PARTITION p_2025_q1
VALUES LESS THAN (TO_DATE('2025-04-01', 'YYYY-MM-DD'));

ALTER TABLE sales
ADD PARTITION p_2025_q2
VALUES LESS THAN (TO_DATE('2025-07-01', 'YYYY-MM-DD'));

-- 숫자 기반 파티션 추가 예시
ALTER TABLE orders
ADD PARTITION p_high
VALUES LESS THAN (1000000);

원인 2 해결: MAXVALUE 파티션으로 테이블 재설계 또는 추가

기존 테이블에 MAXVALUE 파티션을 추가하여 향후 범위 초과를 방지합니다.

-- MAXVALUE 파티션 추가 (기존 파티션 범위 이후에 추가)
ALTER TABLE sales
ADD PARTITION p_future
VALUES LESS THAN (MAXVALUE);

-- 신규 테이블 설계 시 처음부터 MAXVALUE 포함 권장
CREATE TABLE orders_new (
    order_id    NUMBER,
    order_date  DATE,
    amount      NUMBER
)
PARTITION BY RANGE (order_date) (
    PARTITION p_2024_q1 VALUES LESS THAN (TO_DATE('2024-04-01','YYYY-MM-DD')),
    PARTITION p_2024_q2 VALUES LESS THAN (TO_DATE('2024-07-01','YYYY-MM-DD')),
    PARTITION p_2024_q3 VALUES LESS THAN (TO_DATE('2024-10-01','YYYY-MM-DD')),
    PARTITION p_2024_q4 VALUES LESS THAN (TO_DATE('2025-01-01','YYYY-MM-DD')),
    PARTITION p_future  VALUES LESS THAN (MAXVALUE)  -- 항상 마지막에 추가
);

원인 3 해결: 데이터 유효성 검증 및 예외 처리

INSERT 전에 파티션 키 값의 범위를 사전 검증하거나, 에러 발생 시 로깅 처리합니다.

-- 삽입 전 파티션 범위 초과 여부 확인
DECLARE
    v_max_date DATE;
    v_insert_date DATE := TO_DATE('2026-01-01','YYYY-MM-DD');
BEGIN
    -- 현재 테이블의 최대 파티션 상한 확인 (MAXVALUE 제외)
    SELECT MAX(TO_DATE(
        REGEXP_SUBSTR(high_value, '''[^'']+'''), 
        'SYYYY-MM-DD HH24:MI:SS'))
    INTO v_max_date
    FROM user_tab_partitions
    WHERE table_name = 'SALES'
      AND high_value != 'MAXVALUE';

    IF v_insert_date >= v_max_date THEN
        DBMS_OUTPUT.PUT_LINE('경고: 파티션 추가 필요. 현재 최대: ' || TO_CHAR(v_max_date));
        -- 여기서 새 파티션 추가 또는 알림 발송 로직 호출
    ELSE
        INSERT INTO sales (order_id, order_date, amount)
        VALUES (SEQ_SALES.NEXTVAL, v_insert_date, 5000);
        COMMIT;
    END IF;
END;
/

-- INTERVAL 파티션으로 전환하여 자동 파티션 생성 활용
-- (Oracle 11g 이상에서 사용 가능)
CREATE TABLE sales_interval (
    sale_id    NUMBER,
    sale_date  DATE,
    amount     NUMBER
)
PARTITION BY RANGE (sale_date)
INTERVAL (NUMTOYMINTERVAL(1, 'MONTH'))  -- 월별 자동 파티션 생성
(
    PARTITION p_start VALUES LESS THAN (TO_DATE('2024-01-01','YYYY-MM-DD'))
);

예방 방법

1. INTERVAL 파티션 또는 자동 파티션 관리 도입

Oracle 11g 이상에서는 INTERVAL 파티션을 사용하면, 정의된 간격(월, 년 등)으로 새 파티션이 자동으로 생성됩니다. 수동으로 파티션을 추가할 필요가 없어 인적 실수로 인한 ORA-14401을 근본적으로 차단할 수 있습니다. RANGE 파티션을 반드시 사용해야 하는 경우라면, DBMS_SCHEDULER를 활용해 정기적으로 파티션을 사전 추가하는 자동화 잡을 구성하고, 실패 시 DBA에게 알림이 가도록 설정하는 것이 필수입니다.

-- DBMS_SCHEDULER를 이용한 자동 파티션 추가 잡 예시
BEGIN
    DBMS_SCHEDULER.CREATE_JOB (
        job_name        => 'JOB_ADD_MONTHLY_PARTITION',
        job_type        => 'PLSQL_BLOCK',
        job_action      => '
            BEGIN
                EXECUTE IMMEDIATE
                    ''ALTER TABLE sales ADD PARTITION ''
                    || ''p_'' || TO_CHAR(ADD_MONTHS(SYSDATE,1),''YYYY_MM'')
                    || '' VALUES LESS THAN (TO_DATE(''''''
                    || TO_CHAR(ADD_MONTHS(TRUNC(SYSDATE,''MM''),2),''YYYY-MM-DD'')
                    || '''''',''''YYYY-MM-DD''''))'';
            END;',
        start_date      => SYSTIMESTAMP,
        repeat_interval => 'FREQ=MONTHLY;BYMONTHDAY=1;BYHOUR=0;BYMINUTE=0',
        enabled         => TRUE,
        comments        => '월별 파티션 자동 추가 잡'
    );
END;
/

2. 파티션 상한 모니터링 알림 체계 구축

현재 날짜 또는 예상 데이터 범위와 파티션 상한값 간의 차이를 주기적으로 모니터링하여, 파티션 만료가 임박했을 때 자동으로 경고를 발생시키는 체계를 구축합니다. 아래 쿼리를 활용해 파티션 만료 예상 일정을 미리 파악하고, 30일 이내 만료 예정인 파티션 테이블에 대해 이메일 또는 ITSM 티켓 알림을 보내는 프로세스를 운영 표준에 포함시켜야 합니다.

-- 파티션 만료 임박 모니터링 쿼리
SELECT 
    table_name,
    partition_name,
    high_value,
    ROUND(
        TO_DATE(
            SUBSTR(high_value, INSTR(high_value,'''')+1, 
                   INSTR(high_value,'''',1,2)-INSTR(high_value,'''')-1),
            'SYYYY-MM-DD HH24:MI:SS'
        ) - SYSDATE
    ) AS days_until_expiry
FROM user_tab_partitions
WHERE high_value != 'MAXVALUE'
  AND table_name IN ('SALES','ORDERS','LOG_TABLE')
HAVING ROUND(
    TO_DATE(
        SUBSTR(high_value, INSTR(high_value,'''')+1, 
               INSTR(high_value,'''',1,2)-INSTR(high_value,'''')-1),
        'SYYYY-MM-DD HH24:MI:SS'
    ) - SYSDATE
) < 30
ORDER BY days_until_expiry;