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

ORA-02097
2026년 08월 11일 | DBMS Error 가이드

이 글에서 다루는 내용

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

ORA-02097 parameter cannot be modified because specified value is invalid 는?

ORA-02097 에러는 Oracle 데이터베이스의 초기화 파라미터(initialization parameter)를 변경하려 할 때, 지정한 값이 유효하지 않거나 다른 파라미터와의 의존 관계를 위반하는 경우 발생합니다. 단순히 값의 형식이 틀린 것이 아니라, 해당 파라미터가 허용하는 범위나 조건을 충족하지 못할 때 Oracle 엔진이 이 에러를 반환합니다. 주로 ALTER SYSTEM SET 또는 ALTER SESSION SET 명령을 통해 파라미터를 동적으로 변경하는 실무 환경에서 자주 마주치게 되는 에러입니다.

주요 발생 원인

1. 파라미터 값이 허용 범위를 벗어난 경우

Oracle의 각 파라미터에는 허용되는 최솟값과 최댓값, 혹은 특정 열거형(enumeration) 값만 지정할 수 있는 제약이 있습니다. 예를 들어 DB_CACHE_SIZE를 0으로 설정하거나, OPTIMIZER_MODE에 존재하지 않는 모드명을 입력하면 이 에러가 발생합니다. 이 경우 Oracle은 내부 검증(validation) 단계에서 파라미터 적용 자체를 거부합니다.

2. 다른 파라미터와의 의존 관계(dependency) 위반

Oracle 파라미터 중 일부는 다른 파라미터의 값에 종속되어 있습니다. 예를 들어 SGA_TARGET이 이미 설정된 상태에서 DB_CACHE_SIZE를 SGA_TARGET보다 크게 설정하려 하면 충돌이 발생합니다. 또한 MEMORY_TARGET이 활성화된 환경에서 SGA_MAX_SIZE를 별도로 조정하려 할 때도 이 에러가 트리거될 수 있습니다.

3. 동적 변경이 불가능한 파라미터를 런타임에서 변경 시도

일부 파라미터는 SCOPE=MEMORY로 동적 변경이 지원되지 않으며, 반드시 SCOPE=SPFILE로만 변경 후 재기동해야 합니다. 이를 무시하고 ALTER SYSTEM SET ... SCOPE=MEMORY로 변경하려 하면 ORA-02097과 함께 ORA-02095가 연달아 발생할 수 있습니다. 특히 DB_BLOCK_SIZE와 같은 정적(static) 파라미터가 대표적인 예입니다.

해결 방법

원인 1: 파라미터 허용 범위 확인 및 수정

먼저 V$PARAMETER 뷰를 조회하여 파라미터의 현재 값, 타입, 변경 가능 여부를 확인합니다.

-- 파라미터 상세 정보 조회
SELECT name,
       value,
       description,
       ismodified,
       isadjusted,
       type
FROM   v$parameter
WHERE  name = 'optimizer_mode';

-- 잘못된 예 (ORA-02097 발생)
ALTER SYSTEM SET optimizer_mode = 'INVALID_MODE';

-- 올바른 예 (허용된 값 사용)
ALTER SYSTEM SET optimizer_mode = 'ALL_ROWS' SCOPE=BOTH;

TYPE 컬럼 값은 1=Boolean, 2=String, 3=Integer, 4=Parameter file, 5=Reserved, 6=Big integer를 의미하므로, 해당 타입에 맞는 값을 지정해야 합니다.

원인 2: 파라미터 의존 관계 해소

SGA 관련 파라미터를 변경하기 전에 반드시 현재 메모리 구성 전체를 확인합니다.

-- 현재 SGA 관련 파라미터 전체 확인
SELECT name, value, description
FROM   v$parameter
WHERE  name IN ('sga_target', 'sga_max_size', 'db_cache_size',
                'shared_pool_size', 'memory_target', 'memory_max_target')
ORDER BY name;

-- 잘못된 예: SGA_TARGET=2G인 상태에서 DB_CACHE_SIZE를 3G로 설정 시도
-- ORA-02097 발생 가능
ALTER SYSTEM SET db_cache_size = 3G SCOPE=BOTH;

-- 올바른 순서: SGA_TARGET을 먼저 충분히 늘린 후 개별 컴포넌트 조정
ALTER SYSTEM SET sga_target = 6G SCOPE=BOTH;
ALTER SYSTEM SET db_cache_size = 3G SCOPE=BOTH;

-- MEMORY_TARGET 환경에서는 아래와 같이 전체 메모리 관리 파라미터를 우선 확인
SELECT name, value
FROM   v$parameter
WHERE  name LIKE 'memory%'
ORDER BY name;

원인 3: 정적 파라미터는 SPFILE로만 변경

-- 해당 파라미터가 동적 변경 가능한지 먼저 확인
SELECT name,
       value,
       DECODE(isses_modifiable, 'TRUE', 'Session 변경 가능', 'Session 변경 불가') AS session_mod,
       DECODE(issys_modifiable,
              'IMMEDIATE', 'System 즉시 변경 가능',
              'DEFERRED',  'System 지연 변경 가능',
              'FALSE',     'System 변경 불가 (재기동 필요)') AS system_mod
FROM   v$parameter
WHERE  name = 'db_block_size';

-- 정적 파라미터는 반드시 SPFILE로만 변경 (재기동 후 적용)
ALTER SYSTEM SET db_block_size = 16384 SCOPE=SPFILE;

-- 변경 후 SPFILE 내용 확인
SELECT name, value, display_value
FROM   v$spparameter
WHERE  name = 'db_block_size';

-- 현재 SPFILE 사용 여부 확인
SELECT value FROM v$parameter WHERE name = 'spfile';

SPFILE이 존재하지 않는 환경이라면 CREATE SPFILE FROM PFILE로 먼저 SPFILE을 생성해야 합니다.

-- PFILE에서 SPFILE 생성
CREATE SPFILE = '/u01/app/oracle/dbs/spfileORCL.ora'
FROM   PFILE  = '/u01/app/oracle/dbs/initORCL.ora';

예방 방법

1. 파라미터 변경 전 반드시 V$PARAMETER와 공식 문서를 통한 사전 검증

운영 환경에서 파라미터를 변경하기 전에는 반드시 V$PARAMETER, V$PARAMETER2, V$SPPARAMETER 뷰를 활용하여 현재 값과 변경 가능 여부를 확인하는 습관을 들여야 합니다. 또한 Oracle 공식 문서(Database Reference)에서 해당 파라미터의 허용 범위, 의존 파라미터, 변경 가능 범위(SCOPE)를 사전에 반드시 검토하여 예기치 않은 장애를 예방해야 합니다.

-- 변경 예정 파라미터 사전 점검 쿼리 (표준 운영 절차로 활용 권장)
SELECT p.name,
       p.value          AS current_value,
       p.description,
       p.isses_modifiable,
       p.issys_modifiable,
       p.isinstance_modifiable,
       p.ismodified,
       p.isadjusted,
       sp.value         AS spfile_value
FROM   v$parameter  p
LEFT JOIN v$spparameter sp ON sp.name = p.name
WHERE  p.name = :param_name;

2. 변경 작업은 반드시 테스트 환경 선행 적용 및 변경 전 백업

운영 데이터베이스에서 파라미터를 변경하기 전에는 동일한 버전의 테스트 환경에서 먼저 적용하여 사이드 이펙트를 검증해야 합니다. 또한 변경 전에 현재 SPFILE을 PFILE로 백업해두면, 문제 발생 시 신속하게 롤백할 수 있습니다.

-- 변경 전 현재 파라미터 전체 백업 (PFILE로 저장)
CREATE PFILE = '/backup/pfile_backup_20240101.ora' FROM SPFILE;