메이저 버전 업그레이드 수행

테이블에 있는 버전에 대해 나열된 대상 중 사용 가능한 대상 목록에서 원하는 메이저 버전을 선택합니다. AWS CLI를 사용하여 현재 버전에 대해 AWS 리전에서 사용할 수 있는 정확한 버전 목록을 확인할 수 있습니다. 자세한 내용은 AWS 리전에서 사용 가능한 버전 목록 가져오기 단원을 참조하세요.

새 버전의 평가판 배포에서 애플리케이션이 정상적으로 작동하는지 확인합니다. 전체 프로세스에 대한 내용은 새로운 메이저 버전으로 프로덕션 DB 클러스터 업그레이드 테스트 섹션을 참조하세요.

평가판 배포에서 애플리케이션이 정상적으로 작동하는지 확인했다면 클러스터를 업그레이드할 수 있습니다. 세부 정보는 Aurora PostgreSQL 엔진을 새로운 메이저 버전으로 업그레이드을 참조하세요.

버전 호환 파라미터 그룹을 준비합니다.

사용자 지정 DB 인스턴스 또는 DB 클러스터 파라미터 그룹을 사용하는 경우 다음 2가지 옵션이 있습니다.

업그레이드 요청의 일부로 새 DB 인스턴스 또는 DB 클러스터 파라미터 그룹을 연결하는 경우 파라미터를 적용하려면 업그레이드가 완료된 후 데이터베이스를 재부팅해야 합니다. 파라미터 그룹 변경 사항을 적용하기 위해 DB 인스턴스를 재부팅해야 하는 경우 인스턴스의 파라미터 그룹 상태가 pending-reboot로 표시됩니다. 인스턴스의 파라미터 그룹 상태는 콘솔에서 보거나 describe-db-instances 또는 describe-db-clusters 같은 CLI 명령을 사용하여 볼 수 있습니다.

지원되지 않는 사용 확인:

template1 및 template0 데이터베이스를 확인합니다.

성공적인 업그레이드를 위해서는 template1 및 template0 데이터베이스가 존재해야 하며 템플릿으로 나열되어야 합니다. 이를 확인하려면 다음 명령을 사용합니다.

SELECT datname, datistemplate FROM pg_database; 
                        
datname    | datistemplate
-----------+---------------
template0  | t
rdsadmin   | f
template1  | t
postgres   | f

명령 출력에서 template1 및 template0 데이터베이스의 datistemplate 값은 t여야 합니다.

논리적 복제 슬롯을 삭제합니다.

Aurora PostgreSQL DB 클러스터가 논리적 복제 슬롯을 사용 중인 경우 업그레이드 프로세스를 진행할 수 없습니다. 논리적 복제 슬롯은 일반적으로 AWS DMS를 사용하여 데이터를 마이그레이션하거나 데이터베이스에서 데이터 레이크, BI 도구 또는 기타 대상으로 테이블을 복제하는 것과 같은 단기 데이터 마이그레이션 작업에 사용됩니다. 업그레이드하기 전에 존재하는 논리적 복제 슬롯의 용도를 알고 삭제해도 되는지 확인합니다. 다음 쿼리를 사용하여 논리적 복제 슬롯을 확인할 수 있습니다.

SELECT * FROM pg_replication_slots;

논리적 복제 슬롯이 계속 사용 중인 경우 삭제하면 안 되며 업그레이드를 진행할 수 없습니다. 그러나 논리적 복제 슬롯이 필요하지 않은 경우 다음 SQL을 사용하여 삭제할 수 있습니다.

SELECT pg_drop_replication_slot(slot_name);

pglogical 확장을 사용하는 논리적 복제 시나리오에서도, 게시자 노드에서 메이저 버전 업그레이드가 성공하려면 이 노드에서 슬롯을 삭제해야 합니다. 하지만 업그레이드가 끝나면 구독자 노드에서 복제 프로세스를 재시작할 수 있습니다. 자세한 내용은 메이저 업그레이드 후 논리적 복제 재설정 단원을 참조하십시오.

백업을 수행합니다.

업그레이드 프로세스는 업그레이드 중에 DB 클러스터의 DB 클러스터 스냅샷을 생성합니다. 업그레이드 프로세스 전에 수동 백업을 수행하려면 DB 클러스터 스냅샷 생성 단원을 참조하십시오.

메이저 버전 업그레이드를 수행하기 전에 특정 확장을 사용 가능한 최신 버전으로 업그레이드합니다. 업데이트할 확장은 다음과 같습니다.

현재 설치된 각 확장에 대해 다음 명령을 실행합니다.

ALTER EXTENSION PostgreSQL-extension UPDATE TO 'new-version';

자세한 내용은 PostgreSQL 확장 버전 업그레이드을 참조하세요. PostGIS 업그레이드에 대한 자세한 내용은 6단계: PostGIS 확장 업그레이드를 참조하세요.

버전 11.x로 업그레이드하는 경우 메이저 버전 업그레이드를 수행하기 전에 지원되지 않는 확장을 삭제하세요. 삭제할 확장은 다음과 같습니다.

대상 버전에 따라 unknown 데이터 형식을 삭제합니다.

PostgreSQL 버전 10은 unknown 데이터 형식을 지원하지 않습니다. 버전 9.6 데이터베이스가 unknown 데이터 형식을 사용하는 경우 버전 10으로 업그레이드하면 다음과 같은 오류 메시지가 표시됩니다.

Database instance is in a state that cannot be upgraded: PreUpgrade checks failed: 
The instance could not be upgraded because the 'unknown' data type is used in user tables. 
Please remove all usages of the 'unknown' data type and try again."

이러한 열을 제거하거나 지원되는 데이터 형식으로 변경할 수 있도록 데이터베이스에서 unknown 데이터 형식을 찾으려면 각 데이터베이스에 대해 다음 SQL 코드를 사용합니다.

SELECT n.nspname, c.relname, a.attname
    FROM pg_catalog.pg_class c,
    pg_catalog.pg_namespace n,
    pg_catalog.pg_attribute a
    WHERE c.oid = a.attrelid AND NOT a.attisdropped AND
    a.atttypid = 'pg_catalog.unknown'::pg_catalog.regtype AND
    c.relkind IN ('r','m','c') AND
    c.relnamespace = n.oid AND
    n.nspname !~ '^pg_temp_' AND
    n.nspname !~ '^pg_toast_temp_' AND n.nspname NOT IN ('pg_catalog', 'information_schema');

업그레이드 모의 실습을 수행합니다.

프로덕션 데이터베이스에서 업그레이드를 수행하기 전에 프로덕션 데이터베이스의 복제본에서 메이저 버전 업그레이드를 테스트하는 것이 좋습니다. 중복 테스트 인스턴스의 실행 계획을 모니터링하여 실행 계획 회귀가 발생할 수 있는지 확인하고 성능을 평가할 수 있습니다. 중복 테스트 인스턴스를 생성하려면 최근 스냅샷에서 데이터베이스를 복원하거나 데이터베이스를 복제합니다. 자세한 내용은 스냅샷에서 복원 또는 Aurora DB 클러스터에 대한 볼륨 복제 섹션을 참조하세요.

자세한 내용은 Aurora PostgreSQL 엔진을 새로운 메이저 버전으로 업그레이드 섹션을 참조하세요.

프로덕션 인스턴스를 업그레이드합니다.

메이저 버전 업그레이드의 모의 실습이 성공한 경우 확신을 가지고 프로덕션 데이터베이스를 업그레이드해도 됩니다. 자세한 내용은 Aurora PostgreSQL 엔진을 새로운 메이저 버전으로 업그레이드을 참조하세요.

진행 중인 업그레이드에 대한 자세한 내용은 Amazon RDS를 사용하여 pg_upgrade 유틸리티가 생성하는 두 개의 로그를 볼 수 있습니다. 이러한 로그는 pg_upgrade_internal.log 및 pg_upgrade_server.log입니다. Amazon Aurora는 이러한 로그의 파일 이름에 타임스탬프를 추가합니다. 다른 로그와 마찬가지로 이러한 로그를 볼 수 있습니다. 자세한 내용은 Amazon Aurora 로그 파일 모니터링 섹션을 참조하세요.

PostgreSQL 확장을 업그레이드합니다. PostgreSQL 업그레이드 프로세스는 PostgreSQL 확장을 업그레이드하지 않습니다. 자세한 내용은 PostgreSQL 확장 버전 업그레이드 단원을 참조하십시오.