DMP 파일 내보내기

이 페이지에서는 pg_dump 도구를 사용하여 AlloyDB 데이터베이스를 맞춤 형식의 보관 파일 DMP 파일로 내보내는 방법을 설명합니다. 이 파일은 나중에 pg_restore 도구를 사용하여 가져올 수 있습니다.

내보내기를 실행하는 절차에는 다음 작업이 포함됩니다.

  1. DMP 파일을 저장할 Cloud Storage 버킷을 만듭니다.

  2. 내보내기 작업을 실행할 클라이언트 호스트를 준비합니다.

  3. DMP 파일로 데이터베이스를 내보냅니다.

  4. 절차를 실행하기 위해 생성된 리소스를 삭제합니다.

시작하기 전에

  • 사용 중인 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)

Cloud Storage 버킷 만들기

AlloyDB 데이터베이스가 있는 프로젝트 및 리전에 표준 스토리지, 리전 스토리지 버킷을 만듭니다.

클라이언트 호스트 준비

내보내기 작업을 실행할 클라이언트 호스트를 준비하려면 데이터베이스가 있는 AlloyDB 기본 인스턴스에 연결할 수 있는 Compute Engine VM을 만들고 해당 VM에 pg_dump 도구와 Google Cloud CLI를 설치합니다.

  1. psql 클라이언트를 인스턴스에 연결 안내에 따라 적절한 연결과 pg_dump 도구가 설치된 Compute Engine VM을 만듭니다. 이 안내를 따를 때는 만들 DMP 파일을 수용할 수 있을 만큼 충분한 로컬 스토리지를 Compute Engine VM에 할당해야 합니다.

  2. Cloud Storage 버킷에 DMP 파일을 만들기 위한 명령줄 액세스를 제공하도록 gcloud CLI를 설치합니다.

데이터베이스 내보내기

데이터베이스를 DMP 파일로 내보내려면 데이터베이스가 있는 AlloyDB 기본 인스턴스의 IP 주소를 가져온 다음 pg_dump 도구를 사용합니다.

  1. 세부정보를 확인하여 데이터베이스가 있는 AlloyDB 기본 인스턴스의 IP 주소를 가져옵니다.
  2. Compute Engine VM에 SSH를 통해 연결합니다.

    콘솔

    1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

      VM 인스턴스로 이동

    2. 가상 머신 인스턴스 목록에서 만든 인스턴스 행에서 SSH를 클릭합니다.

      인스턴스 이름 옆에 있는 SSH 버튼

    gcloud

    gcloud compute ssh 명령어를 사용하여 만든 인스턴스에 연결합니다.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    다음을 바꿉니다.

    • PROJECT_ID: 인스턴스가 포함된 프로젝트의 ID입니다.
    • ZONE: 인스턴스가 있는 영역의 이름입니다.
    • VM_NAME: 인스턴스 이름입니다.
  3. 데이터베이스를 DMP 파일로 내보냅니다.
    pg_dump -h IP_ADDRESS -U postgres -F custom \
      DB_NAME > DMP_FILE_NAME
    

    postgres 사용자의 비밀번호를 입력하라는 메시지가 표시됩니다.

    • IP_ADDRESS: 기본 인스턴스의 IP 주소
    • -F custom: 나중에 pg_restore 도구를 사용하여 가져올 수 있는 맞춤 형식 보관 파일로 DMP 파일 형식을 설정합니다.
    • DB_NAME: 내보낼 데이터베이스의 이름입니다.
    • DMP_FILE_NAME: 클라이언트 호스트의 로컬 파일 시스템에 만들 DMP 파일의 파일 이름을 입력합니다.

    위의 예는 간단한 pg_dump 명령어를 보여줍니다. 이 명령어에서 지원하는 다양한 옵션에 관한 자세한 내용은 PostgreSQL 문서를 참고하세요.

  4. DMP 파일을 앞서 만든 Cloud Storage 버킷에 복사합니다.
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

리소스 삭제

DMP 파일을 내보낸 후 내보내기 절차 중에 사용한 Compute Engine VM을 삭제할 수 있습니다.

다음 단계