데이터베이스 인플레이스 메이저 버전 업그레이드 오류

이 문서에서는 PostgreSQL용 AlloyDB에서 데이터베이스 인플레이스 메이저 버전 업그레이드를 수행할 때 발생할 수 있는 오류와 각각의 권장 해결 방법을 설명합니다. 자세한 내용은 인플레이스 메이저 버전 업그레이드 문제 해결을 참조하세요.

오류: 데이터베이스: database_name. extension_violation: DEPRECATED, action_required: DELETE_EXTENSION

설명: AlloyDB가 지원 중단된 확장 프로그램을 감지했습니다. 오류 메시지에 오류를 일으킨 확장 프로그램이 표시됩니다.

database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION."+" Query format to delete the extensions: `DROP EXTENSION {extension_name}; Violation list: [extensions]

권장 해결 방법: 해당 확장 프로그램을 삭제하세요. 확장 프로그램을 삭제하는 쿼리 형식은 DROP EXTENSION {extension_name};입니다.

오류: 데이터베이스: database_name. extension_violation: INVALID_EXTENSION_VERSION, action_required: UPGRADE_EXTENSION

설명: AlloyDB가 유효하지 않은 확장 프로그램 버전을 감지했습니다.

권장 해결 방법: 확장 프로그램을 업그레이드하세요. 확장 프로그램을 업그레이드하는 쿼리 형식은 ALTER EXTENSION {extension_name} UPDATE TO {target_version};입니다.

오류: 데이터베이스: database_name에 pg_largeobject 포함됨

설명: AlloyDB가 pg_largeobject을 감지했습니다.

권장 해결 방법: AlloyDB 클러스터를 업그레이드하기 전에 pg_largeobject를 삭제하세요.

오류: 공유 메모리 부족

설명: 인스턴스의 공유 메모리가 부족하면 이 오류 메시지가 표시될 수 있습니다. 특히 이 오류는 테이블 수가 10,000개 이상인 경우 발생할 가능성이 높습니다.

권장 해결 방법: 업그레이드를 시작하기 전에 max_locks_per_transaction 플래그 값을 인스턴스의 테이블 개수의 약 2배로 설정하세요. 이 플래그 값을 변경하면 인스턴스가 다시 시작됩니다.

오류: 연결 부족

설명: 인스턴스의 연결 용량이 부족한 경우 이 오류 메시지가 표시될 수 있습니다.

권장 해결 방법: 인스턴스에 포함된 데이터베이스 개수만큼 max_connections 플래그 값을 증가시키는 것이 좋습니다. 이 플래그 값을 변경하면 인스턴스가 다시 시작됩니다.

업그레이드 전 검사 실패

설명: AlloyDB 클러스터를 업그레이드할 때 업그레이드 전 검사로 인해 업그레이드가 실패할 수 있습니다. 위반 사항에 대한 세부정보는 API 응답의 logs_url 항목에 포함되어 있습니다. 해당 로그가 있는 Google Cloud 콘솔 페이지로 이동됩니다.

권장 해결 방법: 오류 메시지를 기반으로, 이 문서 앞부분에 나열된 다른 오류 항목을 참고하여 해당 문제를 해결하세요.

다음 단계