새 주 버전으로 업그레이드

업그레이드 경로를 선택하세요:

마지막 두 경로의 경우, 새 배포 환경은 승격 후 또는 백업 후에 소스 환경에 반영된 변경 사항을 수신하지 않습니다. 먼저 새 버전을 테스트하고 검증하십시오. 최종 전환을 수행하기 전에 소스에 대한 쓰기 작업을 중지하십시오. 그런 다음, 복제본을 승격하거나 백업을 생성한 후, 애플리케이션의 연결 정보를 새로운 배포 환경으로 변경하십시오.

카탈로그에서 신규 배포에 사용할 수 있는 버전을 찾아보세요. ibmcloud cdb deployables-show/deployables API 를 통해 확인할 수 있습니다.

API 예제에서 {region} 은 배포의 리전으로, {id} 은 배포의 URL 인코딩된 클라우드 리소스 이름(CRN)으로, <IAM_TOKEN> 은 사용자의 Identity and Access Management (IAM) 액세스 토큰으로 각각 대체하십시오.

업그레이드 요건

애플리케이션 호환성

본격적인 운영에 들어가기 전에, 대표성 있는 스테이징 환경에서 선택한 업그레이드 경로를 테스트해 보십시오. IPMVU 리허설을 위해, 최근 백업본을 소스 PostgreSQL 버전으로 복원하십시오. 한 배포 구성에는 두 개 또는 세 개의 데이터 구성 요소가 포함됩니다. 즉, 주 구성 요소와 하나 또는 두 개의 고가용성(HA) 구성 요소입니다. 복구된 배포 환경을 프로덕션 환경과 동일한 수의 구성원으로 확장하십시오. HA 구성원이 많을수록 변환 단계에 더 많은 시간이 소요되기 때문입니다. 복원된 배포 환경에 백업이 정상적으로 완료되었는지 확인한 다음, 이를 원하는 대상 버전으로 업그레이드하십시오. 애플리케이션 쿼리, 백그라운드 작업, 드라이버, 확장 기능 및 연결 풀을 확인하십시오. 나중에 비교할 수 있도록 성능과 애플리케이션에서 읽기 전용 오류 및 연결 실패가 발생하는 시간을 기록해 두세요.

현재 소스 버전 이후부터 목표 버전까지(목표 버전 포함)의 모든 주요 버전에 대한 릴리스 노트를 검토하십시오. 또한 역할별 권한 변경 사항도 검토하십시오.

이 업그레이드에서는 커밋 타임스탬프가 유지되지 않습니다. 업그레이드 후, pg_xact_commit_timestamp() 는 업그레이드 전에 커밋된 모든 트랜잭션에 대해 NULL 를 반환합니다. 애플리케이션에서 커밋 타임스탬프를 읽는 경우, 업그레이드하기 전에 필요한 값을 테이블의 열에 복사해 두십시오.

확장 기능 및 기타 객체

업그레이드하기 전에 다음 섹션에 명시된 해당 준비 작업을 완료하십시오. IPMVU의 경우, 업그레이드할 배포 환경을 준비하십시오. 읽기 전용 복제본 및 복원 경로의 경우, 복제본을 생성하거나 백업을 수행하기 전에 소스 배포 환경을 준비하십시오. 읽기 전용 복제본은 변경할 수 없으며, 복원 작업 시 동일한 작업 내에서 데이터가 업그레이드됩니다. 제거할 객체에 대한 애플리케이션의 종속성을 미리 고려하십시오.

확장기능

pg_repack

pg_repack 업그레이드를 차단하지 않습니다. 업그레이드 전이나 후에 이를 삭제하거나 다시 생성할 필요는 없습니다.

old_snapshot

해당 old_snapshot 이 모듈은 PostgreSQL 17 및 이후 버전에서는 사용할 수 없습니다. PostgreSQL 16 또는 그 이전 버전에서 PostgreSQL 17 또는 그 이후 버전으로 업그레이드할 때, IPMVU는 읽기 전용 모드가 시작되기 전에 각 데이터베이스에서 old_snapshot 를 제거합니다. old_snapshot 에 의존하는 객체가 하나라도 있으면 업그레이드가 실패합니다. 나중에 업그레이드가 실패하더라도 제거 작업은 되돌려지지 않습니다.

old_snapshot 이 어떤 데이터베이스에든 설치되어 있는 경우, 업그레이드하기 전에 지원팀에 문의하여 종속 객체를 확인하십시오. 그 외의 업그레이드 경로의 경우, 지원팀에 문의하여 제거 절차를 진행해 주십시오.

anon

anon 버전 2가 설치된 경우, 해당 버전이 설치된 각 데이터베이스에서 다음 단계를 수행하십시오. admin 와 같이, 마스킹된 테이블의 소유자 권한으로 해당 쿼리를 실행하십시오. IPMVU의 경우, ‘ anon ’ 버전 2에서는 변환 단계 중에 데이터베이스를 사용할 수 없는 상태에서 업그레이드가 실패하며, 재시도할 때마다 동일한 방식으로 실패합니다. 반면 ‘ anon ’ 버전 3에서는 이러한 단계가 필요하지 않습니다. 자가 진단 쿼리 10은 extversion 에서 설치된 버전을 보여줍니다.

마스크 규칙을 제거하기 전에, 마스크된 데이터만 볼 수 있어야 하는 마스크된 역할에 대한 데이터베이스 액세스를 차단하십시오. 업그레이드 후 마스킹 규칙과 역할 레이블을 복원하고 확인하기 전까지는 해당 사용자의 접근 권한을 차단된 상태로 유지하십시오.

  1. 업그레이드 후에도 복원할 수 있도록 마스킹 규칙과 마스킹된 역할을 기록해 두십시오.

    SELECT objtype, objname, label
    FROM pg_catalog.pg_seclabels
    WHERE provider = 'anon';
    
  2. 모든 마스킹 규칙을 제거하십시오.

    SELECT anon.remove_masks_for_all_columns();
    
  3. 1단계에 나열된 각 역할에서 가려진 레이블을 제거하세요. PostgreSQL 16 및 이후 버전에서는 이 작업을 수행하려면 역할에 ‘ ADMIN ’ 옵션이 설정되어 있어야 합니다. 자세한 내용은 ‘버전 업그레이드 시 발생하는 역할 권한 문제’를 참조하십시오.

    SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
    
  4. anon 확장자를 캐스케이드 옵션과 함께 삭제합니다. cascade 옵션은 마스킹 뷰 및 함수와 같이 anon``에 의존하는 객체들도 함께 삭제합니다. 업그레이드 후에도 다시 설정할 수 있도록 해당 정의들을 기록해 두십시오.

    DROP EXTENSION anon CASCADE;
    
  5. 업그레이드 후에는 ‘ anon ’을 다시 활성화하고, 기록된 마스킹 규칙과 역할 레이블을 다시 적용한 다음, 마스킹된 역할에 대한 액세스 권한을 복원하기 전에 마스킹이 제대로 적용되었는지 확인하십시오.

PostGIS

PostGIS, 를 사용하는 경우, 업그레이드하기 전에 이를 사용하는 각 데이터베이스에서 먼저 업그레이드해야 합니다. PostgreSQL:

SELECT postgis_extensions_upgrade();

확장 프로그램 버전을 확인하십시오:

SELECT postgis_full_version();
earthdistance

인덱스나 저장된 생성 열이 ll_to_earth() 와 같이 earthdistance 버전 1.1 의 함수를 사용하는 경우, 변환 단계에서 IPMVU가 실패합니다. 객체가 사용자 정의 SQL 함수를 통해 이를 사용하는 경우에도 마찬가지입니다. PostgreSQL 14와 15에서는 버전 1.1 만 제공됩니다. 각 데이터베이스에서 자체 확인 쿼리 13을 실행하여 확인한 후, 나열된 각 객체를 처리하십시오:

  • PostgreSQL 16 또는 17의 경우, 업그레이드하기 전에 확장 프로그램을 업데이트하십시오:

    ALTER EXTENSION earthdistance UPDATE;
    
  • PostgreSQL 14 또는 15에서, used_function 가 사용자 정의 함수 중 하나라면, 해당 함수에 search_path 설정을 추가하십시오:

    ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog;
    
  • PostgreSQL 14 또는 15에서, used_function 가 earthdistance 함수인 경우, 업그레이드하기 전에 나열된 인덱스를 삭제하십시오. 생성된 열에 포함된 값을 유지하려면, ALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;``을 사용하여 해당 열을 일반 열로 변환하십시오. 업그레이드가 완료된 후 ALTER EXTENSION earthdistance UPDATE; 를 실행한 다음, 삭제했던 항목을 다시 생성하십시오. 대상 버전이 PostgreSQL 15인 경우, 이 업데이트는 아무런 효과가 없으며, 다시 생성된 객체들로 인해 동일한 방식으로 다음 업그레이드가 차단됩니다. 이러한 문제를 방지하려면 ‘ PostgreSQL ’ 16 이상 버전으로 업그레이드하십시오.

pgRouting

배포 환경에서 ‘ PostgreSQL ’ 16 또는 17을 실행 중이며 ‘ PostgreSQL ’ 18로 업그레이드하는 경우, ‘ pgRouting ’이 설치된 각 데이터베이스를 확인하십시오. PostgreSQL 18개의 배포에는 pgRouting 3.5 라이브러리가 포함되어 있지 않습니다. PostgreSQL 18용 IPMVU는 읽기 전용 모드가 시작되기 전에, 해당 라이브러리를 사용하는 함수가 실행되는 동안 호환성 검사에서 실패합니다. 논란은 없을 것으로 예상됩니다:

SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';

쿼리 결과가 행 하나를 반환하면, 업그레이드하기 전에 배포 환경에서 제공하는 최신 버전으로 pgRouting 업데이트한 후 쿼리를 다시 실행하십시오:

ALTER EXTENSION pgrouting UPDATE;

pgRouting 4.0 버전에서는 pgr_createTopology, pgr_analyzeGraph, 및 과 같은 여러 기능이 제거되었으며 pgr_nodeNetwork, 다른 기능들은 변경되었습니다. 먼저 스테이징 환경에 pgRouting 4.0 을 적용하여 애플리케이션을 테스트해 보십시오. 제거된 기능이 필요한 경우, PostgreSQL 18로 업그레이드하기 전에 지원팀에 문의하십시오. PostgreSQL 16부터는 3.5 라이브러리가 포함된 PostgreSQL 17로 업그레이드할 수도 있습니다.

인덱스, 파티션 키 및 생성된 열에서의 SQL 함수

변환 단계에서 IPMVU는 모든 인덱스, 파티션 키 및 저장된 생성 열의 정의를 검색 경로가 비어 있는 상태로 다시 생성합니다. 이 단계는 해당 객체 중 하나가 LANGUAGE sql 함수를 사용하면서, 문자열 본문에 스키마를 명시하지 않은 채 pg_catalog 외부의 객체 이름을 직접 또는 도메인 검사 제약 조건을 통해 참조하는 경우 실패합니다. 확장 통계는 외래 키가 있는 테이블에 대해서도 동일한 효과를 발휘합니다. 인덱스에서, 확장 기능이 설치된 ‘ ibm_extension ’ 스키마를 지정하는 호출도 실패합니다. 이 오류는 데이터베이스를 사용할 수 없는 상태에서 발생하며, 재시도할 때마다 동일한 방식으로 실패합니다.

각 데이터베이스에서 자체 점검 쿼리 12를 실행하십시오. 나열된 각 함수에 대해, 해당 함수 본문에서 사용하는 모든 스키마의 이름을 명시하는 ‘ search_path ’ 설정을 추가하십시오. 또는 해당 문자열 본문을 SQL 표준 본문으로 대체하십시오. 이 문장들을 함수의 소유자 권한으로 실행하십시오. 예를 들어, 다음과 같습니다.

ALTER FUNCTION f_unaccent(text) SET search_path = ibm_extension, pg_catalog;
CREATE OR REPLACE FUNCTION f_unaccent(text) RETURNS text
  LANGUAGE sql IMMUTABLE PARALLEL SAFE STRICT
  RETURN ibm_extension.unaccent('ibm_extension.unaccent', $1);

각 함수의 결과 및 기타 속성은 변경하지 마십시오. 인덱스와 생성된 열에는 해당 함수의 결과가 저장되며, 파티션된 테이블은 이를 기반으로 행을 라우팅하기 때문입니다. search_path 가 설정된 경우, PostgreSQL 는 더 이상 해당 함수를 호출하는 쿼리 내에서 함수를 확장하지 않으므로, 해당 쿼리의 실행 속도가 느려질 수 있습니다. SQL 표준 기구는 자신이 호출하는 문자열 본문 함수를 보호하지 않으므로, 해당 함수들도 수정해야 합니다. 행이 하나도 반환되지 않을 때까지 쿼리를 다시 실행하십시오. 자신이 소유하지 않은 기능이 나열되어 있다면, 업그레이드하기 전에 지원팀에 문의하십시오.

PostgreSQL 16 또는 그 이전 버전에서 PostgreSQL 17 또는 그 이후 버전으로 업그레이드하는 경우, 자체 점검 쿼리 17도 실행하십시오. PostgreSQL 17 버전부터는 검색 경로가 제한된 상태에서 유지 관리 명령을 실행합니다. 인덱스, 구체화된 뷰 또는 확장 통계가 사용하는 모든 언어의 함수에는 해당 함수 고유의 ‘ search_path ’ 설정이 필요합니다. 그렇지 않으면, 업그레이드 후 ANALYZE, REINDEX, CLUSTER, VACUUM FULL 및 REFRESH MATERIALIZED VIEW 에서 해당 개체에 대한 작업이 실패합니다. 이전 예제와 마찬가지로, 스키마를 생략하고 객체의 이름을 지정하는 나열된 각 함수의 검색 경로를 설정하십시오. 자세한 내용은 ‘ PostgreSQL 17’ 마이그레이션 안내서를 참조하십시오.

제거된 시스템 이름을 사용하는 객체

각 주요 버전에서는 일부 시스템 카탈로그 열, 함수 및 구성 매개변수가 제거되거나 이름이 변경됩니다. 예를 들어, PostgreSQL 17에서는 pg_stat_bgwriter 에서 체크포인트 열이 제거되었으며, PostgreSQL 16에서는 force_parallel_mode 매개변수의 이름이 debug_parallel_query 로 변경되었습니다. 사전 검사에서는 다음 이름을 사용하는 객체를 감지하지 못합니다:

  • 뷰, 구체화된 뷰 또는 집계에서 삭제된 이름을 사용하는 경우, 변환 단계에서 IPMVU가 실패합니다. SQL 표준에 부합하는 본문을 가진 함수와, 제거된 매개변수를 가진 함수, 역할 또는 데이터베이스 설정은 동일한 효과를 나타냅니다.
  • 제거된 이름을 사용하는 기타 함수 및 프로시저, pg_cron 작업, 그리고 애플리케이션 쿼리는 새 버전에서 처음 실행될 때 실패합니다. 이는 쓰기 작업이 재개되기 전에 발생할 수 있습니다.

각 데이터베이스에서 자체 점검 쿼리 14를 실행하십시오. removed_in 버전이 대상 버전 이하인 나열된 각 개체를 변경하거나 삭제합니다. 자체 점검 쿼리 7을 사용하여 역할 및 데이터베이스 설정을 확인하십시오. 대상 버전의 스테이징 배포 환경에서 애플리케이션 및 모니터링 쿼리를 테스트해 보십시오.

논리적 복제 슬롯

IPMVU는 비활성 슬롯이나 ‘ wal2json ’에서 사용하는 슬롯을 포함하여 논리적 복제 슬롯이 하나라도 존재하는 경우 사전 검사에서 실패합니다. 삭제된 슬롯은 복구할 수 없으며, 새 슬롯에는 기존 슬롯에 저장되어 있던 변경 사항이 반영되지 않습니다. 업그레이드하기 전에:

  1. 각 슬롯의 이름, 플러그인, 데이터베이스를 자체 점검 쿼리 2를 사용하여 기록하십시오.

  2. 업그레이드 후 소비자(consumer)를 복원하거나 다운스트림 데이터를 재동기화할 계획이 있을 때까지 소스 쓰기 작업을 일시 중지하십시오.

  3. 소비자가 보류 중인 변경 사항을 처리할 수 있도록 한 다음, 이를 중지하십시오. 작업 상태가 ‘완료’로 표시될 때까지 자동 재연결 기능을 끄고 중단된 상태를 유지하십시오.

  4. ibmcloud cdb postgresql replication-slot-delete 명령어나 논리적 복제 슬롯 삭제 API를 사용하여 각 슬롯을 삭제하십시오. admin 사용자는 SQL을 사용하여 복제 슬롯을 삭제할 수 없습니다.

    ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME>
    
  5. 업그레이드 후에는 ‘ wal2json 구성 ’에 설명된 대로 슬롯을 다시 생성하십시오.

wal2json 이는 논리적 디코딩 출력 플러그인이며, CREATE EXTENSION 를 통해 생성하는 확장 기능이 아닙니다.

논리적 구독

논리적 구독은 발행자로부터 변경 사항을 수신합니다. 이 슬롯의 복제 위치는 게시자 측에 있으므로, 슬롯 쿼리 결과에는 이 슬롯이 표시되지 않습니다.

배포 환경에서 ‘ PostgreSQL ’ 16 또는 그 이전 버전을 실행 중인 경우, 비활성화된 구독을 포함하여 논리적 구독이 하나라도 존재하는 한 IPMVU의 사전 검사에서 오류가 발생합니다. 이 버전들에서 업그레이드할 경우, 구독의 동기화 상태가 유지되지 않습니다. 업그레이드하기 전에, 발행사 담당자와 각 구독을 해지하고 다시 생성하는 방법, 그리고 데이터를 다시 동기화하는 방법에 대해 협의하십시오. 그런 다음, 구독자 기능을 사용하여 구독을 삭제하십시오. delete_subscription 함수는 또한 퍼블리셔에서 해당 구독의 슬롯을 해제하며, 퍼블리셔에 연결할 수 없거나 슬롯이 더 이상 존재하지 않는 경우 실패합니다. 그렇다면, disable_subscription 을 실행한 다음, delete_subscription 을 실행하기 전에 subscription_slot_none 을 실행하십시오. 그런 다음, 퍼블리셔에 트랜잭션 로그가 계속 남아 있게 되므로 퍼블리셔 소유자에게 해당 슬롯을 삭제해 달라고 요청하십시오.

배포 환경에서 PostgreSQL 17 이상 버전을 실행하는 경우, 구독은 그대로 유지될 수 있지만 대상 버전의 논리적 복제 업그레이드 요구 사항을 충족해야 합니다. 이번 업그레이드에서는 최대 10개의 구독을 지원합니다. 값이 더 크면, 읽기 전용 모드가 시작되기 전에 호환성 검사에서 실패합니다. 업그레이드하기 전에 disable_subscription 에서 구독을 비활성화하고, 업그레이드가 완료된 후 enable_subscription 에서 구독을 활성화하십시오.

UNLOGGED 테이블과 시퀀스

PostgreSQL UNLOGGED 테이블 및 시퀀스에 대한 변경 사항을 트랜잭션 로그에 기록하지 않습니다. 다른 구성원에게는 이를 복제하지 않으며, 장애 조치나 복원 후에는 해당 설정이 초기화됩니다. 어떤 업그레이드 경로에서도 기존 내용이 유지되지 않습니다:

  • IPMVU는 새 버전의 PostgreSQL 를 다시 시작할 때, 그리고 완료 단계에서 주 역할로 전환할 때 해당 설정을 재설정합니다. 업그레이드가 실패하면 이 설정들이 초기화될 수도 있습니다.
  • 승격된 읽기 전용 복제본과 복원된 백업은 ‘ UNLOGGED ’ 테이블이 비어 있는 상태로 시작되며, ‘ UNLOGGED ’ 시퀀스가 초기화된 상태로 시작됩니다.

업그레이드 후, UNLOGGED 테이블은 비어 있으며 UNLOGGED 시퀀스는 초기화됩니다. 작업 상태가 ‘완료’로 표시되기 전까지는, 해당 개체에 가한 모든 변경 사항도 사라질 수 있습니다. 업그레이드하기 전에, 자체 점검 쿼리 11을 사용하여 각 데이터베이스에서 이러한 개체를 파악하고, 각각을 어떻게 처리할지 계획을 세우십시오.

  • 테이블의 내용을 유지하려면 ALTER TABLE <table_name> SET LOGGED;``을 사용하여 변환하십시오. SET LOGGED 은 테이블의 인덱스와 해당 테이블이 소유한 시퀀스도 함께 변환합니다. 외래 키를 통해 참조하는 테이블을 변환하기 전에, 참조 대상인 테이블을 먼저 변환하십시오. 또는 내용을 내보낸 다음, 작업 상태가 ‘완료’로 표시된 후에 다시 불러오세요.
  • 시퀀스가 로깅된 테이블에 대한 값을 생성하는 경우, ALTER SEQUENCE <sequence_name> SET LOGGED;``를 사용하여 변환하십시오. 그렇지 않다면, 해당 작업이 ‘완료’로 표시될 때까지 이를 사용하는 애플리케이션을 중지하십시오. 그런 다음, setval 함수를 사용하여 현재 사용 중인 최대 값보다 큰 값으로 설정하십시오.

SET LOGGED 테이블을 다시 작성하며, 작업이 완료될 때까지 읽기 및 쓰기 작업을 차단합니다. 또한 테이블과 해당 인덱스가 차지하는 공간만큼의 트랜잭션 로그 데이터를 생성합니다. 업그레이드를 제출하기 훨씬 전에 대용량 테이블을 변환하고, 자체 점검 쿼리 5를 사용하여 트랜잭션 로그가 아카이브되었는지 확인하십시오. 업그레이드 후에는 ALTER TABLE <table_name> SET UNLOGGED;`` 명령어를 사용하여 테이블을 원래 상태로 되돌릴 수 있습니다.

IPMVU의 경우, UNLOGGED 테이블이 비어 있더라도 서비스가 모든 HA 구성원을 재구축하게 되어, 쓰기 작업이 차단되는 시간이 길어집니다. 자세한 내용은 ‘업그레이드 중 가용성’을 참조하십시오. 이러한 재구성을 방지하려면 모든 UNLOGGED 테이블을 변환하거나 더 이상 필요하지 않은 테이블을 삭제하십시오. TRUNCATE 은 재구성을 방지하지 않습니다. UNLOGGED 시퀀스는 재구성을 유발하지 않습니다. PostgreSQL 의 16 및 17 버전에서, SET LOGGED 명령어 자체는 재구축을 유발할 수 있는 대량 작업이므로, 이에 대비하여 계획을 세워야 합니다.

현행 환경에서 주요 버전 업그레이드

준비를 모두 마친 후, 아래의 UI, API, CLI 또는 Terraform 절차를 따르십시오.

IPMVU 환경에서는 서비스가 주 노드를 그 자리에서 업그레이드하고, 각 HA 구성원을 기존 데이터 파일에서 업그레이드합니다. 모든 HA 구성원이 데이터 파일을 재사용할 수 있는 경우, 쓰기 작업은 잠시만 차단됩니다. 소요 시간은 저장된 데이터의 양보다는 주로 데이터베이스 객체의 수와 데이터베이스 활동 수준에 따라 달라집니다.

일부 상황에서는 서비스가 데이터베이스 전체를 HA 구성원들에게 복사하게 되는데, 이로 인해 쓰기 작업이 훨씬 더 오랫동안 차단됩니다. 쓰기 작업이 차단된 후 다른 조건들로 인해 업그레이드가 실패합니다. 사전 검사에서는 이러한 문제를 감지하지 못하므로, 업그레이드를 제출하기 전에 이를 해결하십시오. 목록을 보려면 ‘사전 검사에서 감지하지 못하는 조건’을 참조하십시오.

IPMVU를 제출한 후에는 취소할 수 없으며, 배포된 상태를 하향 조정할 수도 없습니다. 이 서비스는 업그레이드 전에 데이터 백업을 수행하지 않으므로, 먼저 수동 백업을 생성하고 확인하십시오.

업그레이드 중 가용성

IPMVU는 다음 단계에 따라 실행됩니다. 읽기 전용 단계가 시작되면 쓰기 작업이 중단되며, 서비스가 읽기 전용 모드를 해제하면 다시 재개됩니다. 변환 단계에서는 읽기 작업도 사용할 수 없습니다.

IPMVU 단계 및 가용성
단계 무슨 일이 일어날까요? 읽기 쓰기
검사 이 서비스는 진행 중인 배포 변경 사항이 완료될 때까지 기다린 후 사전 검사를 실행합니다. 이 기능은 주 노드와 HA 구성원의 업그레이드 호환성을 확인하고, 자동 장애 조치 기능을 일시 중지합니다. 사용 가능 사용 가능
읽기 전용 이 서비스는 모든 데이터베이스에서 새로운 트랜잭션을 읽기 전용으로 설정하고 모든 클라이언트 세션을 종료합니다. 그런 다음 HA 구성원들과 트랜잭션 로그 아카이빙이 따라잡을 때까지 대기합니다. 사용 가능 차단됨
변환 이 서비스는 모든 노드의 PostgreSQL 서비스를 중지하고 주 노드를 업그레이드합니다. 가능한 경우, 각 HA 구성원을 해당 구성원의 기존 데이터 파일을 기반으로 업그레이드합니다. 사용 불가능 사용 불가능
다시 시작 업그레이드된 주 노드가 읽기 전용 모드로 시작되고, HA 구성원들이 시작됩니다. 이 서비스는 업그레이드된 주 서버의 데이터 파일을 재사용할 수 없는 모든 구성 요소를 다시 구축합니다. 사용 가능 차단됨
이력서 작성 이 서비스는 읽기 전용 모드를 해제하고 모든 클라이언트 세션을 다시 종료합니다. 사용 가능 사용 가능
완료 이 서비스는 모든 HA 구성원이 동기화될 때까지 대기합니다. 그런 다음, 서비스는 구성 요소를 하나씩 다시 시작하여 새 버전으로의 배포 이전을 완료합니다. 주 노드를 다시 시작하기 전에, 서비스는 주 노드 역할을 다른 구성원으로 전환하며, 이로 인해 클라이언트 세션이 종료됩니다. 그런 다음 이 서비스는 업그레이드 파일을 삭제하고, 업그레이드 후 백업을 대기열에 추가한 뒤, 해당 작업을 ‘완료’로 표시합니다. 전환 기간을 제외하고 이용 가능합니다 전환 기간을 제외하고 이용 가능합니다

적어도 한 명의 HA 구성원이 상태를 따라잡은 후, 나머지 HA 구성원 모두가 상태를 따라잡았거나 재구축 중인 경우 이력서를 작성합니다. 이 서비스는 데이터 파일을 재사용할 수 없는 HA 구성원을 대상으로 전체 데이터베이스를 해당 구성원으로 복사하여 재구축합니다. 모든 HA 구성원을 재구축해야 하는 경우, 첫 번째 재구축이 완료될 때까지 쓰기 작업이 차단됩니다. 대용량 데이터베이스의 경우, 이 작업에 몇 시간이 걸릴 수 있습니다. 두 개의 데이터 멤버로 구성된 배포(기본 구성)에는 HA 멤버가 하나만 있습니다. 그 결과, 재구축 작업이 발생하면 쓰기 작업이 차단됩니다. HA 회원은 다음과 같은 상황에서는 자신의 데이터 파일을 재사용할 수 없습니다:

  • 모든 데이터베이스에는 ‘ UNLOGGED ’ 테이블이 포함되어 있으며, 비어 있는 테이블도 예외는 아닙니다. 그런 다음 이 서비스는 모든 HA 구성원을 다시 구축합니다. 셀프 체크 쿼리 11을 확인하고, UNLOGGED 의 테이블 및 시퀀스를 참조하십시오.
  • 이 배포 환경에서는 PostgreSQL 16 또는 17이 실행되고 있으며, 대량 작업이나 다수의 동시 삽입 및 업데이트로 인해 테이블 크기가 커졌습니다. 대량 작업에는 COPY, pg_restore, CREATE TABLE AS, CREATE MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW 및 ALTER TABLE 명령어가 포함되며, SET LOGGED 와 같이 테이블을 재작성하는 명령어도 이에 해당합니다. 이 부분은 미리 확인할 수 없으므로, 재구축을 염두에 두고 계획을 세워야 합니다.

또한 이 서비스는 사용자가 사전에 확인할 수 없는 다른 사유로 인해 HA 구성원을 재구축할 수도 있습니다. 백업에서 복원하는 스테이징 배포에 대한 리허설에서는 이러한 재구축이 나타나지 않을 수 있습니다.

재구축 중인 HA 구성원은 작업이 완료될 때까지 이전 데이터 파일을 유지합니다. 따라서 이 데이터가 차지하는 용량만큼의 여유 디스크 공간이 필요합니다. 업그레이드를 제출하기 전에, 각 데이터 멤버가 사용 가능한 디스크 공간의 절반보다 훨씬 적은 양을 사용하고 있는지 확인하십시오. ‘사용된 디스크 공간 ’ 메트릭을 사용하여 이 값을 확인하십시오. 디스크 공간 사전 검사에서는 디스크 사용률을 최대 90%까지 허용하지만, HA 구성 요소를 재구축할 때는 훨씬 더 많은 여유 공간이 필요합니다. 그렇지 않으면 재구축 과정에서 디스크 공간이 부족해져 반복적으로 실패할 수 있습니다. 이 경우 쓰기 작업이 작업이 실패하기 전까지 몇 시간 동안 차단된 상태로 남아 있을 수 있습니다. 자동 및 수동 디스크 확장 기능은 업그레이드가 완료될 때까지 대기하므로, 업그레이드를 실행하기 전에 디스크를 확장하십시오. 재구축 과정이 길어지면 쓰기 작업이 재개된 후에도 작업이 실패할 수 있습니다. 두 경우 모두, 지원팀이 업그레이드를 완료할 때까지 배포 환경에서는 대상 버전이 계속 실행됩니다. 유지보수 기간 내에 시스템 재구축을 위한 시간을 확보하십시오.

작업이 완료되기 전에 이력서를 작성합니다. 쓰기 작업이 재개되었는지 확인하려면 새 세션에서 SHOW default_transaction_read_only; 을 실행하십시오. 쓰기 작업이 재개되면 off 를 반환합니다. 클라이언트 세션은 읽기 전용 모드가 시작될 때, 변환을 위해 PostgreSQL 이 중지될 때, 쓰기 작업이 재개될 때, 완료 단계에서 전환이 이루어질 때, 그리고 장애 발생 후 서비스가 쓰기 액세스 권한을 복구할 때 종료됩니다.

작업 상태가 ‘완료’로 표시될 때까지는 대용량 데이터 로드나 배치 작업과 같은 지속적인 대량 쓰기 작업을 피하십시오. 완료 단계에서는 모든 HA 구성원이 모든 변경 사항을 재적용할 때까지 대기합니다. 지속적인 대용량 쓰기 부하가 가해질 경우, 이 대기 상태가 타임아웃될 수 있으며, 이 경우 쓰기 작업이 재개된 후 해당 작업이 실패하게 됩니다. HA 구성원이 아직 재구축 중인 동안에는 위험이 더 높습니다. 그런 다음 배포 과정에서 업그레이드 후 백업 없이 대상 버전을 실행하게 되며, 지원팀에서 업그레이드를 완료해야 합니다.

쓰기 부하가 HA 구성원들이 처리 속도를 따라잡을 수 있는 수준인지 확인하려면, 예정된 업그레이드 시간에 다음 쿼리를 실행하십시오. 몇 분 동안 매초마다 이 작업을 반복하세요. 예를 들어, psql 명령어를 사용하면 됩니다. \watch 1. 이 예배를 위해 모든 HA 회원들이 동시에 replay_lag_bytes 에서 ‘ 0 ’를 보여 주셔야 합니다. 이러한 현상이 전혀 발생하지 않는다면, 업그레이드를 제출하기 전에 쓰기 부하를 줄이십시오.

SELECT application_name, state,
       pg_catalog.pg_wal_lsn_diff(pg_catalog.pg_current_wal_lsn(), replay_lsn) AS replay_lag_bytes
FROM pg_catalog.pg_stat_replication
ORDER BY application_name;

이 업그레이드에서는 최적화기 통계가 새로 고쳐지지 않으므로, ANALYZE``을 실행하기 전까지는 쿼리가 성능이 낮은 실행 계획을 선택할 수 있습니다. PostgreSQL s 15, 16 또는 17로 업그레이드할 경우 통계 정보는 이전되지 않습니다. PostgreSQL 18로 업그레이드하면 대부분의 통계가 이전되지만, CREATE STATISTICS 을 사용하여 생성한 확장 통계나 PostGIS 와 같은 확장 기능이 수집한 통계는 이전되지 않습니다. autovacuum 프로세스는 충분한 쓰기 작업이 발생한 후에야 테이블을 분석하며, 파티션된 테이블은 절대 분석하지 않습니다. 태스크가 완료될 때까지 기다리지 않습니다. SHOW default_transaction_read_only; 가 off 를 반환하는 즉시, ‘업그레이드 후’ 섹션에 설명된 대로 통계를 새로 고치십시오.

읽기 전용 모드는 새 트랜잭션에 대한 기본값을 설정합니다. 데이터베이스를 잠그지 않습니다. default_transaction_read_only 를 off 로 설정하거나, 읽기-쓰기 트랜잭션을 명시적으로 시작하는 세션에서도 여전히 쓰기 작업이 가능합니다. 그렇다면, 자체 ‘ default_transaction_read_only ’ 설정이 ‘ off ’인 역할도 가능한가요? VACUUM, ANALYZE, REINDEX, CLUSTER 와 같은 유지 관리 명령어도 여전히 실행됩니다. 읽기 전용 모드는 이미 실행 중인 ‘ pg_cron ’ 작업이나 ‘ PostgreSQL 17’에서 활성화된 구독을 중지하지 않습니다. 이러한 기록으로 인해 업그레이드가 실패할 수 있습니다. 업그레이드를 제출하기 전에, 읽기 전용 모드를 무효화하는 프로세스를 중지하십시오. pg_cron 작업과 같이 데이터를 기록하거나 유지 관리 명령을 실행하는 예약된 작업을 일시 중지하고, 실행 중인 작업이 완료될 때까지 기다립니다. ‘업그레이드 후’ 섹션에 설명된 대로 해당 작업을 재개하십시오.

읽기 전용 모드에서도 읽기 작업 중에 트랜잭션 로그가 기록될 수 있습니다. 예를 들어, 대량 로드나 대규모 업데이트가 발생한 후 쿼리가 처음으로 행을 읽을 때와 같은 경우입니다. 이 작업은 읽기 전용 단계와 재시작 단계가 대기하는 캐치업 과정을 지연시키므로, 쓰기 작업이 더 오랫동안 차단된 상태로 유지되어 업그레이드가 실패할 수 있습니다. 업그레이드를 제출하기 전에, 최근에 데이터를 로드했거나 대폭 수정한 테이블에 대해 VACUUM 명령을 실행하십시오.

서비스가 세션을 종료하면, 배포 환경에 직접 연결된 클라이언트는 SQLSTATE 57P01 (admin_shutdown) 오류를 받게 됩니다. 읽기 전용 트랜잭션에서 쓰기 작업이 수행되면 SQLSTATE 25006 (read_only_sql_transaction) 오류가 발생합니다. 변환 단계에서는 자격 증명이 변경되지 않았더라도 SQLSTATE 28P01 와 같은 인증 오류로 인해 새 연결이 실패할 수 있습니다. 변환이 완료된 후 연결을 다시 시도해 보세요. 작업 상태가 ‘실패’로 표시된 후에도 이러한 오류가 계속 발생하면 지원팀에 문의하십시오. 연결 풀러를 통해 애플리케이션은 다른 연결 오류들을 확인할 수 있습니다.

읽기-쓰기 세션만 허용하는 클라이언트는 읽기 전용 모드가 설정되어 있는 동안에는 연결할 수 없으므로, 쓰기 작업이 재개될 때까지 해당 클라이언트에서는 읽기 작업도 사용할 수 없습니다. 이는 target_session_attrs=read-write 를 설정한 libpq 클라이언트와, targetServerType=primary 또는 master 를 설정한 JDBC 클라이언트에 적용됩니다. 읽기 작업을 계속 사용할 수 있도록 하려면 target_session_attrs=any 또는 libpq 14 이상에서는 primary 를 사용하십시오. JDBC 의 경우 targetServerType=any 을 사용하십시오.

애플리케이션은 연결 실패 및 읽기 전용 오류를 처리하고, 재연결해야 하며, 중단된 트랜잭션은 안전한 경우에만 재시도해야 합니다. 연결 풀링이라고 해도 이러한 요구 사항이 사라지는 것은 아닙니다. 애플리케이션에 접속할 수 있다고 해서 업그레이드 작업이 완료된 것은 아닙니다.

백업 및 복구

이 서비스는 업그레이드 전에 데이터 백업을 수행하지 않습니다. IPMVU를 실행하기 전에 최근의 주문형 백업을 생성하고 확인하십시오. 업그레이드 후 원본 버전으로 되돌리려면, 업그레이드 전 백업 또는 복구 지점을 원본 버전이 실행되는 새로운 배포 환경에 복원하십시오. 버전을 명시적으로 설정하십시오. 버전을 지정하지 않고 특정 시점 복원을 수행하면 현재 버전이 실행되는 배포가 생성되기 때문입니다. 이 옵션을 사용하려면 새로운 배포를 위해 소스 버전을 계속 사용할 수 있어야 합니다. 그 시점 이후 발생한 변경 사항을 반영하십시오.

업그레이드가 성공적으로 완료되면, 서비스는 업그레이드된 배포본의 백업을 대기열에 추가합니다. 백업은 업그레이드 작업이 완료된 후 별도로 실행되며, 즉시 시작되지 않을 수도 있습니다. 새 버전에서 수행하는 이 첫 번째 백업은 전체 데이터베이스를 복사하므로, 데이터베이스 크기가 큰 경우 몇 시간이 소요될 수 있습니다. ‘백업 및 복원 ’에서 해당 상태를 확인하세요. 작동이 중단되면 수동 백업을 수행하고, 오류가 계속될 경우 지원팀에 문의하십시오. 백업에 오류가 발생하더라도 업그레이드는 되돌려지지 않습니다.

특정 시점 복구(PITR)는 메이저 버전 업그레이드 간에 트랜잭션을 재현할 수 없습니다. 업그레이드 작업이 시작되기 전의 시점으로 복원하거나, 업그레이드된 배포에 대한 첫 번째 백업이 완료된 후의 시점으로 복원할 수 있습니다. 업그레이드와 업그레이드 후 백업 완료 사이의 복구 지점으로의 복원은 지원되지 않습니다. 이 서비스는 이러한 복구 지점 중 일부를 거부하는 반면, 다른 복구 지점에 대한 복원은 허용될 수 있지만 복원 과정에서 실패할 수도 있습니다. 이 지원되지 않는 기간에는 쓰기 작업이 재개된 후의 시간도 포함됩니다. 업그레이드 후 백업이 완료되기 전까지는, 서비스가 복원 요청을 수락하더라도 사용 가능한 최신 복구 지점으로의 복원이 실패할 수도 있습니다.

업그레이드 후 변경 사항에 대해서도 PITR 적용 범위를 유지하려면, 업그레이드 후 백업이 완료될 때까지 애플리케이션의 쓰기 작업을 일시 중지해야 합니다. 애플리케이션에서 해당 기능을 일시 중지하세요. 쓰기 작업이 재개되면, 업그레이드 과정에서 모든 데이터베이스의 default_transaction_read_only 가 재설정되므로, 데이터베이스 수준의 읽기 전용 설정만으로는 쓰기 작업이 일시 중지된 상태를 유지할 수 없습니다.

업그레이드가 실패하면 백업이 대기열에 추가되지 않습니다. 시도 시작 시점부터 다음 백업이 완료될 때까지 PITR을 통해 포인트를 확인할 수 없을 수 있습니다. 업그레이드가 실패한 후, SHOW server_version; 에서 소스 버전을 표시하고 배포 환경이 쓰기 작업을 허용하는 경우, 수동 백업을 수행하십시오. 그렇지 않은 경우, 백업을 수행하거나 다른 변경 사항을 적용하기 전에 고객 지원팀에 문의하십시오.

업그레이드 전 백업 및 복구 지점은 이전 버전에 속하며, 여전히 보존 기간 제한의 적용을 받습니다. 자세한 내용은 PITR을 참조하십시오.

PostgreSQL: 의 경우, API( skip_backup ), CLI( --skip-backup ), Terraform( version_upgrade_skip_backup )에서 ‘skip-backup’ 옵션이 지원되지 않습니다. 이를 가능하게 하는 요청은 실패합니다. API와 CLI에서 오류가 발생하고, Terraform 계획 수립이 실패합니다.

시작하기 전에

다음 요구 사항을 스테이징 환경과 프로덕션 환경 모두에 적용하십시오:

  • 애플리케이션, 확장 및 복제 준비와 백업 준비를 완료하십시오.

  • 사전 검사에서 감지하지 못한 문제를 해결한 다음, 자체 검사 쿼리를 실행하십시오.

  • 각 데이터 멤버가 사용 가능한 디스크 공간의 절반보다 훨씬 적은 양만 사용하도록 하여, HA 멤버를 재구축할 때 공간이 부족해지는 일이 없도록 하십시오. 자세한 내용은 ‘업그레이드 중 가용성’을 참조하십시오.

  • 배포에 완료된 백업이 적어도 하나 있는지 확인하십시오. 그때까지 콘솔에서는 ‘메저 버전 업그레이드 ’ 버튼이 비활성화되며, API는 해당 요청을 거부합니다.

  • IPMVU는 읽기 전용 복제본 배포 환경에서는 사용할 수 없습니다. 레플리카를 업그레이드하려면 버전 업그레이드를 통해 레플리카를 승격시키십시오.

  • 배포의 모든 읽기 전용 복제본(다른 리전의 복제본 포함)을 승격하거나 삭제하고, 각 작업이 완료될 때까지 기다립니다. 삭제된 복제본은 영구적으로 삭제될 때까지 해당 배포와 연결된 상태로 유지됩니다. 배포에 레플리카가 하나라도 연결되어 있는 상태에서는 업그레이드의 사전 검사가 실패합니다. 이러한 복제본에서 데이터를 읽어오는 애플리케이션에 대한 계획을 수립하십시오. 자세한 내용은 ‘읽기 전용 복제본’ 및 ‘IPMVU’를 참조하십시오.

  • 업그레이드는 한 번에 하나씩 수행하십시오. 다른 업그레이드 작업이 대기 중이거나 실행 중인 경우, 이 서비스는 새로운 업그레이드 요청을 거부합니다.

  • 배포의 ‘ synchronous_commit ’ 설정을 ‘ on ’로 설정해 둔 경우, 업그레이드를 제출하기 전에 이를 ‘ local ’로 변경하십시오. 작업 상태가 ‘완료’로 표시되면 다시 원래대로 변경하세요. on 의 경우, 업그레이드에 실패하면 지원팀이 배포 상태를 복구할 때까지 모든 데이터베이스가 읽기 전용 모드로 전환되거나 커밋이 대기 상태가 될 수 있습니다. 다음 쿼리의 결과로 on 가 반환되고, 소스가 configuration file 인 경우, 해당 배포의 설정은 ‘ on ’입니다:

    SELECT setting, source
    FROM pg_catalog.pg_settings
    WHERE name = 'synchronous_commit';
    
  • 배포 항목의 기능 중에서 대상을 선택하십시오. 업그레이드 경로로 표시되는 더 최신 버전이라면, 중간 버전을 거치지 않고 바로 업그레이드할 수 있습니다. 프로비저닝할 수 있는 버전이 반드시 인플레이스 업그레이드 대상이 되는 것은 아닙니다:

    ibmcloud cdb deployment-capability-show <NAME|CRN> versions
    

    출력에서는 ‘ 업그레이드 전환 ’ 항목의 ‘ to_version ’ 값을 사용하십시오.

사전 점검 및 준비

이 서비스는 읽기 전용 모드가 시작되기 전에 다음과 같은 확인 작업을 수행합니다. 검사가 실패하면 해당 작업에 ‘실패’로 표시되며, 배포는 현재 버전을 유지하되 쓰기 작업은 차단되지 않습니다. 어떤 데이터베이스에서든 default_transaction_read_only 가 on``로 설정되어 있는 경우, 검사에 실패하면 모든 데이터베이스의 이 설정이 재설정되고 모든 클라이언트 세션이 종료됩니다. 이 작업에서는 어떤 검사가 실패했는지 표시되지 않으므로, 업그레이드를 제출하기 전에 각 항목을 하나씩 확인해 주세요.

IPMVU 사전 점검
확인 다음과 같은 경우 통과합니다 사용자 조치
배포 상태 모든 데이터 멤버가 실행 중이며, 각 HA 멤버는 프라이머리에서 데이터를 스트리밍하고 있습니다. 확장, 유지 관리 및 HA 구성원 재구성이 완료될 때까지 기다리십시오. 셀프 체크 쿼리 1을 통해 확인해 보세요. 다른 작업들은 이 검사를 통과하지만, 업그레이드 시작을 지연시킵니다. ‘최근 작업’을 확인하거나, 다음 명령어를 사용하여 작업 목록을 표시하세요. ibmcloud cdb deployment-tasks-list. 이 검사가 계속 실패할 경우, 지원팀에 문의하십시오.
디스크 공간 각 데이터 멤버는 할당된 디스크 공간의 최대 90%를 사용합니다. 디스크 용량을 조정하거나 더 이상 필요하지 않은 데이터를 삭제하십시오. 사용되지 않는 논리적 복제 슬롯에도 트랜잭션 로그가 남아 있을 수 있습니다. 이 검사에서는 최대 90%까지 허용되지만, HA 구성원을 재구축할 때는 각 데이터 구성원이 디스크 용량의 절반보다 훨씬 적은 양만 사용해야 합니다. 업그레이드 중 사용 가능 여부를 확인하십시오.
CPU, 메모리 및 디스크 I/O 각 데이터 구성원마다 호스트의 1분 평균 부하가 해당 호스트의 CPU 수에 비해 최대 90%를 넘지 않아야 하며, 호스트 메모리 사용량도 최대 90%를 넘지 않아야 합니다. 디스크 I/O 사용률도 최대 90%입니다. 사용량이 적은 시간대에 업그레이드를 진행하거나, 나중에 다시 업그레이드 요청을 제출하세요. 이 서비스는 호스트에 실행 중인 다른 워크로드를 포함하여 호스트 전체의 부하와 메모리 사용량을 측정하고, 몇 초 동안 디스크 I/O를 샘플링합니다. 부하 평균에는 디스크 I/O를 대기 중인 프로세스도 포함됩니다. 따라서 해당 값은 사용자의 모니터링 지표와 다를 수 있으며, 배포 규모를 조정한다고 해서 해당 값이 낮아지지는 않을 수 있습니다. 이 검사가 계속 실패할 경우, 지원팀에 문의하십시오.
트랜잭션 로그 보관 보관 작업에 오류가 발생하지 않았으며, 보관을 기다리고 있는 트랜잭션 로그의 크기는 4 GB를 넘지 않습니다. 백로그가 해소될 때까지 쓰기 속도를 줄이십시오. 셀프 체크 쿼리 5를 통해 확인해 보세요. 또한, 예를 들어 페일오버 직후와 같이 HA 구성원에 대기 중인 트랜잭션 로그가 있는 경우에도 검사가 실패합니다. 이 검사가 계속 실패할 경우, 지원팀에 문의하십시오.
논리적 복제 논리적 복제 슬롯이 존재하지 않습니다. PostgreSQL 16 및 그 이전 버전에서는 비활성화된 구독을 포함하여 논리적 구독이 존재하지 않습니다. 슬롯을 제거하십시오. PostgreSQL 16 및 그 이전 버전에서는 구독을 제거하십시오. PostgreSQL 17에서는 해당 기능을 비활성화하십시오. 자가 점검 질문 2와 3을 확인해 보세요.
읽기 전용 복제본 및 복제 클라이언트 이 배포 환경에는 관련 읽기 전용 복제본이 없으며, HA 구성원 외에는 이 배포 환경에 연결되는 복제 클라이언트가 없습니다. 모든 지역 및 주에서 레플리카가 집계되며, 여기에는 프로비저닝 중이거나 연결이 끊긴 레플리카도 포함됩니다. 콘솔에서 또는 다음 명령어를 사용하여 관련 복제본을 나열하십시오. ibmcloud cdb deployment-read-replicas 를 사용하여 나열하십시오. 각 항목을 승격하거나 삭제하고, 각 작업이 완료될 때까지 기다리십시오. 삭제된 복제본은 목록에 더 이상 표시되지는 않지만, 영구적으로 삭제될 때까지는 여전히 집계 대상에 포함됩니다. “읽기 전용 복제본” 및 “IPMVU” 항목을 참조하십시오. 다른 복제 클라이언트의 연결을 끊으십시오. 자가 진단 쿼리 1은 연결된 클라이언트만 표시합니다.
준비된 거래 준비된 트랜잭션이 없습니다. 업그레이드가 완료될 때까지 소유 애플리케이션이나 트랜잭션 관리자가 준비된 트랜잭션을 처리하도록 하고, 새로운 트랜잭션이 생성되지 않도록 방지하십시오. 검사를 통과하기 위해서만 커밋하거나 롤백하지 마십시오. 셀프 체크 쿼리 4를 통해 확인해 보세요.
스키마 내보내기 각 데이터베이스의 스키마는 오류 없이 내보내집니다. 타임아웃이 발생하거나 잠금 공간이 부족해진 내보내기 작업은 이 검사에서 실패로 간주되지 않습니다. 최근 백업에서 복원한 스테이징 배포 환경에서 업그레이드 절차를 미리 연습해 보십시오. 이 검사는 대상 버전이 스키마를 다시 생성할 수 있는지 여부를 확인하지 않으므로, 사전 검사에서 감지하지 못하는 조건들도 함께 해결해야 합니다. 이 검사가 계속 실패할 경우, 지원팀에 문의하십시오.
업그레이드 호환성 PostgreSQL 주 노드와 모든 HA 구성원 모두에서 업그레이드 호환성 검사가 통과되었습니다. pgRouting 점검을 포함한 확장 준비 작업을 완료하십시오. PostgreSQL 17에서는 구독을 최대 10개까지만 유지하십시오. 자가 점검 문제 6, 8, 9, 10을 확인해 보세요.

사전 점검에서 탐지하지 못하는 상황

사전 점검에서는 다음과 같은 상황을 감지하지 못합니다. 일부 경우에는 쓰기 작업이 차단된 후 업그레이드가 실패하기도 합니다. 원인이 함수나 데이터베이스 이름과 같은 스키마에 있는 경우, 해당 문제를 해결할 때까지 모든 재시도는 동일한 방식으로 실패합니다. 다른 상황에서는 이 서비스가 전체 데이터베이스를 HA 구성원들에게 복사하게 되어, 쓰기 작업이 훨씬 더 오랫동안 차단되거나, 쓰기 작업이 재개된 후 업그레이드가 실패하게 됩니다. 변환 또는 재시작 단계에서 오류가 발생하면, 지원 담당자가 다시 시작할 때까지 HA 구성원들이 중지된 상태로 남아 있을 수도 있습니다. 업그레이드를 제출하기 전에 각 조건에 대해 해결하거나 대비책을 마련하십시오.

사전 점검에서 탐지하지 못하는 상황
조건 결과 수행할 작업
데이터베이스에는 ‘ UNLOGGED ’ 테이블이 포함되어 있습니다. 모든 HA 구성원이 재구축되며, UNLOGGED 의 내용이 초기화됩니다. 셀프 체크 쿼리 11을 통해 확인해 보세요. UNLOGGED 의 테이블 및 시퀀스를 참조하십시오.
이 배포 환경에서는 PostgreSQL 16 또는 17이 실행되고 있으며, 대량 작업이나 다수의 동시 삽입 및 업데이트로 인해 테이블 크기가 커졌습니다. HA 멤버들이 재구성되었습니다. 재구축을 위한 유지보수 기간과 디스크 공간을 계획하십시오. 업그레이드 중 사용 가능 여부를 확인하십시오.
HA 구성원이 재구축될 때, 데이터 구성원은 디스크 용량의 약 절반 이상을 차지합니다. 재구축 과정에서 공간이 부족해졌습니다. 쓰기 작업은 작업이 실패하기 전까지 몇 시간 동안 차단된 상태로 유지될 수 있습니다. 업그레이드를 제출하기 전에, 각 데이터 멤버가 사용 가능한 디스크 공간의 50%보다 훨씬 적은 양을 사용하도록 디스크 용량을 조정하십시오.
인덱스, 파티션 키, 저장된 생성 열 또는 확장 통계는 pg_catalog 외부에 있는 객체의 이름을 스키마 없이 문자열 형식으로 지정하는 LANGUAGE sql 함수를 사용합니다. 인덱스에서 ‘ ibm_extension ’ 스키마를 지정하는 것도 동일한 효과를 냅니다. 변환에 실패했습니다. 셀프 체크 쿼리 12를 통해 확인해 보세요. 인덱스, 파티션 키 및 생성된 열에서 SQL 함수를 참조하십시오.
인덱스나 저장된 생성 열은 1.1 버전의 earthdistance 를 사용합니다. 변환에 실패했습니다. 셀프 체크 쿼리 13을 통해 확인해 보세요. earthdistance의 내용을 참조하십시오.
SQL 표준에 따른 본문을 갖는 뷰, 집계 함수 또는 함수는 대상 버전에서 제거된 시스템 이름을 사용합니다. 또는 함수, 역할 또는 데이터베이스 설정에서 제거된 매개변수를 사용하고 있는 경우입니다. 변환에 실패했습니다. 자가 점검 질문 7번과 14번을 확인해 보세요. “제거된 시스템 이름을 사용하는 객체”를 참조하십시오.
anon 버전 2가 설치되어 있습니다. 변환에 실패했습니다. anon 준비 과정을 완료하십시오.
데이터베이스 이름에는 작은 따옴표('), 백슬래시(``), 등호(=), 줄바꿈 또는 캐리지 리턴이 포함될 수 있습니다. 업그레이드가 실패하며, 경우에 따라 쓰기 작업이 차단된 후에 발생하기도 합니다. 셀프 체크 쿼리 15를 통해 확인해 보세요. 데이터베이스 이름을 변경하고, 연결 문자열을 업데이트하십시오.
데이터베이스에는 수천 개의 테이블과 시퀀스, 또는 ‘ PostgreSQL ’ 14 및 15의 경우 뷰가 포함되어 있습니다. 변환 과정에서 잠금 공간이 부족하여 실패합니다. 셀프 체크 쿼리 16을 확인하고, 쿼리 결과 필요하다는 것이 확인되면 max_locks_per_transaction 값을 늘리십시오.
이 배포 환경에는 매우 많은 데이터베이스, 테이블 또는 대용량 객체가 포함되어 있습니다. 변환에 소요된 시간이 제한 시간을 초과했습니다. 데이터베이스를 사용할 수 없는 상태에서는 작업이 실패하거나 진행 중인 상태로 유지됩니다. 셀프 체크 쿼리 16을 사용하여 테이블과 대형 객체의 개수를 세어보세요. 최근의 운영 환경 백업에서 복원한 스테이징 배포 환경에서 리허설을 진행하십시오. 리허설이 실패할 경우, 지원팀에 문의하십시오.
업그레이드가 시작될 때 쓰기 작업이 많거나, 아카이빙을 기다리는 트랜잭션 로그가 많을 때 발생합니다. 읽기 전용 모드가 시작된 후, HA 구성원과 트랜잭션 로그 아카이빙은 상황을 따라잡을 수 있는 시간이 불과 몇 분밖에 주어지지 않습니다. 사전 검사를 통과한 백로그는 아카이빙하는 데 더 오랜 시간이 걸릴 수 있으며, 이로 인해 업그레이드가 실패할 수 있습니다. 업그레이드가 시작되는 시점부터 쓰기 작업이 재개될 때까지 부하를 낮게 유지하고, 업그레이드 전에 최근에 로드된 테이블에 대해 VACUUM 을 실행하십시오. ‘업그레이드 중 가용성’ 섹션에 있는 쿼리를 사용하여 복제 지연 시간을 확인하고, 자체 점검 쿼리 5를 사용하여 아카이빙 상태를 확인하십시오.
읽기 전용 모드가 시작된 후에도 쓰기 작업은 계속됩니다. 예를 들어, 읽기 전용 모드에서 설정된 재정의, 유지 관리 명령, pg_cron 작업 실행, 또는 PostgreSQL 17에서 활성화된 구독 등이 이에 해당합니다. HA 구성원 및 아카이빙 작업이 제때 따라가지 못해 업그레이드가 실패할 수 있습니다. ‘업그레이드 중 가용성’ 항목에 설명된 대로, 업그레이드를 제출하기 전에 해당 작성자들을 차단하십시오.
클라이언트는 사전 확인이 끝난 후 트랜잭션을 준비합니다. PREPARE TRANSACTION 는 읽기 전용 모드에서도 여전히 작동합니다. 쓰기 작업이 차단된 상태에서 업그레이드가 실패합니다. PostgreSQL 가 중지되기 직전에 준비된 트랜잭션은 변환이 실패하는 원인이 될 수 있습니다. 작업 상태가 ‘완료’로 표시될 때까지 2단계 커밋을 사용하는 클라이언트를 중지하십시오. 셀프 체크 쿼리 4를 통해 확인해 보세요.
업그레이드 중에 복제 클라이언트가 연결됩니다. 이 과정에서 생성된 슬롯은 유지되지 않으며, 데이터베이스를 사용할 수 없는 동안 업그레이드가 실패하거나 중단될 수 있습니다. 작업 상태가 ‘완료’로 표시될 때까지 복제 클라이언트의 연결을 끊어 두십시오. 자가 점검 질문 1과 2를 확인해 보세요.
쓰기 작업이 재개된 후 연속적인 대량 로드가 실행됩니다. 쓰기 작업이 재개된 후 작업이 실패하며, 지원팀이 업그레이드를 완료할 때까지 배포는 대상 버전을 계속 실행합니다. 작업 상태가 ‘완료’로 표시될 때까지 대량 업로드를 피하십시오.
이 배포의 ' synchronous_commit ' 설정은 on 입니다. 업그레이드가 실패하면 지원팀이 배포 상태를 복구할 때까지 모든 데이터베이스가 읽기 전용 상태로 유지될 수 있습니다. ‘시작하기 전에 ’에 설명된 대로 local 로 변경하십시오.
PostgreSQL 16 또는 그 이전 버전에서 17 또는 그 이후 버전으로 업그레이드할 때, 인덱스, 구체화된 뷰 또는 확장 통계에 ‘ search_path ’ 설정이 지정되지 않은 함수가 사용되고 있는 경우입니다. 업그레이드 후, ANALYZE, REINDEX, CLUSTER, VACUUM FULL 및 REFRESH MATERIALIZED VIEW 에서 해당 개체에 대한 작업이 실패할 수 있습니다. 셀프 체크 쿼리 17을 통해 확인해 보십시오. 인덱스, 파티션 키 및 생성된 열에서 SQL 함수를 참조하십시오.

업그레이드 요청을 제출한 시점부터 작업이 완료될 때까지 스키마, 확장 기능, 데이터베이스, 논리적 복제 슬롯 또는 구독을 변경하지 마십시오.

직접 준비 상태 확인하기

업그레이드를 제출하기 전에 admin 사용자로 로그인한 상태에서 psql 을 통해 다음 쿼리를 실행하십시오. 이 기능들은 ‘ PostgreSQL ’ 14부터 18까지에서 작동합니다. 쿼리 1부터 7까지와 쿼리 15는 전체 배포를 다루므로, 아무 데이터베이스에서나 한 번씩 실행하면 됩니다. 각 데이터베이스에서 나머지 쿼리들을 실행하십시오.

  1. 복제 연결. HA 구성원 하나당 한 행이 표시되며, 이는 데이터 구성원 수에서 1을 뺀 수와 같습니다. 각 행의 상태는 streaming 입니다. 그 외의 모든 행은 읽기 전용 복제본이거나 다른 복제 클라이언트입니다. pg_basebackup 라는 이름의 행은 해당 서비스가 데이터베이스를 HA 구성원이나 읽기 전용 복제본으로 복사하고 있음을 의미합니다. 복사가 완료될 때까지 기다린 다음, 쿼리를 다시 실행하십시오.

    SELECT application_name, client_addr, state
    FROM pg_catalog.pg_stat_replication
    ORDER BY application_name;
    
  2. 논리적 복제 슬롯. 다툼은 없을 것으로 예상됩니다.

    SELECT slot_name, plugin, database, active
    FROM pg_catalog.pg_replication_slots
    WHERE slot_type = 'logical';
    
  3. 논리적 구독. PostgreSQL 16 및 그 이전 버전에서는 행이 없을 것으로 예상됩니다. PostgreSQL 17에서는 모든 행의 ‘ subenabled ’ 열에 ‘ f ’가 표시될 것으로 예상됩니다.

    SELECT d.datname AS database_name, s.subname, s.subenabled
    FROM pg_catalog.pg_subscription AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.subdbid;
    
  4. 처리된 거래. 다툼은 없을 것으로 예상됩니다.

    SELECT gid, owner, database, prepared
    FROM pg_catalog.pg_prepared_xacts;
    
  5. 트랜잭션 로그 보관. last_failed_time 는 비어 있거나 last_archived_time 보다 이른 값이 될 것이며, waiting_files 는 0이거나 0에 가까운 값이 될 것으로 예상됩니다. 사전 검사를 통과한 미처리 작업이더라도, 읽기 전용 모드가 시작된 후에는 아카이브하기에는 여전히 너무 방대할 수 있습니다.

    SELECT failed_count, last_failed_time, last_archived_time
    FROM pg_catalog.pg_stat_archiver;
    
    SELECT count(*) AS waiting_files,
           pg_catalog.pg_size_pretty(count(*) * pg_catalog.pg_size_bytes(pg_catalog.current_setting('wal_segment_size'))) AS waiting_size
    FROM pg_catalog.pg_ls_archive_statusdir()
    WHERE name LIKE '%.ready';
    
  6. 데이터베이스 연결 설정. 다툼은 없을 것으로 예상됩니다. datconnlimit 가 -2 인 등록된 데이터베이스를 삭제하십시오. 이 값은 유효하지 않기 때문입니다. 나열된 다른 데이터베이스에 대해서는 연결을 허용하거나 해당 데이터베이스를 삭제하십시오. 쿼리 결과에 ‘ template0 ’가 표시되면 지원팀에 문의하십시오.

    SELECT datname, datallowconn, datconnlimit
    FROM pg_catalog.pg_database
    WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2))
       OR (datname = 'template0' AND datallowconn);
    
  7. 역할 및 데이터베이스 설정. setconfig 에 있는 모든 매개변수가 대상 버전에 존재하는지 확인하십시오. 대상 버전에서 제거되거나 이름이 변경된 매개변수를 초기화하고, 업그레이드 후 이를 대체할 매개변수를 설정합니다. 이는 이름에 마침표가 포함된 확장 기능에서 정의된 매개변수에도 적용됩니다. 어떤 역할도 default_transaction_read_only 을 false 값(예: off, ` `false, no 또는 ` `0)으로 설정하지 않도록 확인하십시오. default_transaction_read_only 를 설정해 둔 각 데이터베이스를 기록해 두십시오. 업그레이드 과정에서 이 설정이 초기화되기 때문입니다. 자체 점검 쿼리 14는 함수 설정을 확인합니다.

    SELECT r.rolname AS role_name, d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    LEFT JOIN pg_catalog.pg_roles AS r ON r.oid = s.setrole
    LEFT JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase;
    
  8. PostgreSQL 에서 업그레이드할 수 없는 열 데이터 유형. 다툼은 없을 것으로 예상됩니다. 이 쿼리에는 시스템 복합 유형의 열은 물론, 도메인, 배열, 복합 유형 및 이러한 유형을 기반으로 생성된 범위 열도 나열됩니다. base_type 열에는 업그레이드를 차단하는 유형이 표시됩니다. aclitem 유형은 PostgreSQL 14 또는 15에서 16 이상으로의 업그레이드만 차단합니다.

    WITH RECURSIVE problem_types (type_oid, base_type) AS (
      SELECT t.oid, t.typname::text
      FROM pg_catalog.pg_type AS t
      WHERE t.typnamespace = 'pg_catalog'::pg_catalog.regnamespace
        AND t.typname IN ('regcollation', 'regconfig', 'regdictionary', 'regnamespace',
                          'regoper', 'regoperator', 'regproc', 'regprocedure', 'aclitem')
      UNION ALL
      SELECT t.oid, 'system composite type ' || t.oid::pg_catalog.regtype::text
      FROM pg_catalog.pg_type AS t
      LEFT JOIN pg_catalog.pg_namespace AS n ON n.oid = t.typnamespace
      WHERE t.typtype = 'c'
        AND (t.oid < 16384 OR n.nspname = 'information_schema')
      UNION ALL
      SELECT derived.type_oid, derived.base_type
      FROM (
        WITH found AS (SELECT type_oid, base_type FROM problem_types)
        SELECT t.oid AS type_oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'd' AND t.typbasetype = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'b' AND t.typelem = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_class AS c ON c.reltype = t.oid
        JOIN pg_catalog.pg_attribute AS a ON a.attrelid = c.oid AND NOT a.attisdropped
        JOIN found AS f ON a.atttypid = f.type_oid
        WHERE t.typtype = 'c'
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_range AS r ON r.rngtypid = t.oid
        JOIN found AS f ON r.rngsubtype = f.type_oid
        WHERE t.typtype = 'r'
      ) AS derived
    )
    SELECT DISTINCT n.nspname AS schema_name, c.relname AS relation_name, a.attname AS column_name,
           a.atttypid::pg_catalog.regtype AS data_type, p.base_type
    FROM pg_catalog.pg_attribute AS a
    JOIN pg_catalog.pg_class AS c ON c.oid = a.attrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    JOIN problem_types AS p ON p.type_oid = a.atttypid
    WHERE a.attnum > 0
      AND NOT a.attisdropped
      AND c.relkind IN ('r', 'm', 'i')
      AND n.nspname NOT IN ('pg_catalog', 'information_schema')
      AND n.nspname !~ '^pg_toast_temp_|^pg_temp_'
    ORDER BY 1, 2, 3;
    
  9. 상위 테이블에 있는 ‘ NOT NULL ’ 제약 조건이 없는 상속된 열들. 다툼은 없을 것으로 예상됩니다. 나열된 열을 수정하려면 테이블 소유자가 ALTER TABLE <table_name> ALTER COLUMN <column_name> SET NOT NULL;``을 실행합니다.

    SELECT n.nspname AS schema_name, c.relname AS table_name, child.attname AS column_name
    FROM pg_catalog.pg_inherits AS i
    JOIN pg_catalog.pg_attribute AS child ON child.attrelid = i.inhrelid
    JOIN pg_catalog.pg_attribute AS parent
      ON parent.attrelid = i.inhparent AND parent.attname = child.attname
    JOIN pg_catalog.pg_class AS c ON c.oid = i.inhrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE parent.attnum > 0
      AND parent.attnotnull
      AND NOT child.attnotnull
      AND NOT child.attisdropped;
    
  10. 설치된 확장 프로그램. 확장 준비를 완료하십시오. 그런 다음, 남아 있는 모든 확장 기능이 대상 버전에서 사용 가능한지 확인하십시오. 예를 들어, 해당 버전의 스테이징 배포 환경에서 확인해 볼 수 있습니다.

    SELECT extname, extversion
    FROM pg_catalog.pg_extension
    ORDER BY extname;
    
  11. UNLOGGED 테이블과 시퀀스. 업그레이드 과정에서 해당 내용이 유지되지 않으며, 나열된 테이블로 인해 서비스가 모든 HA 구성원을 재구축하게 됩니다. 업그레이드하기 전에 UNLOGGED 의 테이블 및 시퀀스 항목을 참조하십시오.

    SELECT n.nspname AS schema_name, c.relname AS relation_name, c.relkind
    FROM pg_catalog.pg_class AS c
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE c.relpersistence = 'u'
      AND c.relkind IN ('r', 'S');
    
  12. 변환이 실패하게 만들 수 있는 SQL 함수. 다툼은 없을 것으로 예상됩니다. 이 쿼리는 인덱스, 부분 인덱스 술어, 파티션 키, 저장된 생성 열 또는 확장 통계에서 사용하는 문자열 본문을 갖는 LANGUAGE sql 함수들을 나열합니다. 이 기능은 연산자, 도메인 검사 제약 조건 및 SQL 표준에 따른 본문을 가진 함수를 통해 호출됩니다. 나열된 각 함수에 대해서는 ‘인덱스, 파티션 키 및 생성된 열의 SQL 함수’를 참조하십시오.

    WITH RECURSIVE uses (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid,
             CASE WHEN c.relkind = 'p' THEN 'partition key of ' ELSE 'index ' END
               || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
      WHERE c.relkind IN ('i', 'I') OR (c.relkind = 'p' AND d.objsubid = 0)
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attrelid = ad.adrelid
       AND a.attnum = ad.adnum
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attribute AS a
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND a.attrelid = d.objid
       AND a.attnum = d.objsubid
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid, 'statistics ' || s.stxname || ' on ' || s.stxrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s
        ON d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
       AND s.oid = d.objid
    ), used (fn, used_by) AS (
      SELECT x.fn, u.used_by
      FROM uses AS u
      CROSS JOIN LATERAL (
        SELECT u.refobjid AS fn
        WHERE u.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE u.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = u.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE u.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = u.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
       AND NOT p.prosecdef
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT u.fn::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname = 'sql'
      AND p.prosqlbody IS NULL
      AND p.proconfig IS NULL
      AND NOT p.prosecdef
      AND p.pronamespace <> 'pg_catalog'::pg_catalog.regnamespace
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    
  13. earthdistance 버전 1.1 을 직접 사용하거나, SQL 표준 본문을 따르는 함수를 통해 사용하는 인덱스 및 저장된 생성 열. 다툼은 없을 것으로 예상됩니다. 나열된 각 항목에 대해서는 earthdistance 를 참조하십시오.

    WITH RECURSIVE used (fn, via, used_by) AS (
      SELECT d.refobjid, d.refobjid, 'index ' || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
       AND c.relkind IN ('i', 'I')
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      LEFT JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attgenerated = 's'
       AND ((a.attrelid = ad.adrelid AND a.attnum = ad.adnum)
            OR (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                AND a.attrelid = d.objid
                AND a.attnum = d.objsubid))
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, u.via, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
       AND d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
    )
    SELECT e.extversion, u.via::pg_catalog.regprocedure AS used_function, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_depend AS m
      ON m.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
     AND m.objid = u.fn
     AND m.refclassid = 'pg_catalog.pg_extension'::pg_catalog.regclass
     AND m.deptype = 'e'
    JOIN pg_catalog.pg_extension AS e ON e.oid = m.refobjid
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE e.extname = 'earthdistance'
      AND e.extversion IN ('1.0', '1.1')
      AND l.lanname = 'sql'
      AND p.proconfig IS NULL
    ORDER BY 2, 3;
    
  14. 후속 PostgreSQL 버전에서 제거된 시스템 카탈로그 이름이나 구성 매개변수를 사용하는 뷰, 구체화된 뷰, 집계 및 함수. removed_in 열에는 이름이 포함되지 않은 첫 번째 버전이 표시됩니다. removed_in 버전이 대상 버전 이하인 행은 없을 것으로 예상됩니다. 이름이 카탈로그 참조가 아닌 텍스트와 일치할 수도 있으므로, 나열된 각 개체를 검토하십시오. ‘제거된 시스템 이름을 사용하는 객체’를 참조하십시오.

    WITH removed (relation_name, identifier, removed_in) AS (
      VALUES (NULL, 'pg_is_in_backup', 15), (NULL, 'pg_backup_start_time', 15),
             (NULL, 'pg_start_backup', 15), (NULL, 'pg_stop_backup', 15),
             ('pg_database', 'datlastsysoid', 15),
             (NULL, 'force_parallel_mode', 16),
             ('pg_stat_bgwriter', 'checkpoints_timed', 17), ('pg_stat_bgwriter', 'checkpoints_req', 17),
             ('pg_stat_bgwriter', 'checkpoint_write_time', 17), ('pg_stat_bgwriter', 'checkpoint_sync_time', 17),
             ('pg_stat_bgwriter', 'buffers_checkpoint', 17), ('pg_stat_bgwriter', 'buffers_backend', 17),
             ('pg_stat_bgwriter', 'buffers_backend_fsync', 17),
             (NULL, 'pg_stat_get_bgwriter_timed_checkpoints', 17),
             (NULL, 'pg_stat_get_bgwriter_requested_checkpoints', 17),
             (NULL, 'pg_stat_get_checkpoint_write_time', 17), (NULL, 'pg_stat_get_checkpoint_sync_time', 17),
             (NULL, 'pg_stat_get_bgwriter_buf_written_checkpoints', 17),
             (NULL, 'pg_stat_get_buf_written_backend', 17), (NULL, 'pg_stat_get_buf_fsync_backend', 17),
             ('pg_stat_progress_vacuum', 'max_dead_tuples', 17),
             ('pg_stat_progress_vacuum', 'num_dead_tuples', 17),
             ('pg_database', 'daticulocale', 17), ('pg_collation', 'colliculocale', 17),
             ('element_types', 'domain_default', 17),
             (NULL, 'interval_accum', 17), (NULL, 'interval_accum_inv', 17), (NULL, 'interval_combine', 17),
             ('pg_stat_wal', 'wal_write', 18), ('pg_stat_wal', 'wal_sync', 18),
             ('pg_stat_wal', 'wal_write_time', 18), ('pg_stat_wal', 'wal_sync_time', 18),
             ('pg_stat_io', 'op_bytes', 18), ('pg_backend_memory_contexts', 'parent', 18),
             ('pg_attribute', 'attcacheoff', 18)
    ), definitions (object_name, definition) AS (
      SELECT 'view ' || c.oid::pg_catalog.regclass::text, pg_catalog.pg_get_viewdef(c.oid)
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind IN ('v', 'm')
        AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'function ' || p.oid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', pg_catalog.pg_get_function_sqlbody(p.oid),
                                  pg_catalog.array_to_string(p.proconfig, ' '))
      FROM pg_catalog.pg_proc AS p
      WHERE (p.prosqlbody IS NOT NULL OR p.proconfig IS NOT NULL)
        AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'aggregate ' || a.aggfnoid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', a.aggtransfn, a.aggfinalfn, a.aggcombinefn,
                                  a.aggmtransfn, a.aggminvtransfn, a.aggmfinalfn)
      FROM pg_catalog.pg_aggregate AS a
      JOIN pg_catalog.pg_proc AS p ON p.oid = a.aggfnoid
      WHERE p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
    )
    SELECT d.object_name, r.identifier, r.removed_in
    FROM definitions AS d
    JOIN removed AS r
      ON d.definition ~ ('\m' || r.identifier || '\M')
     AND (r.relation_name IS NULL OR d.definition ~ ('\m' || r.relation_name || '\M'))
    ORDER BY 3, 1, 2;
    
  15. 업그레이드에서 사용할 수 없는 데이터베이스 이름. 다툼은 없을 것으로 예상됩니다. 목록에 있는 데이터베이스를 수정하려면, 해당 데이터베이스의 소유자가 다른 데이터베이스에 연결한 상태에서, 이름이 변경될 데이터베이스에 연결된 세션이 하나도 없는 동안 ALTER DATABASE "<database_name>" RENAME TO <new_name>; 명령어를 실행해야 합니다. 또한 소유자에게는 ‘ CREATEDB ’ 속성이 있어야 합니다. 그런 다음, 데이터베이스에 연결되는 모든 애플리케이션을 업데이트하십시오.

    SELECT datname
    FROM pg_catalog.pg_database
    WHERE pg_catalog.strpos(datname, '''') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(92)) > 0
       OR pg_catalog.strpos(datname, '=') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(10)) > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(13)) > 0
    ORDER BY datname;
    
  16. 업그레이드 시 잠기는 관계, 대용량 객체 및 배포의 잠금 용량. 값이 가장 높은 4개의 데이터베이스에 대한 ‘ locked_relations ’ 값을 모두 더하세요. PostgreSQL 14 및 15에서는 ‘ locked_relations ’에 뷰와 물질화된 뷰가 포함되는데, 이는 업그레이드 과정에서 이들 역시 잠기게 되기 때문입니다. 합계가 lock_capacity 를 초과하면, max_locks_per_transactionlock_capacity 이 총합을 초과할 때까지 증가시킵니다. 이 변경 사항으로 인해 데이터베이스가 재시작되므로, 업그레이드를 제출하기 전에 변경을 완료하십시오. 테이블이 많거나 대용량 객체가 있는 경우에도 변환 시간이 길어지므로, 실제 스키마와 데이터를 사용하여 업그레이드 과정을 미리 테스트해 보십시오.

    SELECT pg_catalog.current_database() AS database_name,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_class AS c
            WHERE (c.relkind IN ('r', 'p', 'S')
                   OR (c.relkind IN ('v', 'm')
                       AND pg_catalog.current_setting('server_version_num')::integer < 160000))
              AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                         'information_schema'::pg_catalog.regnamespace)) AS locked_relations,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_largeobject_metadata) AS large_objects,
           pg_catalog.current_setting('max_locks_per_transaction')::integer
             * (pg_catalog.current_setting('max_connections')::integer
                + pg_catalog.current_setting('max_prepared_transactions')::integer) AS lock_capacity;
    
  17. search_path 설정이 없는 함수, 인덱스, 구체화된 뷰 및 확장 통계가 사용하는 함수. 이 쿼리는 연산자, 도메인 검사 제약 조건 및 SQL 표준 본문을 따르는 함수를 통해 호출을 수행합니다. PostgreSQL 16 이하 버전에서 PostgreSQL 17 이상 버전으로 업그레이드하는 경우 이 쿼리를 실행하십시오. 본문에서 pg_catalog 외부의 객체를 스키마 없이 명시하는 리스트된 함수는, 업그레이드 후 유지 관리 명령이 실패하게 만듭니다. 함수는 그 본문과 해당 함수가 호출하는 모든 함수가, pg_catalog 외부의 모든 객체를 해당 스키마로 명명하는 경우에만 영향을 받지 않습니다. 나열된 다른 각 함수에 대해서는, 해당 함수의 소유자가 인덱스, 파티션 키 및 생성된 열에서의 SQL 함수 에 설명된 대로 ‘ search_path ’ 설정을 추가합니다.

    WITH RECURSIVE refreshed (relid, used_by) AS (
      SELECT c.oid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind = 'm'
      UNION
      SELECT v.oid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
       AND d.refclassid = 'pg_catalog.pg_class'::pg_catalog.regclass
      JOIN pg_catalog.pg_class AS v ON v.oid = d.refobjid AND v.relkind = 'v'
    ), refs (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c ON c.oid = d.objid AND c.relkind IN ('i', 'I')
      WHERE d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
      UNION
      SELECT d.refclassid, d.refobjid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
      UNION
      SELECT d.refclassid, d.refobjid, s.stxrelid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s ON s.oid = d.objid
      WHERE d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
    ), used (fn, used_by) AS (
      SELECT x.fn, r.used_by
      FROM refs AS r
      CROSS JOIN LATERAL (
        SELECT r.refobjid AS fn
        WHERE r.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE r.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = r.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE r.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = r.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND NOT EXISTS (SELECT 1
                       FROM pg_catalog.unnest(p.proconfig) AS setting
                       WHERE setting LIKE 'search\_path=%')
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT p.oid::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname NOT IN ('c', 'internal')
      AND p.prosqlbody IS NULL
      AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                 'information_schema'::pg_catalog.regnamespace)
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.unnest(p.proconfig) AS setting
                      WHERE setting LIKE 'search\_path=%')
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    

이러한 검사를 통과한다고 해서 업그레이드가 반드시 성공하거나 애플리케이션이 대상 버전과 호환된다는 보장은 없습니다. 스테이징 배포 환경에서는 리허설 단계에서만 전체 변환이 실행됩니다.

업그레이드 기간 계획 수립

시뮬레이션 리허설을 통해 유지보수 시간을 예측하십시오. 변환 시간은 주로 데이터베이스와 개체의 수에 따라 달라집니다. HA 구성원을 재구축하는 데 걸리는 시간은 데이터베이스의 크기에 따라 달라집니다. 작업 부하와 트랜잭션 로그의 양은 검사 및 캐치업 작업에 영향을 미칩니다. 쓰기 작업이 차단되는 시간뿐만 아니라 전체 업그레이드 작업에 소요되는 시간을 충분히 확보하십시오.

'시작 만료 시간'은 대기열에 있는 업그레이드가 시작될 수 있는 가장 늦은 시간을 설정합니다. 기본값은 요청 후 5분이며, 최대 24시간 앞까지 설정할 수 있습니다. 백업과 같은 작업이 실행 중이거나 이전에 대기열에 등록된 요청이 있는 경우 시작이 지연됩니다. 만료 시간 전에 업그레이드가 시작되지 않으면 업그레이드가 실행되지 않으며, 해당 작업 상태는 ‘만료됨’으로 표시됩니다. 만료되어도 이미 시작된 업그레이드는 중단되지 않습니다. 예를 들어, 대기 중인 요청은 UTC 기준 22:30에 만료됩니다. UTC 기준 22:25에 시작되는 작업은 해당 시간을 넘어서도 계속될 수 있습니다.

업그레이드가 진행되는 동안, 배포와 관련된 다른 요청들은 업그레이드가 완료될 때까지 대기합니다. 여기에는 수동 및 자동 스케일링, 구성 변경, 사용자 및 비밀번호 변경, 허용된 IP 주소 변경, 백업 등이 포함됩니다. 업그레이드 작업이 대기 중이거나 실행 중인 동안에는 배포를 삭제하지 마십시오.

작업이 완료될 때까지 읽기 전용 복제본을 생성하지 마십시오. 이 서비스는 이러한 요청을 차단하지 않습니다. 이를 생성할 경우, 업그레이드의 사전 검사가 실패하거나, 새로운 복제본이 업그레이드된 배포 환경에서 데이터를 복제하지 못할 수 있습니다. 해당 복제본을 삭제하고, 작업이 완료된 후 새 복제본을 생성하십시오.

UI에서 업그레이드

  1. 주문형 백업을 생성하고 확인합니다. 이 업그레이드에는 시간이 걸리지 않습니다.
  2. 배포의 ‘개요 ’ 페이지에서 ‘메인 버전 업그레이드’를 클릭합니다.
  3. ‘안내’ 단계에서 안내 내용을 확인하고, ‘안내를 읽었으며 업그레이드를 진행할 준비가 되었습니다’를 선택한 다음 ‘다음’을 클릭하십시오. 읽기 및 쓰기 작업이 불가능한 시기를 확인하려면 ‘업그레이드 중 가용성’을 참조하십시오.
  4. '버전 업그레이드'에서 대상 버전을 선택하십시오. 사용 가능한 대상이 두 개 이상인 경우, 목록에서는 기본적으로 가장 최근의 대상을 선택합니다. 이 단계에 있는 ‘읽기 복제본 ’ 관련 안내문은 최신 정보가 아닙니다. 배포에 읽기 전용 레플리카가 하나라도 연결되어 있는 상태에서는 업그레이드의 사전 검사가 실패하므로, 업그레이드하기 전에 모든 레플리카를 승격하거나 삭제하십시오.
  5. '업그레이드 시작 대기 시간 '에서 요청이 시작되기까지 대기할 수 있는 시간을 선택하십시오. 기본값은 5분입니다.
  6. 업그레이드를 클릭하십시오. 요청이 대기 중이거나 실행 중인 동안, ‘개요’ 페이지의 ‘버전’ 열에는 ‘업그레이드 대기 중’ 또는 ‘업그레이드 진행 중’이 표시됩니다.
  7. ‘최근 작업 ’에서 해당 작업을 확인하세요. 쓰기 작업이 재개되는 즉시, ‘업그레이드 후’ 섹션에 설명된 대로 통계를 새로 고침하십시오. 작업 상태가 ‘완료’로 표시되면 해당 섹션의 나머지 단계를 완료하세요. '실패'로 표시되면 '문제 해결'을 참조하십시오. '만료됨'으로 표시된다면 업그레이드가 시작되지 않은 것이므로, 만료일을 더 늦게 설정하여 다시 제출할 수 있습니다.

API를 통한 업그레이드

/deployments/{id}/version 엔드포인트로 PATCH 요청을 전송합니다. version 를 대상 메이저 버전으로 설정하고, expiration_datetime 쿼리 매개변수를 사용하여 만료 시작 시점을 설정합니다:

curl -X PATCH \
  'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version?expiration_datetime=<EXPIRATION_TIME>' \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"version": "18"}'

<EXPIRATION_TIME> 을 요청 후 5분에서 24시간 사이의 ISO 8601 형식의 UTC 시간(예: 2026-11-03T22:30:00Z)으로 대체하십시오. expiration_datetime 를 생략하면, 요청이 5분 이내에 시작되지 않을 경우 만료됩니다.

요청이 성공하면 태스크가 반환됩니다. 승인된 요청이 곧 업그레이드가 완료된 것은 아닙니다. 업그레이드 진행 상황을 모니터링하려면 ‘작업 정보 가져오기 ’에서 작업 ID를 사용하세요. 사용 가능한 대상을 나열하려면, ‘ versions ’ 기능을 사용하여 배포에서 기능 정보를 검색하십시오. 모든 매개변수에 대한 자세한 내용은 API 참조 문서를 참조하십시오.

CLI를 통한 업그레이드

Cloud Databases CLI 플러그인의 버전 0.20.0 이상을 사용하십시오. --expire-in 또는 --expire-at 를 사용하여 요청 후 5분에서 24시간 사이의 만료 시작 시간을 설정하십시오. 기본값은 5분입니다.

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait

--nowait 가 없으면, 명령은 작업이 완료되거나 실패할 때까지 대기합니다. 업그레이드가 시작되기도 전에 만료되는 경우 반환되지 않으므로, 스크립트에서는 --nowait 를 사용하십시오. --nowait 를 사용하면, 서비스가 요청을 수락한 후 명령어가 반환됩니다. 다음 명령어로 작업을 모니터링합니다. deployment-tasks-list:

ibmcloud cdb deployment-tasks-list <NAME|CRN>

모든 매개변수에 대해 ibmcloud cdb deployment-version-upgrade --help 를 실행하십시오.

테라폼을 통한 업그레이드

IBM Cloud® 용 Terraform 프로바이더 버전 1.79.2 이상을 사용하십시오. version 를 사용 가능한 대상으로 설정하고, 계획을 검토한 후 적용하십시오. 대상 시스템에서 제자리 업그레이드를 수행할 수 없는 경우 이 계획은 실패합니다.

리소스의 업데이트 타임아웃을 전체 업그레이드 과정이 완료될 수 있을 만큼 충분히 길게, 그리고 최소 5분으로 설정하십시오. 또한 해당 제공자는 최대 24시간인 이 타임아웃을 만료 시작 시점으로 사용합니다. 따라서 대기 중인 업그레이드는 타임아웃이 만료될 때까지 언제든지 시작될 수 있습니다. 백업이나 기타 작업이 실행 중이거나 대기열에 등록되어 있지 않을 때 변경 사항을 적용하여 업그레이드가 즉시 시작되도록 하십시오. 업그레이드가 시작된 후 적용 작업이 시간 초과되더라도 업그레이드는 계속 진행됩니다. 타임아웃 시간이 경과했을 때 업그레이드가 여전히 대기 중이라면, 해당 업그레이드는 만료되어 실행되지 않습니다. terraform plan 또는 terraform apply 을 다시 실행하기 전에 작업이 완료될 때까지 기다리십시오.

업그레이드 작업이 실패한 경우, ‘ terraform apply ’을 다시 실행하기 전에 문제 해결 단계를 완료하십시오. 배포 상태가 여전히 소스 버전을 보고할 때마다 Terraform은 업그레이드를 다시 실행합니다.

Terraform 외부에서 업그레이드를 수행한 후에는 version 을 새 버전으로 설정하거나, 구성에서 version 을 제거하십시오. Terraform 외부의 업그레이드에는 UI, CLI 또는 API의 업그레이드와 강제 업그레이드가 포함됩니다. 구성을 업데이트하기 전까지는, 해당 배포가 포함된 모든 terraform plan 및 terraform apply 요청이 실패하며, 이로 인해 동일한 구성 내의 다른 리소스에 대한 변경이 불가능해집니다. 이 오류는 Version 14 is not a valid upgrade version 또는 No available upgrade versions for version 18 에 나와 있는 오류와 유사합니다.

PostgreSQL 에서는 version_upgrade_skip_backup 인수가 지원되지 않습니다. 자세한 내용은 데이터베이스 리소스 참조를 참조하십시오.

업그레이드 후

쓰기 작업이 재개되는 즉시, 최적화기 통계가 완벽하게 업데이트되었는지 확인하십시오. 태스크가 완료될 때까지 기다리지 않습니다. SHOW default_transaction_read_only; 가 새 세션에서 off 를 반환하면 쓰기 작업이 재개됩니다. 각 데이터베이스에서 다음 쿼리를 실행하면 통계가 없는 테이블과 물질화된 뷰 목록을 확인할 수 있습니다. 나열된 각 관계에 대해 ANALYZE <table_name>; 을 실행하십시오. 사용자에게 관계 분석 권한이 없는 경우, 관계 소유자로서 해당 명령을 실행하십시오. 분할된 테이블을 분석하면 해당 테이블의 파티션도 함께 분석됩니다.

SELECT c.oid::pg_catalog.regclass AS relation_name
FROM pg_catalog.pg_class AS c
WHERE c.relkind IN ('r', 'm', 'p')
  AND c.reltuples < 0
  AND NOT c.relispartition
  AND c.relpersistence <> 't'
  AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                             'information_schema'::pg_catalog.regnamespace)
  AND NOT EXISTS (SELECT 1
                  FROM pg_catalog.pg_depend AS e
                  WHERE e.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                    AND e.objid = c.oid
                    AND e.deptype = 'e');

PostgreSQL 17 및 이후 버전에서 ANALYZE 명령을 실행하면 “ function ... does not exist ”와 같은 오류가 발생하여 실패할 수 있습니다. 그렇다면, 자체 점검 쿼리 17에 나열된 함수를 수정하고, ANALYZE 를 다시 실행하십시오. 오류로 인해 중단된 데이터베이스 전체에 대한 ANALYZE 은 나머지 테이블을 분석하지 않습니다. PostgreSQL 18에서는 psql 명령어( \dX)로 나열된 통계 개체가 있는 각 테이블과 PostGIS 열을 포함하는 각 테이블을 추가로 분석해야 합니다. 업그레이드 과정에서 이러한 통계는 이전되지 않기 때문입니다.

작업 상태가 ‘완료’로 표시된 후:

  1. 콘솔이나 API에서 배포의 버전이 목표 버전으로 표시되는지, 그리고 SHOW server_version; 에서 해당 버전이 반환되는지 확인하십시오. 자체 점검 쿼리 1을 실행하고, 모든 HA 구성원이 스트리밍 중인지 확인하십시오. 또한 모든 데이터베이스에서 쓰기 작업이 재개되었는지 확인하십시오. 다음 쿼리를 실행하면 행이 반환되지 않습니다. HA 구성원이 누락되었거나, ‘ pg_basebackup ’라는 이름의 행이 남아 있거나, 쿼리 결과에 데이터베이스가 표시되는 경우 지원팀에 문의하십시오.

    SELECT d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase
    WHERE s.setrole = 0
      AND d.datallowconn
      AND NOT d.datistemplate
      AND EXISTS (SELECT 1
                  FROM pg_catalog.unnest(s.setconfig) AS c(setting)
                  WHERE c.setting LIKE 'default_transaction_read_only=%');
    
  2. 확장 프로그램을 업데이트하세요. 이 업그레이드를 수행하면 각 확장 프로그램은 설치된 버전을 그대로 유지합니다. 각 데이터베이스에서 최신 버전이 있는 확장 프로그램을 나열하고, 각각을 업데이트하십시오:

    SELECT name, installed_version, default_version
    FROM pg_catalog.pg_available_extensions
    WHERE installed_version <> default_version;
    
    ALTER EXTENSION <extension_name> UPDATE;
    

    PostgreSQL 14, 15 또는 16에서 PostgreSQL 17 이상으로 업그레이드한 경우, pg_stat_statements 를 업데이트하면 해당 테이블의 blk_read_time 및 blk_write_time 열 이름이 shared_blk_read_time 및 shared_blk_write_time 로 변경됩니다. 이 열들을 읽어오는 쿼리를 업데이트하십시오.

  3. 준비 단계에서 설명한 대로 확장 및 마스킹을 복원합니다. 내보낸 내용을 바탕으로 ‘ UNLOGGED ’ 테이블을 다시 불러오십시오. 각 UNLOGGED 시퀀스를 현재 사용 중인 값보다 큰 값으로 설정하십시오. 예를 들어, SELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));``와 같이 설정할 수 있습니다. 삭제했던 논리적 복제 슬롯, 구독 및 읽기 전용 복제본을 다시 생성하고, 비활성화했던 구독을 활성화하십시오. 종속 애플리케이션을 다시 시작하기 전에 소비자를 다시 연결하고 데이터를 재동기화하십시오.

  4. 데이터베이스에 대해 default_transaction_read_only 를 설정한 경우, 다시 설정하십시오. 이 업그레이드를 수행하면 모든 데이터베이스에서 이 설정이 초기화되므로, 해당 데이터베이스들은 다시 쓰기 작업을 허용하게 됩니다.

  5. 업그레이드 후 백업 이 완료되었는지 확인하십시오. 데이터베이스 전체를 복사하기 때문에 몇 시간이 걸릴 수 있습니다. 업그레이드 이후에 발생한 변경 사항에 대해 특정 시점 복구(point-in-time recovery)가 필요한 경우, 그때까지 애플리케이션의 쓰기 작업을 일시 중지해 두십시오.

  6. PostgreSQL 14 또는 15에서 PostgreSQL 16 이상으로 업그레이드한 경우, ‘버전 업그레이드 시 발생하는 역할 권한 문제’ 문서에 설명된 역할 쿼리를 실행하십시오. 역할을 관리하는 작업을 재개하기 전에 나열된 역할에 권한을 부여하십시오.

  7. Terraform이 배포를 관리하고 있는데 Terraform 외부에서 업그레이드를 수행한 경우, Terraform을 통한 업그레이드 에 설명된 대로 version 을 새 버전으로 설정하거나 제거하십시오.

  8. 일시 중지했던 애플리케이션 쓰기 작업과 예약된 작업을 다시 시작합니다. synchronous_commit 와 같이 업그레이드를 위해 변경한 설정을 원래대로 복원하십시오.

  9. 최신 버전의 PostgreSQL 에서는 최신 유니코드 데이터를 사용하므로, 유니코드 데이터에 의존하는 객체를 다시 빌드하십시오:

    • PostgreSQL 16에서 PostgreSQL 17로 업그레이드한 경우가 아니라면, 인덱스, 물질화된 뷰, 제약 조건, 그리고 표현식에 normalize() 또는 is_normalized()``을 사용하는 파티션 키를 확인하십시오. 후속 유니코드 버전에서 새로 추가된 문자가 포함된 텍스트에만 영향을 미칩니다.
    • PostgreSQL 17에서 PostgreSQL 18로 업그레이드한 경우, unicode_assigned() 를 사용하는 개체도 확인하십시오. 또한 내장된 ‘ C.UTF-8 ’ 로케일에서 텍스트에 정규 표현식( ILIKE, lower(), upper() 또는 initcap() )을 적용하는 객체들도 확인해 보십시오. pg_c_utf8 정렬 방식과, C.UTF-8 와 함께 builtin 로케일 제공자를 사용하는 데이터베이스는 이 로케일을 사용합니다.
    • PostgreSQL 18로 업그레이드한 후, 데이터베이스에서 ‘ icu ’ 또는 ‘ builtin ’ 로케일 제공자를 사용하는 경우, 해당 데이터베이스의 전체 텍스트 검색 인덱스와 pg_trgm 인덱스를 다시 생성하십시오.

    영향을 받는 각 인덱스에 대해 REINDEX INDEX <index_name>; 을, 영향을 받는 각 물질화된 뷰에 대해 REFRESH MATERIALIZED VIEW <view_name>; 을 실행하십시오. 해당 행들이 여전히 영향을 받는 체크 제약 조건을 충족하고 올바른 파티션에 속해 있는지 확인하십시오.

  10. 애플리케이션의 동작 및 성능을 스테이징 환경의 결과와 비교해 보십시오.

문제점 해결

서비스에서 요청을 거부하면 오류가 즉시 표시됩니다. UI에는 대개 “업그레이드에 실패했습니다”라는 메시지와 함께 그 이유가 표시되며, API는 오류 메시지를 반환하고, CLI는 힌트와 함께 오류 메시지를 출력합니다. 요청 내용을 수정하신 후 다시 제출해 주세요.

작업 상태가 ‘만료됨’으로 표시된다면, 업그레이드가 시작되지 않았으며 배포 상태는 변경되지 않은 것입니다. 다른 작업이 실행 중이거나 대기열에 등록되어 있지 않을 때 업그레이드를 다시 제출하거나, 시작 만료 시간을 더 늦게 설정하십시오.

나중에 ‘실패’로 표시되는 작업의 경우, 어떤 검사나 단계에서 실패했는지 명확히 표시되지 않으며, UI에도 그 원인이 표시되지 않습니다. 실패한 단계에 따라 배포는 다음 상태 중 하나를 가질 수 있습니다:

  • 소스 버전에 대해: 배포 시 소스 버전이 실행되며 쓰기 작업을 허용합니다. 사전 검사 실패 시 배포는 이 상태로 유지되며, 읽기 전용 모드에서 발생하는 대부분의 오류 발생 후 서비스는 쓰기 권한을 복원합니다. 실패한 시도라도 여전히 오래 지속되는 영향을 미칠 수 있다. 이 작업은 old_snapshot 를 제거하고, UNLOGGED 테이블을 비우며, UNLOGGED 시퀀스를 초기화할 수 있으며, PITR 적용 범위에 공백을 남길 수 있습니다. 또한 데이터베이스 수준의 ‘ default_transaction_read_only ’ 설정을 초기화하여, 해당 데이터베이스가 다시 쓰기 작업을 허용하도록 할 수 있습니다. 어떤 데이터베이스에 대해든 default_transaction_read_only 을 on 으로 설정하면, 사전 검사에서 오류가 발생하더라도 시도 실패 시 모든 클라이언트 세션이 종료됩니다.
  • 대상 버전에 관하여: 배포 과정에서는 대상 버전이 실행되지만, 지원 팀이 업그레이드 절차를 완료하기 전까지는 업그레이드가 완료된 것으로 간주되지 않습니다. 콘솔과 API에서는 여전히 소스 버전을 표시할 수 있습니다. 그때까지는 HA 구성원이 실행되지 않을 수 있으며, 백업 및 트랜잭션 로그 아카이빙이 실패할 수 있습니다. 자체 점검 쿼리 1 또는 5에서 문제가 발견되면, 지원팀이 업그레이드를 완료할 때까지 애플리케이션의 쓰기 작업을 일시 중지하십시오.
  • 오류 상태: 지원팀이 문제를 해결할 때까지 배포는 읽기 전용 상태로 유지되거나 사용할 수 없는 상태가 되거나, HA 구성원 없이 실행됩니다. 변환 또는 재시작 단계에서 오류가 발생하면, 쓰기 작업이 재개된 후에도 지원팀이 다시 시작할 때까지 HA 구성원이 중지된 상태로 남아 있을 수 있습니다.

상태를 확인하려면 admin 로 접속한 후 SHOW server_version; 를 실행하십시오. 사용 중인 각 데이터베이스에서 SHOW default_transaction_read_only;`` 명령을 실행하십시오. 자체 점검 쿼리 1을 실행하여 모든 HA 구성원이 스트리밍 중인지 확인하십시오. 작업이 실패한 후(예: 인증 오류로 인해) admin 에 연결할 수 없는 경우, 지원팀에 문의하십시오. 이번 업그레이드로 인해 귀하의 인증 정보는 변경되지 않습니다.

배포가 쓰기 작업을 허용하고, 소스 버전을 실행 중이며, 모든 HA 구성원이 스트리밍 중이라면, 사전 점검 항목을 검토하고 자체 점검 쿼리를 실행하십시오. 해결되지 않은 항목을 모두 처리하고, 필요 시 백업을 수행한 다음, 업그레이드를 다시 제출하십시오. 그 외의 모든 경우, 또는 다음 시도에서도 실패할 경우, 다시 시도하거나 다른 변경 사항을 적용하기 전에 지원팀에 문의하십시오. 다음을 포함:

  • 배포 CRN 및 실패한 작업 ID. 작업이 실패할 경우 작업 ID를 기록해 두세요. 작업 목록에는 최근 작업만 표시되기 때문입니다.
  • 소스 및 요청된 대상 PostgreSQL 버전, 그리고 SHOW server_version; 의 출력 결과.
  • 대략적인 장애 발생 시간 및 시간대.
  • 애플리케이션이 연결, 읽기 및 쓰기 작업을 수행할 수 있는지 여부.
  • 자체 점검 쿼리의 결과.
  • 최근에 승격되거나 삭제된 복제본을 포함하여, 각 관련 읽기 전용 복제본의 CRN.

요청이 내부 오류로 인해 실패할 경우, 지원팀에 문의하십시오. 사용자 인터페이스(UI)에서는 이 오류가 “인플레이스 업그레이드 작업 생성에 실패했습니다.”라는 메시지와 함께 “업그레이드에 실패했습니다.”라고 표시됩니다. UI는 실제 거절 사유를 표시할 수 없는 경우, 다른 거절된 요청에 대해서도 이 메시지를 표시합니다. 사유를 확인하려면 CLI 또는 API를 사용하여 요청을 제출하십시오. 또한 작업이 리허설 때보다 훨씬 더 오랫동안 진행 중인 상태라면 지원팀에 문의해 주세요. 실패 후, 서비스가 복구를 시도하는 동안 해당 작업은 진행 중 상태로 유지될 수 있습니다(CLI 및 API에서 상태: running ).

준비 단계와 자가 점검 질문 항목에 명시된 개체만 제거하십시오. 검문을 통과하기 위해 다른 물건을 떨어뜨리지 마십시오. 대신 고객 지원팀에 문의해 주세요.

읽기 전용 복제본에서 업그레이드

소스 배포를 기반으로 읽기 전용 복제본을 생성하고, 복제본이 동기화될 때까지 기다립니다. 그런 다음, /remotes/promotion 엔드포인트를 사용하여 레플리카를 프로모션하고 업그레이드합니다. version 를 레플리카가 자신의 기능 목록에 포함하고 있는 대상으로 설정하십시오:

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "promotion": {
        "version": "18",
        "skip_initial_backup": false
    }
}'

승격 과정에서 수행되는 초기 백업을 건너뛰고 싶은 경우에만 skip_initial_backup 을 true 으로 설정하십시오. 이 설정을 사용하면 승격 작업을 단축할 수 있지만, 승격된 배포 환경의 복구를 위해서는 추후 예약 백업 또는 수동 백업을 성공적으로 수행해야 합니다.

버전 업그레이드가 포함된 승격 작업이 실패하면, 서비스는 승격된 배포를 비활성화합니다. 지원 부서에 문의하십시오. 해당 배포를 실제 환경에서 사용하기 전에, 스테이징 배포의 복제본에서 버전 업그레이드를 적용한 프로모션을 미리 테스트해 보십시오.

백업을 복원하여 업그레이드하기

지원되는 대상 버전을 사용하는 배포 환경에 백업을 복원합니다. CLI 또는 API를 사용하여 백업을 복원할 때 리소스 할당 매개변수를 지정하지 않으면, 새로운 배포는 백업이 생성되었을 당시 원본 배포가 가지고 있던 리소스 할당 설정을 사용합니다. UI에서 복원 페이지는 소스 배포의 현재 할당량으로 시작되며, 사용자는 이를 변경할 수 있습니다.

UI에서 백업 복원

배포 대시보드의 ‘백업 및 복원’에서 사용하려는 백업에 대해 ‘백업 복원’을 클릭합니다. 열린 페이지에서 ‘데이터베이스 버전’ 항목에서 지원되는 대상 버전을 선택하고, 새 배포에 대한 옵션을 구성하십시오. 그런 다음 ‘백업 복원’을 클릭하세요.

CLI를 통해 백업 복원하기

-p 의 JSON 인자에 대상 버전과 백업 ID를 지정하여 배포를 생성합니다:

ibmcloud resource service-instance-create example-upgrade databases-for-postgresql standard us-south \
  -p '{
  "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version": "18"
}' \
  --service-endpoints "public"

API를 통해 백업 복원

Resource 컨트롤러 API를 사용하여 백업을 대상 버전이 실행되는 새로운 배포 환경으로 복원하십시오. 배포 이름, 위치, 리소스 그룹, 플랜, 백업 ID 및 대상 버전을 지정하십시오:

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-postgresql-standard",
    "parameters": {
      "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
      "version": "18"
    }
  }'

강제 업그레이드

지원 종료일 이후에는, 더 이상 사용되지 않는 버전을 실행 중인 모든 활성 Databases for PostgreSQL 배포 환경이 자동으로 다음 지원 버전으로 업그레이드됩니다.

강제 업그레이드는 IPMVU에 해당하므로, 지원 종료일 전에 IPMVU 준비 절차를 완료하십시오.

다음과 같은 위험을 피하려면 사용 기간 종료일 전에 업그레이드하세요:

  • 이러한 유형의 강제 업그레이드에는 SLA가 제공되지 않습니다.
  • 데이터가 일부 손실될 수 있습니다.
  • 서비스 이용에 장시간 중단이 발생할 수 있습니다.
  • 응용 프로그램이 새 버전과 호환되지 않으면 작동하지 않을 수 있습니다.
  • 이 업그레이드가 배포에 적용되는 시기를 제어할 수는 없습니다.
  • 이 강제 업그레이드에는 롤백 프로세스가 없습니다.
  • Terraform이 배포를 관리하고 version를 설정하는 경우, 강제 업그레이드 후에는 ` `version를 업데이트할 때까지 모든 terraform plan 호출이 실패합니다.

지원 종료 일정에 대해서는 버전 정책 페이지를 참조하십시오.

버전 업그레이드 시 발생하는 역할 권한 문제

PostgreSQL 16 및 이후 버전에서는 admin 와 같이 ‘ CREATEROLE ’ 속성이 지정된 역할의 경우, 이를 관리하려면 다른 역할에 ‘ ADMIN OPTION ’가 설정되어 있어야 합니다. 역할을 관리한다는 것은 해당 역할의 비밀번호나 속성을 변경하거나, 역할을 삭제하거나, 해당 역할에 대한 멤버십을 부여하는 것을 포함합니다. PostgreSQL 14 또는 15에서 16 이상으로 업그레이드하더라도, 업그레이드 이전에 존재하던 역할에 대해서는 admin 에서 이 옵션을 사용할 수 없습니다. admin 와 같은 역할을 관리하는 작업(예: 비밀번호 주기적 변경)은 실패하게 됩니다. 자세한 내용은 ‘ PostgreSQL 16’ 릴리스 노트, 역할 속성 및 역할 권한 부여 항목을 참조하십시오.

예를 들어, 비밀번호 변경 시 다음과 같은 오류가 발생합니다:

ERROR:  permission denied to alter role
DETAIL:  To change another role's password, the current user must have the CREATEROLE attribute and the ADMIN option on the role.

업그레이드하기 전에 admin 권한으로 다음 쿼리를 실행하십시오. 이 문서에는 UI, CLI 또는 API를 통해 직접 생성한 사용자를 제외하고, 업그레이드 후 admin 에서 관리할 수 없는 역할들이 나열되어 있습니다. PostgreSQL 16 및 이후 버전에서는 admin 을 통해서도 해당 사용자를 변경할 수 없으므로, UI나 CLI, API를 통해 관리해야 합니다.

SELECT r.rolname AS role_name,
       pg_catalog.pg_has_role(r.oid, 'admin'::name, 'MEMBER') AS member_of_admin
FROM pg_catalog.pg_roles AS r
WHERE NOT r.rolsuper
  AND NOT r.rolreplication
  AND r.rolname <> 'admin'
  AND r.rolname !~ '^(pg_|ibm-)'
  AND NOT EXISTS (
      SELECT 1
      FROM pg_catalog.pg_auth_members AS m
      JOIN pg_catalog.pg_roles AS b ON b.oid = m.roleid
      WHERE m.member = r.oid
        AND b.rolname IN ('ibm-cloud-base-user', 'ibm-cloud-base-user-ro'))
  AND NOT pg_catalog.pg_has_role(r.oid, 'MEMBER WITH ADMIN OPTION')
ORDER BY 1;

상세 역할에 대한 관리 권한을 유지하려면, 업그레이드하기 전에 해당 역할을 admin 에 부여하십시오:

GRANT <role_name> TO admin WITH ADMIN OPTION;

member_of_admin 값이 t 인 역할에 대해서는 이 권한 부여가 실패합니다. 해당 역할이 admin 의 구성원이기 때문입니다. 업그레이드 후, admin 에서는 해당 역할을 관리할 수 없습니다.

PostgreSQL 16 이상으로 업그레이드한 후 쿼리를 다시 실행하십시오. member_of_admin 값이 f 인 각 나열된 역할에 대해, ibmclouddb 또는 postgres 을 제외한 모든 데이터베이스에 연결된 상태에서 다음 헬퍼를 실행하십시오. 다른 역할은 포함하지 마십시오. 한 건의 지원이 거부되면 전체 공모가 무효화되기 때문입니다. 이 헬퍼는 여러 번 실행해도 안전합니다:

SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');

두 가지 권한 부여를 통해 admin 도 해당 역할의 구성원이 되므로, admin 은 해당 역할의 권한을 사용할 수 있습니다.

주 PostgreSQL 버전에 대한 변경 로그