Halaman ini menjelaskan cara mengimpor file DMP ke database AlloyDB yang dibuat oleh alat pg_dump
menggunakan format custom
atau directory
.
Untuk mengimpor file yang dibuat oleh alat pg_dump
menggunakan format plain
, lihat
Mengimpor file SQL.
Prosedur untuk melakukan impor melibatkan tugas-tugas berikut:
Upload file DMP ke bucket Cloud Storage.
Siapkan host klien untuk melakukan operasi impor.
Impor file DMP ke dalam database.
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
)
- AlloyDB Admin (
Upload file DMP
Untuk mengupload file DMP, Anda harus membuat bucket Cloud Storage, lalu mengupload file DMP ke bucket tersebut.
Buat bucket penyimpanan standar, penyimpanan regional di project dan region tempat database AlloyDB Anda berada.
Upload file DMP ke bucket penyimpanan yang Anda buat.
Menyiapkan host klien
Untuk menyiapkan host klien guna melakukan operasi impor, Anda membuat VM Compute Engine yang dapat terhubung ke instance utama AlloyDB tempat database Anda berada, dan menginstal alat pg_restore
dan Google Cloud CLI di VM tersebut.
Ikuti petunjuk Menghubungkan klien psql ke instance untuk membuat VM Compute Engine dengan konektivitas yang tepat dan alat
pg_restore
yang diinstal. Saat mengikuti petunjuk ini, pastikan untuk mengalokasikan penyimpanan lokal yang cukup ke VM Compute Engine untuk mengakomodasi file DMP yang Anda impor.Instal gcloud CLI untuk menyediakan akses command line ke file DMP di bucket Cloud Storage.
Mengimpor file DMP
Untuk mengimpor file DMP, Anda mendapatkan alamat IP instance utama AlloyDB tempat database Anda berada, lalu menggunakan alat pg_restore
untuk mengimpor file ke dalam database.
- Dapatkan alamat IP instance utama AlloyDB tempat database Anda berada dengan melihat detailnya.
- Gunakan SSH untuk terhubung ke VM Compute Engine.
- Di konsol Google Cloud, buka halaman Instance VM.
- Di daftar instance virtual machine, klik SSH di
baris instance yang Anda buat.
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
- Salin file DMP ke sistem file lokal host klien:
gcloud storage cp gs://
BUCKET_NAME /DMP_FILE_NAME . - Jalankan perintah berikut untuk membuat file TOC yang mengomentari semua
pernyataan
EXTENSION
:pg_restore \ -l
DMP_FILE_NAME | sed -E 's/(.* EXTENSION )/; \1/g' >TOC_FILE_NAME DMP_FILE_NAME
: File DMP di sistem file lokal.TOC_FILE_NAME
: Berikan nama file untuk file TOC yang akan dibuat di sistem file lokal.
- Impor file DMP:
pg_restore -h
IP_ADDRESS -U postgres \ -dDB_NAME \ -LTOC_FILE_NAME \DMP_FILE_NAME IP_ADDRESS
: Alamat IP instance utama.DB_NAME
: Nama database yang akan diimpor.TOC_FILE_NAME
: File TOC yang Anda buat di langkah sebelumnya.DMP_FILE_NAME
: File DMP.
Perintah
pg_restore
menyediakan beberapa opsi tambahan untuk mengontrol operasi impor data.
Membersihkan resource
Setelah berhasil mengimpor file DMP, Anda dapat menghapus bucket Cloud Storage dan menghapus VM Compute Engine yang Anda gunakan selama prosedur impor.