pg_dump와 pg_restore를 사용하여 데이터베이스 백업 및 복원하는 방법

pg_dump 및 pg_restore를 사용한 데이터베이스 백업 및 복원 방법

데이터베이스 관리 세계에서 강력한 백업 및 복원 전략은 권장 사항일 뿐만 아니라 절대적으로 중요합니다. 데이터 손실은 하드웨어 장애, 사용자 오류 또는 악의적인 공격을 포함한 다양한 소스에서 발생할 수 있습니다. 강력한 오픈 소스 관계형 데이터베이스인 PostgreSQL은 데이터의 무결성과 복구 가능성을 보장하기 위해 필수적인 명령줄 유틸리티인 pg_dump 및 pg_restore를 제공합니다. 이 튜토리얼에서는 이러한 도구를 사용하여 안정적인 백업을 생성하고 PostgreSQL 데이터베이스를 안전하게 복원하는 모범 사례에 대해 안내합니다.

이러한 유틸리티를 이해하는 것은 데이터 보호를 담당하는 모든 PostgreSQL 관리자 또는 개발자에게 기본 사항입니다. pg_dump는 PostgreSQL 데이터베이스를 스크립트 파일 또는 기타 아카이브 파일로 추출하는 데 사용되며, pg_restore는 이러한 파일을 해석하여 데이터베이스를 재구성할 수 있습니다. 이를 숙달하면 귀중한 정보를 보호하고 비즈니스 연속성을 유지할 수 있습니다.

pg_dump 이해하기

pg_dump는 PostgreSQL 데이터베이스의 백업을 생성하기 위한 유틸리티입니다. 데이터베이스 개체(테이블, 함수, 인덱스 등)를 다시 생성하고 데이터로 채우는 데 사용할 수 있는 SQL 명령이 포함된 파일을 생성합니다. pg_dump는 데이터베이스에 연결한 다음 출력을 생성하여 작동합니다. 각기 고유한 장점이 있는 여러 형식으로 출력할 수 있습니다.

출력 형식

pg_dump는 여러 출력 형식을 지원합니다.

• 일반 텍스트 SQL 스크립트(-Fp 또는 기본값): 이것이 가장 간단한 형식입니다. 일련의 SQL 명령이 포함된 파일을 출력합니다. 이 형식은 사람이 읽을 수 있고 스크립트 작성이 용이하지만 매우 큰 데이터베이스의 경우 크기가 크고 복원 속도가 느릴 수 있습니다.
• 사용자 지정 아카이브(-Fc): 이 형식은 압축된 사용자 지정 아카이브 파일을 생성합니다. 기본적으로 압축되며 병렬 복원(pg_restore)을 지원하고 일반적으로 더 유연하기 때문에 백업에 권장되는 형식입니다.
• 디렉터리 형식(-Fd): 이 형식은 각 테이블 및 기타 개체에 대해 파일 하나씩을 포함하는 디렉터리를 생성합니다. 또한 병렬 복원을 지원하며 매우 큰 데이터베이스에 유용합니다.
• Tar 형식(-Ft): 이 형식은 tar 아카이브를 생성합니다. 디렉터리 형식과 유사하지만 단일 파일입니다. tar 아카이브를 처리하는 다른 도구와의 호환성에 유용합니다.

일반적인 pg_dump 옵션

다음은 pg_dump에 가장 자주 사용되는 몇 가지 옵션입니다.

• -h <hostname>: 서버가 실행 중인 머신의 호스트 이름을 지정합니다.
• -p <port>: 서버가 연결을 대기 중인 TCP 포트를 지정합니다.
• -U <username>: 지정된 사용자로 연결합니다.
• -W: 연결하기 전에 pg_dump가 암호를 묻도록 강제합니다.
• -f <filename>: 출력 파일 이름을 지정합니다. 생략하면 pg_dump는 표준 출력에 씁니다.
• -F <format>: 출력 파일 형식을 지정합니다(p, c, d, t).
• -Z <0-9>: 압축 형식(예: Fc)에 대한 압축 수준을 지정합니다.
• --exclude-table=<table_name>: 지정된 테이블을 덤프에서 제외합니다.
• --jobs=<number>: 덤프 시 사용할 병렬 작업 수(디렉터리 형식에만 해당).
• --clean: 개체를 만들기 전에 데이터베이스 개체를 삭제하는 명령을 포함합니다. 이는 깨끗한 상태를 보장하기 위해 전체 복원 시 유용합니다.
• --create: 데이터베이스 자체를 생성하는 명령을 포함합니다. 새 서버로 복원할 때 유용합니다.

예시: 기본 일반 텍스트 백업

mydatabase라는 데이터베이스를 myuser 사용자가 소유하고 mydatabase_backup.sql에 저장하는 일반 텍스트 백업을 생성하려면 다음을 사용합니다.

pg_dump -U myuser -f mydatabase_backup.sql mydatabase

호스트와 포트를 지정해야 하는 경우:

pg_dump -h localhost -p 5432 -U myuser -f mydatabase_backup.sql mydatabase

이 명령은 myuser의 암호를 묻습니다.

예시: 사용자 지정 형식 백업(권장)

사용자 지정 아카이브 형식을 사용하는 것이 유연성과 압축 측면에서 일반적으로 선호됩니다. mydatabase의 압축된 사용자 지정 백업을 생성하려면 다음을 사용합니다.

pg_dump -U myuser -Fc -f mydatabase_backup.dump mydatabase

그러면 pg_restore에 적합한 압축 형식의 mydatabase_backup.dump라는 파일이 생성됩니다.

예시: 병렬 작업을 사용한 디렉터리 형식 백업

매우 큰 데이터베이스의 경우 병렬 덤핑은 백업 프로세스를 크게 가속화할 수 있습니다. 이를 위해서는 디렉터리 형식이 필요합니다.

pg_dump -U myuser -Fd -j 4 -f mydatabase_backup_dir mydatabase

이 명령은 4개의 병렬 작업을 활용하는 여러 파일을 포함하는 mydatabase_backup_dir라는 디렉터리를 생성합니다.

pg_restore 이해하기

pg_restore는 사용자 지정, 디렉터리 또는 tar 형식 중 하나로 pg_dump에서 생성한 아카이브에서 PostgreSQL 데이터베이스를 복원하기 위한 유틸리티입니다. 일반 텍스트 SQL 덤프(이는 psql 명령을 사용하여 복원됨)에는 사용되지 않습니다.

일반적인 pg_restore 옵션

• -h <hostname>: 서버가 실행 중인 머신의 호스트 이름을 지정합니다.
• -p <port>: 서버가 연결을 대기 중인 TCP 포트를 지정합니다.
• -U <username>: 지정된 사용자로 연결합니다.
• -W: 연결하기 전에 pg_restore가 암호를 묻도록 강제합니다.
• -d <database>: 복원할 데이터베이스 이름을 지정합니다. 필수 항목입니다.
• -v: 자세한 모드.
• -c 또는 --clean: 개체를 다시 만들기 전에 데이터베이스 개체를 정리(삭제)합니다.
• --create: 복원하기 전에 데이터베이스를 생성합니다. 이 경우 먼저 다른 데이터베이스(예: postgres)에 연결해야 합니다.
• -j <number>: 복원에 사용할 병렬 작업 수입니다. 이는 특히 사용자 지정 및 디렉터리 형식에서 복원 속도를 크게 향상시킵니다.
• -F <format>: 아카이브 형식을 지정합니다(c, d, t). 일반적으로 pg_restore는 이를 자동으로 감지할 수 있습니다.

일반 텍스트 SQL 백업 복원

pg_dump를 사용하여 일반 텍스트 SQL 백업(예: mydatabase_backup.sql)을 생성한 경우 psql을 사용하여 복원합니다.

psql -U myuser -d mydatabase -f mydatabase_backup.sql

백업 파일에 CREATE DATABASE 및 \connect 명령이 포함된 경우 postgres와 같은 다른 데이터베이스에 연결하고 -d mydatabase 인수를 생략해야 할 수 있습니다.

psql -U myuser -f mydatabase_backup.sql postgres

예시: 사용자 지정 형식 백업 복원

mydatabase_backup.dump 사용자 지정 형식 백업을 restored_db라는 데이터베이스로 복원하려면 다음을 사용합니다.

pg_restore -U myuser -d restored_db mydatabase_backup.dump

대상 데이터베이스 restored_db가 존재하지 않는 경우 --create 옵션을 사용할 수 있습니다. 이 경우 대상 데이터베이스가 생성되므로 다른 데이터베이스(예: postgres)에 연결해야 합니다.

pg_restore -U myuser --create -d restored_db mydatabase_backup.dump

이 명령은 restored_db 데이터베이스를 생성한 다음 데이터를 복원합니다.

예시: 병렬 복원

특히 대용량 데이터 세트의 경우 더 빠른 복원을 위해 -j 옵션을 사용합니다.

pg_restore -U myuser -d restored_db -j 4 mydatabase_backup.dump

이는 4개의 병렬 작업을 사용하여 데이터베이스를 복원하려고 시도합니다.

예시: 디렉터리 형식 백업 복원

디렉터리 형식으로 생성된 백업(예: mydatabase_backup_dir)을 복원하려면 다음을 사용합니다.

pg_restore -U myuser -d restored_db -j 4 mydatabase_backup_dir

마지막 인수가 디렉터리 경로임을 유의하십시오.

백업 모범 사례

• 정기적인 예약: Linux/macOS의 경우 cron 또는 Windows의 작업 스케줄러를 사용하여 백업을 자동화하고 정기적인 간격(예: 매일, 매시간)으로 실행되도록 합니다.
• 올바른 형식 선택: 대부분의 사용 사례의 경우 압축 및 pg_restore의 병렬 기능과의 호환성 때문에 사용자 지정 형식(-Fc)이 권장됩니다. 병렬 덤프/복원이 중요한 매우 큰 데이터베이스의 경우 디렉터리 형식(-Fd)을 사용하십시오.
• 백업 테스트: 백업은 복원할 수 있을 때만 유용합니다. 데이터 무결성과 백업 파일의 유효성을 확인하기 위해 스테이징 또는 개발 환경에 복원하여 복원 프로세스를 정기적으로 테스트하십시오.
• 오프사이트 백업 저장: 기본 데이터베이스 서버와 다른 물리적 위치에 백업 사본을 보관하여 사이트 전체 재해로부터 보호하십시오.
• 백업 작업 모니터링: 예약된 백업 작업이 성공적으로 실행되고 실패 시 알림을 받을 수 있도록 모니터링을 구현하십시오.
• 압축 고려: 자동으로 압축되는 형식을 사용하지 않는 경우 pg_dump의 압축 옵션을 사용하거나 출력을 외부 압축 도구(gzip, zstd)를 통해 파이프 처리하십시오.
• --clean 및 --create 신중하게 사용: 기존 환경에 전체 복원을 수행할 때 --clean이 매우 유용할 수 있습니다. 새 환경으로 이동하거나 완전히 새로운 상태를 보장할 때는 --create가 필수적입니다. 프로덕션 시스템에서는 이러한 옵션을 주의해서 사용하십시오.
• 백업 버전 관리: 백업을 얼마나 오래 보관할지, 오래된 백업을 어떻게 제거할지를 포함하여 백업 보존을 관리하기 위한 전략을 구현하십시오.

결론

pg_dump 및 pg_restore는 PostgreSQL 데이터를 보호하는 데 필수적인 도구입니다. 다양한 옵션, 출력 형식 이해, 정기적인 테스트를 통한 일관된 백업 및 복원 전략 구현을 통해 데이터 손실 위험을 크게 완화하고 데이터베이스 시스템의 복원력을 보장할 수 있습니다. 이러한 유틸리티를 데이터베이스 관리 관행의 초석으로 만드십시오.