Mengekspor file DMP

Halaman ini menjelaskan cara menggunakan alat pg_dump untuk mengekspor database AlloyDB ke file DMP arsip berformat kustom yang nantinya dapat Anda impor menggunakan alat pg_restore.

Prosedur untuk melakukan ekspor melibatkan tugas-tugas berikut:

  1. Buat bucket Cloud Storage untuk menyimpan file DMP.

  2. Siapkan host klien untuk melakukan operasi ekspor.

  3. Ekspor database ke file DMP.

  4. Bersihkan resource yang dibuat untuk melakukan prosedur.

Sebelum memulai

  • Anda harus memiliki peran IAM dasar Pemilik (roles/owner) atau Editor (roles/editor) di project Google Cloud yang Anda gunakan, atau Anda harus memiliki peran IAM bawaan berikut:
    • AlloyDB Admin (roles/alloydb.admin) atau AlloyDB Viewer (roles/alloydb.viewer)
    • Storage Admin (roles/storage.admin)
    • Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)

Membuat bucket Cloud Storage

Buat bucket penyimpanan standar, penyimpanan regional di project dan region tempat database AlloyDB Anda berada.

Menyiapkan host klien

Untuk menyiapkan host klien guna melakukan operasi ekspor, Anda membuat VM Compute Engine yang dapat terhubung ke instance utama AlloyDB tempat database Anda berada, dan menginstal alat pg_dump serta Google Cloud CLI di VM tersebut.

  1. Ikuti petunjuk Menghubungkan klien psql ke instance untuk membuat VM Compute Engine dengan konektivitas yang tepat dan alat pg_dump yang diinstal. Saat mengikuti petunjuk ini, pastikan untuk mengalokasikan penyimpanan lokal yang cukup ke VM Compute Engine untuk mengakomodasi file DMP yang akan Anda buat.

  2. Instal gcloud CLI untuk menyediakan akses command line guna membuat file DMP di bucket Cloud Storage.

Mengekspor database

Untuk mengekspor database ke file DMP, Anda mendapatkan alamat IP instance utama AlloyDB tempat database Anda berada, lalu menggunakan alat pg_dump.

  1. Dapatkan alamat IP instance utama AlloyDB tempat database Anda berada dengan melihat detailnya.
  2. Gunakan SSH untuk terhubung ke VM Compute Engine.

    Konsol

    1. Di konsol Google Cloud, buka halaman Instance VM.

      Buka instance VM

    2. Di daftar instance virtual machine, klik SSH di baris instance yang Anda buat.

      Tombol SSH di samping nama instance.

    gcloud

    Gunakan perintah gcloud compute ssh untuk terhubung ke instance yang Anda buat.

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

    Ganti kode berikut:

    • PROJECT_ID: ID project yang berisi instance.
    • ZONE: Nama zona tempat instance berada.
    • VM_NAME: nama instance
  3. Ekspor database ke file DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

    Anda akan diminta untuk memasukkan sandi pengguna postgres.

    • IP_ADDRESS: Alamat IP instance utama.
    • -F custom: Menetapkan format file DMP ke arsip format kustom yang nantinya dapat Anda impor menggunakan alat pg_restore.
    • DB_NAME: Nama database yang ingin Anda ekspor.
    • DMP_FILE_NAME: Berikan nama file untuk file DMP yang akan dibuat di sistem file lokal host klien.

    Gambar di atas menunjukkan perintah pg_dump sederhana. Untuk informasi tentang berbagai opsi yang didukung perintah, lihat dokumentasi PostgreSQL.

  4. Salin file DMP ke bucket Cloud Storage yang telah Anda buat sebelumnya: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Membersihkan resource

Setelah berhasil mengekspor file DMP, Anda dapat menghapus VM Compute Engine yang digunakan selama prosedur ekspor.

Langkah selanjutnya