선택적으로 이전 클러스터 이동

버전별 설치 디렉토리를 사용하는 경우, 예:/opt/PostgreSQL/18, 이전 클러스터를 이동할 필요가 없습니다. 그래픽 설치 프로그램은 모두 버전별 설치 디렉터리를 사용합니다.

설치 디렉토리가 특정 버전이 아닌 경우, 예:/usr/local/pgsql, 새로운 PostgreSQL 설치 디렉토리를 방해하지 않도록 현재 PostgreSQL 설치 디렉토리를 이동해야 합니다.포스트그레SQL설치. 일단 현재포스트그레SQL서버가 종료되었으므로 PostgreSQL 설치 디렉터리의 이름을 바꾸는 것이 안전합니다. 이전 디렉토리가 다음과 같다고 가정합니다./usr/local/pgsql, 다음을 수행할 수 있습니다.

mv /usr/local/pgsql /usr/local/pgsql.old

디렉토리 이름을 바꾸려면.

소스 설치의 경우 새 버전을 빌드하세요.

다음을 사용하여 새로운 PostgreSQL 소스를 빌드하세요.구성이전 클러스터와 호환되는 플래그.pg_upgrade확인하겠습니다pg_controldata업그레이드를 시작하기 전에 모든 설정이 호환되는지 확인하세요.

새 PostgreSQL 바이너리 설치

새 서버의 바이너리와 지원 파일을 설치하십시오.pg_upgrade기본 설치에 포함되어 있습니다.

소스 설치의 경우, 사용자 정의 위치에 새 서버를 설치하려면 다음을 사용하십시오.접두사변수:

make prefix=/usr/local/pgsql.new install

새 PostgreSQL 클러스터 초기화

다음을 사용하여 새 클러스터를 초기화합니다.initdb. 다시 말하지만, Compatible을 사용하세요.initdb기존 토토 핫와 일치하는 플래그. 많은 사전 구축된 설치 프로그램이 이 단계를 자동으로 수행합니다. 새 토토 핫를 시작할 필요가 없습니다.

확장 공유 개체 파일 설치

많은 확장 및 사용자 정의 모듈, 여부기여또는 다른 소스, 공유 개체 파일(또는 DLL)을 사용합니다. 예:pgcrypto.so. 이전 클러스터에서 이를 사용한 경우 일반적으로 운영 체제 명령을 통해 새 서버 바이너리와 일치하는 공유 개체 파일을 새 클러스터에 설치해야 합니다. 스키마 정의를 로드하지 마십시오(예:확장 프로그램 생성 pgcrypto, 이는 이전 클러스터에서 복제되기 때문입니다. 확장 업데이트를 사용할 수 있는 경우,pg_upgrade이를 보고하고 나중에 업데이트하기 위해 실행할 수 있는 스크립트를 생성할 것입니다.

사용자 정의 전체 텍스트 검색 파일 복사

이전 클러스터에서 새 클러스터로 사용자 정의 전체 텍스트 검색 파일(사전, 동의어, 동의어 사전, 중지 단어)을 복사합니다.

인증 조정

pg_upgrade이전 서버와 새 서버에 여러 번 연결하므로 인증을 다음으로 설정하는 것이 좋습니다.동료에pg_hba.conf또는 다음을 사용하세요~/.pgpass파일(참조메이저 토토 사이트 : 문서 : 18 : 32.16. 암호 파일).

두 서버 모두 중지

Unix에서 두 데이터베이스 서버가 모두 중지되었는지 확인하세요. 예:

pg_ctl -D /opt/PostgreSQL/12 중지
pg_ctl -D /opt/PostgreSQL/18 중지

또는 Windows에서는 적절한 서비스 이름을 사용합니다.

NET STOP postgresql-12
NET STOP postgresql-18

이 종료 중에 스트리밍 복제 및 로그 전달 대기 서버가 실행되어 모든 변경 사항을 수신해야 합니다.

대기 서버 업그레이드 준비

섹션에 설명된 방법을 사용하여 대기 서버를 업그레이드하는 경우11단계, 다음을 실행하여 이전 대기 서버가 따라잡았는지 확인하세요.pg_controldata이전 기본 및 대기 클러스터에 대해. 다음을 확인하세요.“최신 체크포인트 위치”모든 클러스터에서 값이 일치합니다. 또한 다음 사항을 확인하세요.wal_level다음으로 설정되지 않았습니다.최소에서postgresql.conf새 기본 토토 핫에 파일을 추가합니다.

실행pg_upgrade

항상 다음을 실행하세요pg_upgrade이전 서버가 아닌 새 서버의 바이너리.pg_upgrade이전 클러스터와 새 클러스터의 데이터 및 실행 파일 사양이 필요합니다. (빈) 디렉토리. 사용자 및 포트 값을 지정하고 기본 복사 동작 대신 데이터 파일을 연결, 복제 또는 교체할지 여부를 지정할 수도 있습니다.

링크 모드를 사용하면 업그레이드가 훨씬 빨라지고(파일 복사 없음) 디스크 공간을 덜 사용하지만 업그레이드 후 새 클러스터를 시작하면 이전 클러스터에 액세스할 수 없습니다. 또한 링크 모드에서는 이전 클러스터 데이터 디렉터리와 새 클러스터 데이터 디렉터리가 동일한 파일 시스템에 있어야 합니다. (테이블스페이스 및pg_wal다른 파일 시스템에 있을 수 있습니다.) 복제 모드는 동일한 속도와 디스크 공간 이점을 제공하지만 새 클러스터가 시작된 후에 이전 클러스터를 사용할 수 없게 되는 것은 아닙니다. 또한 복제 모드에서는 이전 데이터 디렉터리와 새 데이터 디렉터리가 동일한 파일 시스템에 있어야 합니다. 이 모드는 특정 운영 체제 및 파일 시스템에서만 사용할 수 있습니다. 관계가 많은 경우 스왑 모드가 가장 빠를 수 있지만 파일 전송 단계가 시작되면 이전 클러스터에 액세스할 수 없습니다. 또한 스왑 모드에서는 이전 클러스터 데이터 디렉터리와 새 클러스터 데이터 디렉터리가 동일한 파일 시스템에 있어야 합니다.

설정--작업을 2 이상으로 설정하면 pg_upgrade가 여러 데이터베이스와 테이블스페이스를 병렬로 처리할 수 있습니다. 좋은 출발점은 머신의 CPU 코어 수입니다. 이 옵션은 다중 데이터베이스 및 다중 테이블스페이스 서버의 업그레이드 시간을 크게 줄일 수 있습니다.

Windows 사용자의 경우 관리자 계정으로 로그인한 후 다음을 실행해야 합니다.pg_upgrade인용된 디렉토리 포함, 예:

pg_upgrade.exe
        --old-datadir "C:/Program Files/PostgreSQL/12/data"
        --new-datadir "C:/Program Files/PostgreSQL/18/data"
        --old-bindir "C:/Program Files/PostgreSQL/12/bin"
        --new-bindir "C:/Program Files/PostgreSQL/18/bin"

시작하면,pg_upgrade두 클러스터가 호환되는지 확인한 다음 업그레이드를 수행합니다. 당신은 사용할 수 있습니다pg_upgrade --check이전 서버가 아직 실행 중이더라도 검사만 수행합니다.pg_upgrade --check또한 업그레이드 후에 수행해야 할 수동 조정에 대해 설명합니다. 링크, 복제, 파일 범위 복사 또는 스왑 모드를 사용하려는 경우 옵션을 사용해야 합니다.--링크, --클론, --복사-파일-범위또는--스왑함께--확인모드별 검사를 활성화합니다.pg_upgrade현재 디렉토리에 쓰기 권한이 필요합니다.

분명히 업그레이드 중에는 누구도 토토 핫에 액세스해서는 안 됩니다.pg_upgrade의도하지 않은 클라이언트 연결을 방지하기 위해 기본적으로 포트 50432에서 서버를 실행합니다. 이전 클러스터와 새 클러스터가 동시에 실행되지 않으므로 업그레이드를 수행할 때 두 클러스터에 동일한 포트 번호를 사용할 수 있습니다. 단, 기존에 실행중인 서버를 확인할 때에는 기존 포트번호와 신규 포트번호가 달라야 합니다.

데이터베이스 스키마를 복원하는 동안 오류가 발생하는 경우,pg_upgrade종료되며 설명된 대로 이전 클러스터로 되돌려야 합니다.17단계아래. 시도하다pg_upgrade다시 말하지만, pg_upgrade 스키마 복원이 성공하려면 이전 클러스터를 수정해야 합니다. 문제가 다음과 같은 경우:기여모듈을 제거해야 할 수도 있습니다.기여모듈이 사용자 데이터를 저장하는 데 사용되지 않는다고 가정하고 업그레이드 후 새 토토 핫에 모듈을 설치합니다.

스트리밍 복제 및 로그 전달 대기 서버 업그레이드

링크 모드를 사용하고 스트리밍 복제가 있는 경우(참조섹션 26.2.5) 또는 로그 전달(참조PostgreSQL : 문서 : 18 : 26.2. 로그쉽 스포츠 토토 서버) 대기 서버인 경우 다음 단계에 따라 빠르게 업그레이드할 수 있습니다. 당신은 뛰지 않을 것입니다.pg_upgrade대기 서버에 있지만 오히려rsync기본에. 아직 서버를 시작하지 마세요.

만약 그랬다면아님링크 모드 사용, 사용하지 않거나 사용하고 싶지 않음rsync또는 더 쉬운 솔루션을 원하시면 이 섹션의 지침을 건너뛰고 대기 서버를 한 번만 다시 만드십시오.pg_upgrade완료되고 새로운 기본이 실행 중입니다.

복원pg_hba.conf

수정한 경우pg_hba.conf, 원래 설정을 복원하세요. 이전 클러스터와 일치하도록 새 클러스터의 다른 구성 파일을 조정해야 할 수도 있습니다. 예:postgresql.conf(및 여기에 포함된 모든 파일),postgresql.auto.conf.

새 서버 시작

이제 새 서버를 안전하게 시작할 수 있습니다. 그다음에는 무엇이든 가능합니다.rsync'대기 서버입니다.

업그레이드 후 처리

업그레이드 후 처리가 필요한 경우 pg_upgrade는 완료 시 경고를 발행합니다. 또한 관리자가 실행해야 하는 스크립트 파일도 생성됩니다. 스크립트 파일은 업그레이드 후 처리가 필요한 각 데이터베이스에 연결됩니다. 각 스크립트는 다음을 사용하여 실행되어야 합니다.

psql --username=postgres --file=script.sql postgres

스크립트는 어떤 순서로든 실행될 수 있으며 실행 후에는 삭제할 수 있습니다.

통계

다음이 아닌 이상--통계 없음옵션이 지정되었습니다.pg_upgrade대부분의 최적화 도구 통계를 이전 클러스터에서 새 클러스터로 전송합니다. 그러나 명시적으로 생성된 통계와 같은 일부 통계는 전송되지 않을 수 있습니다.통계 생성또는 확장 프로그램으로 추가된 맞춤 통계입니다.

모든 통계가 전송되지는 않기 때문에pg_upgrade, 업그레이드가 끝나면 해당 정보를 재생성하는 명령을 실행하라는 메시지가 표시됩니다. 새 클러스터와 일치하도록 연결 매개변수를 설정해야 할 수도 있습니다.

먼저, 사용vacuumdb --all --analyze-in-stages --missing-stats-only아무 것도 없이 관계에 대한 최소 최적화 통계를 빠르게 생성합니다. 그런 다음 사용vacuumdb --all --분석 전용모든 관계가 진공 실행 및 분석을 위한 누적 통계를 업데이트했는지 확인합니다. 두 명령 모두에 대해--작업속도를 높일 수 있습니다. 만약에vacuum_cost_delay은 0이 아닌 값으로 설정됩니다. 이는 다음을 사용하여 통계 생성 속도를 높이기 위해 재정의될 수 있습니다.PGOPTIONS예:PGOPTIONS='-c Vacuum_cost_delay=0' 진공 DB ....

이전 클러스터 삭제

업그레이드에 만족하면, 언급된 스크립트를 실행하여 이전 클러스터의 데이터 디렉토리를 삭제할 수 있습니다.pg_upgrade완료되었습니다. (기존 데이터 디렉토리 내부에 사용자 정의 테이블스페이스가 있는 경우 자동 삭제가 불가능합니다.) 또한 기존 설치 디렉토리(예:빈, 공유).

이전 클러스터로 되돌리는 중

만약, 실행 후pg_upgrade, 이전 클러스터로 되돌리려는 경우 몇 가지 옵션이 있습니다.