파라미터 호환 장애(incompatible-parameters) 상태로 멈춰 있는 Amazon RDS DB 인스턴스를 수정하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2020년 8월 28일

Amazon RDS(Amazon Relational Database Service) 인스턴스가 파라미터 호환 장애(incompatible-parameters) 상태로 멈춰 있습니다. DB 인스턴스에 연결하거나 인스턴스를 수정할 수 없습니다. 인스턴스 삭제 또는 재부팅만 가능합니다. 이 문제를 어떻게 해결해야 합니까?

간략한 설명

RDS DB 인스턴스가 파라미터 호환 장애(incompatible-parameters) 상태라면 연결된 그룹의 파라미터 중 하나 이상이 현재의 엔진 버전 또는 DB 인스턴스 클래스와 호환되지 않는 값으로 설정되어 있는 것입니다.

이 문제는 다음과 같은 원인 때문에 발생할 수 있습니다.

  • 이전 버전보다 사용 가능한 메모리가 적은 인스턴스 유형을 사용하도록 조정되는 DB 인스턴스. 연결된 파라미터 그룹의 메모리 설정 중 하나 이상이 현재 DB 인스턴스에 사용할 수 있는 메모리 크기를 초과합니다.
  • 다른 버전으로 업그레이드된 데이터베이스 엔진. 엔진은 현재 사용자 지정 파라미터 그룹의 파라미터 설정 중 하나 이상과 더 이상 호환이 되지 않습니다.

다른 파라미터 그룹을 연결하거나 DB 인스턴스 유형을 확장하거나, 엔진 버전을 변경, 또는 DB 인스턴스 구성을 수정하려고 할 경우 구성에 실패할 수 있습니다. 새 구성을 수락하려면 DB 인스턴스가 사용 가능(available) 상태여야 합니다. DB 인스턴스가 파라미터 호환 장애(incompatible-parameters) 상태인 경우에는 인스턴스 재부팅이나 삭제만 가능합니다.

호환되지 않는 값을 확인하는 방법에 대한 자세한 내용은 사용자 지정 파라미터 그룹에 속하는 Amazon RDS DB 파라미터와 기본 파라미터 그룹에 속하는 파라미터를 어떻게 식별합니까?를 참조하십시오.

​해결 방법

이 문제를 해결하기 위해서는 다음 옵션 중 하나를 사용하여 호환되지 않는 각각의 파라미터 값을 호환 가능한 값으로 변경하십시오.

  • 파라미터 그룹의 모든 파라미터를 기본값으로 재설정하십시오.
  • 호환되지 않는 파라미터의 값을 재설정하십시오.

참고: 호환되지 않는 파라미터 그룹과 연결되어 있는 모든 DB 인스턴스는 이러한 값 변경에 영향을 받게 됩니다. 현재의 파라미터 그룹 설정 내역을 백업하려면 파라미터를 재설정하기 전에 파라미터 그룹을 복사하십시오.

문제의 근본 원인을 식별하기 위해 호환되지 않는 파라미터 그룹을 복사한 다음, 사용자 지정 파라미터 값과 기본값 간의 차이를 비교할 수 있습니다.

AWS CloudTrail을 사용하여 사용자 지정 파라미터 그룹에 발생한 변경 사항을 확인할 수 있습니다. 최근 90일 이내에 ModifyDBParameterGroup 또는 ModifyDBClusterParameterGroup에 대한 이벤트 이름(Event name)을 필터링합니다.

Amazon RDS 콘솔을 사용하여 파라미터 그룹의 사본을 생성하려면

  1. Amazon RDS 콘솔을 열고 탐색 창에서 파라미터 그룹(Parameter groups)을 선택합니다.
  2. 호환되지 않는 파라미터 그룹을 선택한 다음, 파라미터 그룹 작업(Parameter group actions)을 선택합니다.
  3. 복사를 선택하십시오.

Amazon RDS 콘솔을 사용하여 파라미터 그룹의 모든 파라미터를 기본값으로 재설정하려면

  1. Amazon RDS 콘솔을 열고 탐색 창에서 파라미터 그룹(Parameter groups)을 선택합니다.
  2. 재설정하려는 파라미터 그룹을 선택합니다.
  3. 파라미터 그룹 작업을 선택한 다음, 재설정을 선택하십시오.
  4. 재설정을 선택하십시오.

Amazon RDS 콘솔을 사용하여 파라미터 값을 재설정하려면

호환되지 않는 파라미터 그룹의 모든 파라미터 값이 재설정되는 것을 막기 위해 변경하려는 파라미터를 선택할 수 있습니다. 이 작업을 수행하려면 Amazon RDS 콘솔에서 호환되지 않는 파라미터 그룹을 편집합니다.

  1. Amazon RDS 콘솔을 열고 탐색 창에서 파라미터 그룹(Parameter groups)을 선택합니다.
  2. 호환되지 않는 파라미터 그룹을 선택합니다. 모든 파라미터를 재설정하려는 경우에는 모든 파라미터를 선택합니다.
  3. 파라미터 그룹 작업(Parameter group actions)을 선택한 다음, 편집(Edit)을 선택합니다.
  4. 유효한 파라미터 값을 입력한 다음, 변경 사항 저장(Save Changes)을 선택합니다.
  5. 장애 조치 없이 DB 인스턴스를 재부팅하여 새 설정을 적용합니다.
    참고: Amazon RDS 콘솔에서는 파라미터를 관련된 허용 값으로 변경할 수 있습니다. AWS CLI(명령줄 인터페이스)를 사용할 경우 대상 파라미터를 기본값으로 재설정할 수 있습니다. AWS CLI를 사용하여 파라미터 값을 기본 파라미터 값이 아닌 다른 값으로 변경하는 것은 아무런 효과가 없습니다.

Amazon RDS와 호환되지 않는 Oracle 파라미터에 대한 자세한 내용은 Amazon RDS 기반 Oracle 12cOracle DB 인스턴스에 방대한 페이지 사용을 참조하십시오.