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

ORA-01724
2026년 07월 27일 | DBMS Error 가이드

이 글에서 다루는 내용

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

ORA-01724 floating point precision is out of range 는?

ORA-01724 에러는 Oracle 데이터베이스에서 부동소수점(FLOAT) 데이터 타입을 정의할 때 정밀도(precision) 값이 허용 범위를 벗어났을 경우 발생하는 에러입니다. Oracle의 FLOAT 타입은 이진 정밀도(binary precision)를 기준으로 1에서 126 사이의 값만 허용하는데, 이 범위를 초과하거나 0 이하의 값을 지정하면 이 에러가 발생합니다. 주로 테이블 생성, 컬럼 변경, 또는 외부 시스템에서 DDL 스크립트를 마이그레이션할 때 자주 목격되는 에러입니다.

주요 발생 원인

1. FLOAT 타입의 정밀도를 허용 범위(1~126) 밖으로 지정한 경우

Oracle의 FLOAT 데이터 타입은 내부적으로 이진 정밀도를 사용하며, 허용 가능한 값의 범위는 1 이상 126 이하입니다. 개발자가 십진수 기준의 정밀도 개념을 그대로 적용하여 127 이상의 값을 입력하거나, 실수로 0 또는 음수 값을 입력하는 경우 이 에러가 발생합니다. 특히 타 DBMS(예: MySQL, PostgreSQL)에서 Oracle로 DDL 스크립트를 변환할 때 정밀도 정의 방식이 달라 이 문제가 빈번하게 발생합니다.

2. 다른 DBMS에서 마이그레이션한 DDL 스크립트의 타입 불일치

MySQL이나 SQL Server 등에서는 FLOAT(n) 표기 시 n이 십진수 기반의 정밀도를 의미하거나 다른 범위를 허용하기도 합니다. 이러한 스크립트를 아무런 변환 없이 Oracle에 그대로 적용할 경우 ORA-01724 에러가 발생할 수 있습니다. 마이그레이션 프로젝트에서는 반드시 데이터 타입 매핑 테이블을 사전에 검토하고 Oracle 표준에 맞게 변환 작업을 수행해야 합니다.

3. 동적 DDL 생성 로직에서의 잘못된 파라미터 바인딩

애플리케이션 코드나 배치 스크립트에서 동적으로 DDL을 생성할 때, 정밀도 값을 변수로 처리하는 경우 잘못된 값이 전달되어 에러가 발생하기도 합니다. 예를 들어, 사용자 입력값을 검증 없이 DDL에 삽입하거나, 설정 파일에서 잘못된 값을 읽어오는 경우가 이에 해당합니다. 이러한 상황에서는 입력값 검증 로직이 반드시 필요하며, 범위를 초과하는 경우 사전에 적절한 기본값으로 대체하는 처리가 요구됩니다.

해결 방법

원인 1 해결: 정밀도 값을 허용 범위(1~126) 내로 수정

아래는 잘못된 정밀도로 인해 에러가 발생하는 예시와 그 수정 방법입니다.

-- 에러 발생 예시: 정밀도가 허용 범위(126)를 초과
CREATE TABLE t_financial_data (
    account_id   NUMBER(10),
    balance      FLOAT(130)   -- ORA-01724 발생! 126 초과
);

-- 수정 방법 1: 허용 범위 내의 값으로 조정
CREATE TABLE t_financial_data (
    account_id   NUMBER(10),
    balance      FLOAT(126)   -- 최대 허용 이진 정밀도
);

-- 수정 방법 2: FLOAT 대신 NUMBER 타입으로 대체 (권장)
CREATE TABLE t_financial_data (
    account_id   NUMBER(10),
    balance      NUMBER(38, 10)  -- 십진수 38자리, 소수점 이하 10자리
);

-- 수정 방법 3: 정밀도 미지정 (Oracle 기본값 사용)
CREATE TABLE t_financial_data (
    account_id   NUMBER(10),
    balance      FLOAT   -- 기본값 이진 정밀도 126 적용
);

원인 2 해결: 마이그레이션 시 데이터 타입 변환

다른 DBMS에서 가져온 스크립트를 Oracle 표준에 맞게 변환합니다.

-- MySQL 원본 DDL (예시)
-- CREATE TABLE orders (
--     order_id INT,
--     amount   FLOAT(53)   -- MySQL에서는 DOUBLE PRECISION을 의미
-- );

-- Oracle 변환 DDL
CREATE TABLE orders (
    order_id  NUMBER(10),
    amount    BINARY_DOUBLE   -- MySQL FLOAT(53) → Oracle BINARY_DOUBLE 권장
);

-- 또는 NUMBER 타입으로 안전하게 변환
CREATE TABLE orders (
    order_id  NUMBER(10),
    amount    NUMBER(20, 6)   -- 정수 14자리, 소수점 이하 6자리
);

-- FLOAT 타입 정밀도 범위 확인 쿼리
-- FLOAT(p) : p는 이진 정밀도, 1 ~ 126
-- FLOAT(1)  ≈ 십진수 1자리 정밀도
-- FLOAT(23) ≈ 십진수 7자리 정밀도  (단정밀도 부동소수점과 유사)
-- FLOAT(53) ≈ 십진수 15자리 정밀도 (배정밀도 부동소수점과 유사)
-- FLOAT(126)= 십진수 38자리 정밀도 (최대)
SELECT column_name, data_type, data_precision, data_scale
FROM   user_tab_columns
WHERE  table_name = 'ORDERS';

원인 3 해결: 동적 DDL의 파라미터 검증

-- 동적 DDL 생성 시 정밀도 값 검증 예시 (PL/SQL)
DECLARE
    v_precision   PLS_INTEGER := 130;  -- 잘못된 입력값 시뮬레이션
    v_table_name  VARCHAR2(30) := 'T_DYNAMIC_TEST';
    v_ddl         VARCHAR2(1000);
BEGIN
    -- 정밀도 값 유효성 검사
    IF v_precision < 1 OR v_precision > 126 THEN
        -- 기본값으로 대체하거나 예외 처리
        DBMS_OUTPUT.PUT_LINE('[경고] FLOAT 정밀도 값(' || v_precision ||
                             ')이 허용 범위(1~126)를 벗어났습니다. 기본값 126으로 대체합니다.');
        v_precision := 126;
    END IF;

    -- 안전한 동적 DDL 생성
    v_ddl := 'CREATE TABLE ' || v_table_name || ' ('  ||
             '  id       NUMBER(10), '                 ||
             '  val      FLOAT(' || v_precision || ')' ||
             ')';

    EXECUTE IMMEDIATE v_ddl;
    DBMS_OUTPUT.PUT_LINE('테이블 생성 성공: ' || v_table_name);

EXCEPTION
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('에러 발생: ' || SQLERRM);
END;
/

-- 기존 컬럼의 데이터 타입을 FLOAT에서 NUMBER로 변경
ALTER TABLE t_financial_data MODIFY (balance NUMBER(38, 10));

예방 방법

1. DDL 스크립트 코드 리뷰 및 타입 변환 가이드라인 수립

팀 내에서 Oracle 데이터 타입 사용 기준을 문서화하고, 가능하면 FLOAT 대신 NUMBER 또는 BINARY_DOUBLE, BINARY_FLOAT 타입을 사용하도록 코딩 표준을 정립하세요. 특히 타 DBMS에서 마이그레이션 시에는 반드시 데이터 타입 매핑 테이블을 작성하고, DDL 스크립트 적용 전에 코드 리뷰 프로세스를 거치도록 팀 규칙을 만드는 것이 중요합니다. CI/CD 파이프라인에 DDL 검증 스크립트를 포함시키면 운영 환경에 적용되기 전에 오류를 사전 차단할 수 있습니다.

2. 동적 DDL 생성 시 입력값 유효성 검증 로직 필수 적용

애플리케이션이나 배치에서 DDL을 동적으로 생성할 경우, 반드시 정밀도 값에 대한 범위 검증 로직을 포함시켜야 합니다. Oracle FLOAT의 허용 범위(1~126)를 상수로 정의하여 코드 내에서 참조하도록 하고, 범위를 벗어나는 경우 기본값으로 대체하거나 명확한 예외 메시지를 출력하여 운영자가 즉시 인지할 수 있게 하세요. 이를 통해 잘못된 파라미터로 인한 런타임 DDL 에러를 사전에 방지할 수 있습니다.