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

ORA-14400
2026년 09월 23일 | DBMS Error 가이드

이 글에서 다루는 내용

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

ORA-14400 inserted partition key does not map to any partition 는?

ORA-14400 에러는 파티션 테이블에 데이터를 INSERT할 때, 삽입하려는 행의 파티션 키 값이 테이블에 정의된 어떤 파티션 범위에도 해당되지 않을 경우 발생합니다. 주로 RANGE 파티션 또는 LIST 파티션 테이블에서 자주 발생하며, 파티션 정의 범위를 벗어나는 데이터를 삽입하려 할 때 Oracle이 해당 데이터를 저장할 파티션을 찾지 못해 에러를 반환합니다. 이 에러는 파티션 설계 시 데이터 범위를 충분히 고려하지 않았거나, 시간이 지남에 따라 데이터의 범위가 파티션 정의를 초과했을 때 발생하는 전형적인 파티션 관리 문제입니다.

주요 발생 원인

1. RANGE 파티션에서 최대 범위 초과

RANGE 파티션 테이블을 생성할 때 MAXVALUE를 포함한 파티션을 정의하지 않은 경우, 정의된 마지막 파티션의 상한값(LESS THAN)을 초과하는 데이터를 INSERT하면 ORA-14400이 발생합니다. 예를 들어 2023년까지만 파티션을 정의했는데 2024년 데이터를 입력하려 하면 즉시 에러가 발생합니다. 이는 파티션 테이블을 설계할 때 미래 데이터 범위를 충분히 고려하지 않은 경우에 가장 빈번하게 나타나는 원인입니다.

2. LIST 파티션에서 정의되지 않은 값 삽입

LIST 파티션은 특정 값 목록을 기반으로 데이터를 분류합니다. 파티션 정의 시 포함하지 않은 새로운 값(예: 새로운 지역 코드, 새로운 상태 코드 등)을 INSERT하려 할 때 에러가 발생합니다. DEFAULT 파티션을 별도로 지정하지 않으면 정의된 값 목록 이외의 모든 값에 대해 ORA-14400이 발생하므로, 비즈니스 요건 변경으로 새로운 값이 추가될 가능성이 있는 경우 반드시 DEFAULT 파티션 또는 ELSE 절을 포함해야 합니다.

3. 파티션 키 컬럼에 NULL 값 삽입 (RANGE 파티션)

RANGE 파티션에서 파티션 키 컬럼에 NULL 값을 삽입할 경우에도 ORA-14400이 발생할 수 있습니다. Oracle은 NULL을 가장 큰 값으로 처리하는 경우가 있으나, MAXVALUE 파티션이 없으면 NULL 키 값을 가진 행을 저장할 파티션을 찾지 못합니다. 이 경우 MAXVALUE 파티션을 추가하거나, 파티션 키 컬럼에 NOT NULL 제약 조건을 추가하여 NULL 삽입 자체를 방지하는 것이 바람직합니다.

해결 방법

원인 1 해결: RANGE 파티션에 새 파티션 추가

기존 RANGE 파티션 테이블에 새로운 파티션을 추가하거나, MAXVALUE 파티션을 생성하여 향후 범위를 포괄합니다.

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

-- 특정 연도 파티션 추가
ALTER TABLE sales
ADD PARTITION sales_2024
VALUES LESS THAN (TO_DATE('2025-01-01', 'YYYY-MM-DD'));

-- MAXVALUE 파티션 추가 (모든 미래 데이터 포괄)
ALTER TABLE sales
ADD PARTITION sales_max
VALUES LESS THAN (MAXVALUE);

-- 검증: 데이터 재삽입 시도
INSERT INTO sales (sale_id, sale_date, amount)
VALUES (1001, TO_DATE('2024-06-15', 'YYYY-MM-DD'), 50000);
COMMIT;

원인 2 해결: LIST 파티션에 새 파티션 또는 DEFAULT 파티션 추가

-- 현재 LIST 파티션 구조 확인
SELECT partition_name, high_value
FROM   user_tab_partitions
WHERE  table_name = 'REGION_SALES'
ORDER  BY partition_position;

-- 새로운 LIST 값에 대한 파티션 추가
ALTER TABLE region_sales
ADD PARTITION region_jeju
VALUES ('JEJU');

-- DEFAULT 파티션 추가 (정의되지 않은 모든 값 처리)
-- ※ DEFAULT 파티션은 테이블에 파티션이 하나뿐일 때 또는 처음 생성 시 추가하는 것을 권장
ALTER TABLE region_sales
ADD PARTITION region_default
VALUES (DEFAULT);

-- LIST 파티션 테이블 초기 생성 시 DEFAULT 포함 예시
CREATE TABLE region_sales_new (
    sale_id   NUMBER,
    region    VARCHAR2(20),
    amount    NUMBER
)
PARTITION BY LIST (region) (
    PARTITION region_seoul   VALUES ('SEOUL'),
    PARTITION region_busan   VALUES ('BUSAN'),
    PARTITION region_daegu   VALUES ('DAEGU'),
    PARTITION region_default VALUES (DEFAULT)  -- 반드시 포함
);

원인 3 해결: MAXVALUE 파티션 추가 및 NULL 처리

-- NULL 허용 RANGE 파티션 테이블에 MAXVALUE 파티션 추가
ALTER TABLE order_history
ADD PARTITION order_null_or_future
VALUES LESS THAN (MAXVALUE);

-- 또는 파티션 키 컬럼에 NOT NULL 제약 조건 추가
ALTER TABLE order_history
MODIFY (order_date NOT NULL);

-- NULL 데이터 사전 검사 후 삽입
INSERT INTO order_history (order_id, order_date, customer_id)
SELECT order_id,
       NVL(order_date, SYSDATE),  -- NULL이면 현재 날짜로 대체
       customer_id
FROM   staging_orders
WHERE  order_id NOT IN (SELECT order_id FROM order_history);
COMMIT;

에러 발생 파티션 테이블 빠른 진단 쿼리

-- 파티션 테이블의 전체 구조 및 범위 확인
SELECT t.table_name,
       t.partitioning_type,
       p.partition_name,
       p.partition_position,
       p.high_value,
       p.num_rows
FROM   user_part_tables t
JOIN   user_tab_partitions p ON t.table_name = p.table_name
WHERE  t.table_name = 'YOUR_TABLE_NAME'
ORDER  BY p.partition_position;

-- 파티션 키 컬럼 확인
SELECT name, column_name, column_position
FROM   user_part_key_columns
WHERE  name = 'YOUR_TABLE_NAME';

예방 방법

1. 파티션 테이블 설계 시 MAXVALUE / DEFAULT 파티션 항상 포함

RANGE 파티션 테이블을 설계할 때는 반드시 MAXVALUE를 마지막 파티션으로 포함하고, LIST 파티션 테이블에는 DEFAULT 파티션을 포함하십시오. 이렇게 하면 예상치 못한 값이나 범위를 벗어난 데이터가 입력되더라도 ORA-14400 에러 없이 데이터를 안전하게 수용할 수 있습니다. 또한 정기적인 파티션 모니터링 스크립트를 통해 특정 파티션에 데이터가 집중되거나 MAXVALUE 파티션으로 데이터가 유입될 경우 즉시 알림을 받을 수 있도록 구성하는 것이 좋습니다.

-- 파티션 모니터링: MAXVALUE 파티션에 데이터 유입 감지
SELECT table_name, partition_name, num_rows
FROM   user_tab_partitions
WHERE  high_value = 'MAXVALUE'
  AND  num_rows   > 0;

2. Interval 파티셔닝 또는 자동 파티션 관리 적용

Oracle 11g 이상에서는 INTERVAL 파티셔닝을 사용하면 새로운 범위의 데이터가 입력될 때 Oracle이 자동으로 파티션을 생성해 주므로 ORA-14400 에러를 근본적으로 방지할 수 있습니다. 특히 날짜 기반 파티션 테이블에서 매우 유용하며, 신규 파티션 추가 작업을 수동으로 반복할 필요가 없어 운영 부담도 크게 줄어듭니다.

-- Interval 파티셔닝 적용 예시 (월별 자동 파티션 생성)
CREATE TABLE sales_interval (
    sale_id   NUMBER,
    sale_date DATE,
    amount    NUMBER
)
PARTITION BY RANGE (sale_date)
INTERVAL (NUMTOYMINTERVAL(1, 'MONTH'))
(
    PARTITION sales_p0 VALUES LESS THAN (TO_DATE('2024-01-01', 'YYYY-MM-DD'))
);

-- 이후 어떤 날짜의 데이터를 입력해도 자동으로 파티션 생성됨
INSERT INTO sales_interval VALUES (1, TO_DATE('2026-03-15', 'YYYY-MM-DD'), 99000);
COMMIT;