이 페이지에서는 pg_dump
도구를 사용하여 AlloyDB 데이터베이스를 나중에 pg_restore
도구를 사용하여 가져올 수 있는 맞춤 형식의 보관 DMP 파일로 내보내는 방법을 설명합니다.
내보내기를 실행하는 절차에는 다음 작업이 포함됩니다.
DMP 파일을 저장할 Cloud Storage 버킷을 만듭니다.
내보내기 작업을 실행할 클라이언트 호스트를 준비합니다.
절차를 실행하기 위해 생성된 리소스 정리
시작하기 전에
- 사용 중인 Google Cloud 프로젝트에 소유자 (
roles/owner
) 또는 편집자(roles/editor
) 기본 IAM 역할이 있거나 다음과 같은 사전 정의된 IAM 역할이 있어야 합니다.- AlloyDB 관리자 (
roles/alloydb.admin
) 또는 AlloyDB 뷰어(roles/alloydb.viewer
) - 스토리지 관리자(
roles/storage.admin
) - Compute 인스턴스 관리자 (v1) (
roles/compute.instanceAdmin.v1
)
- AlloyDB 관리자 (
Cloud Storage 버킷 만들기
AlloyDB 데이터베이스가 있는 프로젝트 및 리전에 Standard Storage 또는 Regional Storage 버킷을 만듭니다.
클라이언트 호스트 준비
내보내기 작업을 실행할 클라이언트 호스트를 준비하려면 데이터베이스가 있는 AlloyDB 기본 인스턴스에 연결할 수 있는 Compute Engine VM을 만들고 해당 VM에 pg_dump
도구와 Google Cloud CLI를 설치합니다.
인스턴스에 psql 클라이언트 연결의 안내에 따라 적절한 연결과
pg_dump
도구가 설치된 Compute Engine VM을 만듭니다. 이 안내를 따를 때는 생성할 DMP 파일을 수용할 수 있도록 Compute Engine VM에 충분한 로컬 스토리지를 할당해야 합니다.gcloud CLI를 설치하여 Cloud Storage 버킷에 DMP 파일을 만드는 명령줄 액세스를 제공합니다.
데이터베이스 내보내기
데이터베이스를 DMP 파일로 내보내려면 데이터베이스가 있는 AlloyDB 기본 인스턴스의 IP 주소를 가져온 다음 pg_dump
도구를 사용합니다.
- 세부정보를 확인하여 데이터베이스가 있는 AlloyDB 기본 인스턴스의 IP 주소를 가져옵니다.
- Compute Engine VM에 SSH를 통해 연결합니다.
콘솔
- Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.
- 가상 머신 인스턴스 목록에서 만든 인스턴스의 행에 있는 SSH를 클릭합니다.
gcloud
gcloud compute ssh
명령어를 사용하여 만든 인스턴스에 연결합니다.gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
다음을 바꿉니다.
PROJECT_ID
: 인스턴스가 포함된 프로젝트의 ID입니다.ZONE
: 인스턴스가 있는 영역의 이름입니다.VM_NAME
: 인스턴스 이름입니다.
- 데이터베이스를 DMP 파일로 내보냅니다.
pg_dump -h IP_ADDRESS -U postgres -F custom \ DB_NAME > DMP_FILE_NAME
postgres
사용자의 비밀번호를 입력하라는 메시지가 표시됩니다.IP_ADDRESS
: 기본 인스턴스의 IP 주소-F custom
: DMP 파일의 형식을 나중에pg_restore
도구를 사용하여 가져올 수 있는 맞춤 형식 보관 파일로 설정합니다.DB_NAME
: 내보낼 데이터베이스의 이름입니다.DMP_FILE_NAME
: 클라이언트 호스트의 로컬 파일 시스템에 생성할 DMP 파일의 파일 이름을 제공합니다.
위는 간단한
pg_dump
명령어를 보여줍니다. 명령어에서 지원하는 다양한 옵션에 대한 자세한 내용은 PostgreSQL 문서를 참고하세요. - DMP 파일을 앞서 만든 Cloud Storage 버킷에 복사합니다.
gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME
리소스 삭제
DMP 파일을 성공적으로 내보낸 후 내보내기 절차 중에 사용한 Compute Engine VM을 삭제할 수 있습니다.
다음 단계
- CSV 파일을 내보내는 방법을 알아보세요.
- SQL 덤프 파일을 내보내는 방법을 알아보세요.