Menggunakan migrasi mulai cepat untuk bermigrasi ke AlloyDB untuk PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara melakukan migrasi mulai cepat untuk migrasi PostgreSQL homogen ke AlloyDB untuk PostgreSQL.

Ringkasan

Migrasi mulai cepat adalah alur migrasi berkelanjutan ringan untuk skenario PostgreSQL yang homogen. Dengan migrasi mulai cepat, Database Migration Service dapat otomatis menyiapkan semua yang Anda butuhkan untuk memigrasikan database: komponen jaringan (lampiran jaringan, subnet, konfigurasi konektivitas pribadi), profil koneksi, dan tugas migrasi.

Dengan migrasi mulai cepat, Anda dapat memindahkan data ke cluster AlloyDB untuk PostgreSQL yang ada, atau membuat cluster baru saat mengonfigurasi migrasi. Migrasi mulai cepat paling cocok untuk:

• Migrasi dasar, saat Anda tidak memerlukan kontrol yang tepat atas setelan paralelisme dump data.
• Memigrasikan database Anda dari satu Google Cloud project ke project lain. Saat mengonfigurasi migrasi mulai cepat, Anda dapat membuat cluster tujuan di project yang berbeda dengan sumber dan menyetel Database Migration Service untuk membuat network attachment dan subnet di jaringan Virtual Private Cloud (VPC) project lain.

• Memigrasikan dari sumber yang memiliki alamat IP pribadi di jaringan Virtual Private Cloud (VPC) Anda Google Cloud, seperti database yang dikelola sendiri di Compute Engine, atau instance Cloud SQL untuk PostgreSQL yang diaktifkan untuk jaringan pribadi.

  Sumber yang dihosting di luar Google Cloud mungkin memerlukan komponen jaringan tambahan (seperti koneksi Cloud VPN) agar dapat dijangkau di alamat IP pribadi dalam jaringan VPC Anda.

• Satu-satunya metode yang didukung untuk konektivitas database adalah antarmuka Private Service Connect dengan konfigurasi konektivitas pribadi Database Migration Service. Database sumber Anda harus memiliki IP pribadi yang ditetapkan di jaringan VPC. Metode konektivitas sumber homogen lainnya (seperti daftar IP yang diizinkan publik, tunnel SSH terbalik, atau peering VPC) tidak didukung untuk migrasi mulai cepat.

Untuk mempelajari lebih lanjut migrasi mulai cepat, lihat Ringkasan migrasi mulai cepat dalam dokumentasi utama Database Migration Service.

Sebelum memulai

1. Verifikasi apakah migrasi mulai cepat dapat sepenuhnya mendukung skenario Anda. Lihat Batasan migrasi mulai cepat.
Login ke Akun Google Anda.

Jika Anda belum memilikinya, Daftar untuk membuat akun baru.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

2. Aktifkan Database Migration Service, Compute Engine, Network Connectivity Center, dan AlloyDB untuk PostgreSQL Admin API.

   Aktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menjalankan migrasi mulai cepat ke AlloyDB untuk PostgreSQL dengan Database Migration Service, minta administrator Anda untuk memberikan peran Identity and Access Management (IAM) yang diperlukan untuk akun yang terlibat dalam migrasi di project yang relevan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses dalam dokumentasi IAM.

Penting: Anda harus menetapkan peran langsung ke akun ini. Peran yang diwarisi melalui keanggotaan grup Google tidak didukung untuk migrasi mulai cepat.

Peran dan izin di project sumber

Berikan peran berikut ke akun tertentu di project Google Cloud tempat database sumber Anda berada:

• Untuk akun pengguna yang melakukan migrasi: Peran Compute Network Admin (roles/compute.networkAdmin)
• Untuk akun layanan Database Migration Service dari project tujuan: Compute Network Viewer (roles/compute.networkViewer)

  Akun layanan Database Migration Service dibuat saat Anda mengaktifkan Database Migration Service API. Alamat email yang terkait dengan akun ini dibuat secara otomatis dan tidak dapat diubah. Alamat email ini menggunakan format berikut:

  [e-mail]

Peran bawaan ini berisi izin yang diperlukan untuk menyiapkan konektivitas di project database sumber Anda sebagai bagian dari migrasi mulai cepat dengan Database Migration Service. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan (sumber):

Izin yang diperlukan (sumber)

Izin berikut diperlukan untuk melakukan migrasi mulai cepat homogen dengan Database Migration Service:

Untuk akun pengguna yang melakukan migrasi:

• compute.networks.*
• compute.subnetworks.*
• compute.networkAttachments.*

Untuk akun layanan Database Migration Service dari project tujuan: compute.networkAttachments.get.

Peran dan izin di project tujuan

Berikan peran berikut kepada akun pengguna yang melakukan migrasi di project Google Cloud tempat database tujuan Anda berada:

• Database Migration Admin (roles/datamigration.admin)
• Admin AlloyDB (roles/alloydb.admin)

Peran bawaan ini berisi izin yang diperlukan untuk menyiapkan komponen migrasi yang diperlukan di project database tujuan sebagai bagian dari migrasi mulai cepat dengan Database Migration Service. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan (tujuan):

Izin yang diperlukan (tujuan)

Izin berikut diperlukan untuk melakukan migrasi mulai cepat homogen dengan Database Migration Service:

• datamigration.*
• alloydb.clusters.create
• alloydb.clusters.get
• alloydb.clusters.list
• alloydb.clusters.update
• alloydb.clusters.delete
• alloydb.instances.create
• alloydb.instances.get
• alloydb.instances.list
• alloydb.instances.update
• alloydb.instances.delete
• alloydb.instances.executeSql
• alloydb.operations.get
• alloydb.users.list
• alloydb.users.get
• alloydb.users.create
• alloydb.users.update
• alloydb.users.delete

Mengonfigurasi database sumber

Untuk mengonfigurasi database PostgreSQL sumber, lakukan hal berikut:

1. Buat akun pengguna migrasi khusus di instance Anda.
   • Untuk sumber Cloud SQL untuk PostgreSQL, lihat Membuat pengguna dalam dokumentasi Cloud SQL.
   • Untuk sumber lainnya, lihat dokumentasi penyedia database Anda atau buat dan kelola pengguna dalam dokumentasi PostgreSQL.
2. Tetapkan hak istimewa yang diperlukan ke akun pengguna migrasi khusus. Jalankan perintah berikut untuk setiap database yang ingin Anda migrasikan:

   -- Grant the REPLICATION attribute
   ALTER ROLE MIGRATION_USER REPLICATION;
   
   -- Grant database-level permissions.
   -- Repeat for each database you want to migrate.
   GRANT CONNECT, CREATE ON DATABASE DATABASE_NAME TO MIGRATION_USER;
   
   -- Grant schema-level usage.
   -- Repeat for each schema in each database you want to migrate.
   GRANT USAGE ON SCHEMA SCHEMA_NAME TO MIGRATION_USER;

   Ganti kode berikut:

   • MIGRATION_USER dengan nama akun pengguna migrasi.
   • DATABASE_NAME dengan nama database yang ingin Anda migrasikan.
   • SCHEMA_NAME dengan nama skema di database yang ingin Anda migrasikan.
3. Akun pengguna migrasi harus memiliki akses kepemilikan ke tabel yang Anda migrasikan. Untuk memberikan tingkat akses ini, lakukan salah satu tindakan berikut:
   • Khusus untuk sumber selain Cloud SQL untuk PostgreSQL: Tetapkan SUPERUSER peran PostgreSQL ke akun migrasi.
   • Untuk semua sumber: Tambahkan akun pengguna migrasi ke grup pengguna yang memiliki tabel. Jalankan perintah berikut:

     -- Grant table ownership.
     GRANT TABLE_OWNER_GROUP_NAME TO MIGRATION_USER;

     Ganti kode berikut:

     • TABLE_OWNER_GROUP_NAME dengan nama grup pengguna yang memiliki setiap tabel yang ingin Anda migrasikan.
     • MIGRATION_USER dengan nama akun pengguna migrasi.
4. Untuk tabel yang tidak memiliki kunci utama: Database Migration Service tidak mereplikasi operasi UPDATE atau DELETE untuk tabel tanpa kunci utama selama fase Pengambilan Data Perubahan (CDC). Jika Anda ingin menyertakan operasi tersebut dalam replikasi, ubah tabel tanpa kunci utama dengan REPLICA IDENTITY:

   ALTER TABLE TABLE_NAME REPLICA IDENTITY FULL;
   ALTER TABLE TABLE_NAME REPLICA IDENTITY USING INDEX INDEX_NAME;

   Ganti kode berikut:

   • TABLE_NAME adalah nama tabel yang tidak memiliki kunci utama.
   • INDEX_NAME adalah indeks unik yang dapat melacak baris dari tabel tanpa kunci utama.
5. Konfigurasi setelan replikasi menggunakan flag database.

   Sumber yang dikelola sendiri

   Menyimpan perubahan pada flag database memerlukan restart database penuh. Contoh berikut menggunakan kueri SQL untuk mengubah nilai flag. Jika Anda tidak dapat menjalankan kueri SQL secara langsung, lihat dokumentasi penyedia Anda untuk mengetahui langkah-langkah tentang cara mengubah tanda ini.

   1. Tetapkan wal_level parameter ke logical. Jalankan perintah berikut:

      ALTER SYSTEM SET wal_level = 'logical';

   2. Tetapkan parameter wal_sender_timeout ke 0. Nilai ini menonaktifkan mekanisme waktu tunggu yang digunakan untuk menghentikan koneksi replikasi yang tidak aktif. Jalankan perintah berikut:

      ALTER SYSTEM SET wal_sender_timeout = 0;
          

   3. Konfigurasi jumlah maksimum slot replikasi dengan parameter max_replication_slots. Parameter ini harus disetel ke setidaknya jumlah database yang Anda migrasikan per tugas migrasi, ditambah beberapa cadangan untuk sinkronisasi tabel.

      Misalnya, jika Anda memigrasikan 5 database dan ada 2 tugas migrasi yang dibuat untuk instance sumber, jumlah slot replikasi harus minimal 5 * 2 = 10, ditambah jumlah slot replikasi yang sudah Anda gunakan.

      Untuk menetapkan parameter ini, jalankan perintah berikut:

      ALTER SYSTEM SET max_replication_slots = NUMBER_OF_SLOTS;
          

      Dengan NUMBER_OF_SLOTS mewakili jumlah maksimum slot replikasi.
   4. Konfigurasi parameter max_wal_senders agar setidaknya sama dengan nilai max_replication_slots, ditambah jumlah pengirim yang sudah digunakan di instance Anda.

      Misalnya, jika parameter max_replication_slots ditetapkan ke 10, dan Anda sudah menggunakan 2 pengirim, jumlah proses pengirim WAL yang berjalan pada saat yang sama adalah 10 + 2 = 12.

      Untuk menetapkan parameter ini, jalankan perintah berikut:

      ALTER SYSTEM SET max_wal_senders = NUMBER_OF_SENDERS;
          

      Dengan NUMBER_OF_SENDERS mewakili jumlah proses pengirim WAL yang berjalan secara bersamaan.
   5. Tetapkan max_worker_processes ke setidaknya jumlah database yang ingin Anda migrasikan, ditambah jumlah max_worker_processes yang sudah digunakan di instance Anda. Untuk menetapkan parameter ini, jalankan perintah berikut:

      ALTER SYSTEM SET max_worker_processes = NUMBER_OF_PROCESSES;
          

      Dengan NUMBER_OF_PROCESSES mewakili jumlah database yang akan dimigrasikan.

   Sumber Cloud SQL untuk PostgreSQL

   Untuk sumber Cloud SQL, Anda mengonfigurasi flag database di konsol Google Cloud . Anda harus memulai ulang instance setelah mengubah flag database agar setelan diterapkan. Untuk mengetahui informasi selengkapnya tentang cara menyetel flag database di Cloud SQL, lihat Mengonfigurasi flag database dalam dokumentasi Cloud SQL.

   1. Tetapkan flag cloudsql.logical_decoding ke on.
   2. Tetapkan parameter wal_sender_timeout ke 0. Nilai ini menonaktifkan mekanisme waktu tunggu yang digunakan untuk menghentikan koneksi replikasi yang tidak aktif.
   3. Konfigurasi jumlah maksimum slot replikasi dengan parameter max_replication_slots. Parameter ini harus disetel ke setidaknya jumlah database yang Anda migrasikan per tugas migrasi, ditambah beberapa cadangan untuk sinkronisasi tabel.

      Misalnya, jika Anda memigrasikan 5 database dan ada 2 tugas migrasi yang dibuat untuk instance sumber, jumlah slot replikasi harus minimal 5 * 2 = 10, ditambah jumlah slot replikasi yang sudah Anda gunakan.

   4. Konfigurasi parameter max_wal_senders agar setidaknya memiliki nilai yang sama dengan max_replication_slots, ditambah jumlah pengirim yang sudah digunakan di instance Anda.

      Misalnya, jika parameter max_replication_slots ditetapkan ke 10, dan Anda sudah menggunakan 2 pengirim, jumlah proses pengirim WAL yang berjalan pada saat yang sama adalah 10 + 2 = 12.

   5. Tetapkan max_worker_processes ke setidaknya jumlah database yang ingin Anda migrasikan, ditambah jumlah max_worker_processes yang sudah digunakan di instance Anda.

Membuat dan menjalankan migrasi mulai cepat

Untuk membuat dan menjalankan migrasi mulai cepat, Anda dapat menggunakan konsol Google Cloud atau gcloud CLI.

Konsol

1. Di konsol Google Cloud , buka halaman Mulai.

   Buka Mulai

2. Di menu Source engine, pilih PostgreSQL.
3. Di menu Mesin tujuan, pilih AlloyDB untuk PostgreSQL.

   Bagian Memperkenalkan migrasi PostgreSQL mulai cepat akan muncul.

4. Di bagian Introducing quick-start PostgreSQL migration, klik Start migration.

   Halaman Migrate to AlloyDB for PostgreSQL akan terbuka.

5. Di bagian Configure migration, lakukan hal berikut:
   1. Dari menu Destination region, pilih region cluster AlloyDB untuk PostgreSQL tujuan Anda.
   2. Di kotak Awalan migrasi, masukkan string yang mudah dipahami yang akan ditambahkan ke nama semua entity migrasi yang dibuat untuk migrasi mulai cepat: profil koneksi, konfigurasi konektivitas pribadi, network attachment dan subnetnya, serta tugas migrasi.
   3. Dari menu Configuration type, pilih salah satu berikut:
      1. Konfigurasi konektivitas yang ada: Pilih opsi ini jika Anda sudah memiliki network attachment dan konfigurasi konektivitas pribadi yang menggunakan metode antarmuka Private Service Connect. Opsi ini paling baik digunakan jika sebelumnya Anda menggunakan migrasi mulai cepat dan ingin menggunakan kembali resource jaringan yang sama.
      2. Konfigurasi konektivitas baru: Pilih opsi ini untuk membuat network attachment baru dan subnet network attachment di jaringan VPC database sumber. Konfigurasi konektivitas pribadi akan dibuat di project yang sama dengan cluster tujuan Anda.
   Klik Lanjutkan.
6. Di bagian Hubungkan sumber, lakukan hal berikut:
   1. Masukkan Nama host atau alamat IP pribadi dari database sumber Anda. Alamat database sumber harus dapat dijangkau dari jaringan VPC sumber Anda.
   2. Masukkan Port yang digunakan untuk mengakses host. Port PostgreSQL default adalah 5432.
   3. Masukkan nama pengguna dan sandi untuk akun migrasi khusus di database sumber Anda.
   4. Dari menu Encryption type, pilih salah satu opsi berikut:
      • Tidak Ada: Jika database sumber Anda tidak memerlukan koneksi yang dienkripsi SSL/TLS.
      • Wajib: Jika database sumber Anda memerlukan koneksi terenkripsi SSL/TLS. Opsi ini tidak memerlukan verifikasi sertifikat apa pun.
   5. Di menu Databases to migrate, klik Customize. Gunakan panel samping untuk memilih hanya database yang ingin Anda migrasikan ke AlloyDB untuk PostgreSQL.
   Klik Lanjutkan.
7. Di bagian Konfigurasi tujuan, Anda dapat membuat cluster tujuan baru atau memilih cluster yang ada.

   Cluster baru

   Jika Anda ingin membuat cluster tujuan baru, lakukan langkah-langkah berikut:

   1. Dari menu Destination instance type, pilih New cluster.

      Database Migration Service menggunakan konfigurasi AlloyDB untuk PostgreSQL default untuk cluster baru. Klik Sesuaikan untuk menyesuaikan fitur cluster, seperti jenis mesin, ketersediaan zona, atau setelan perlindungan data. Untuk mengetahui informasi selengkapnya tentang konfigurasi cluster, lihat Membuat cluster dan instance utamanya dalam dokumentasi AlloyDB untuk PostgreSQL.

   2. Di kolom Sandi, masukkan sandi untuk pengguna admin postgresql default. Database Migration Service terhubung sebagai pengguna ini untuk memigrasikan data Anda.

   Cluster yang ada

   Anda dapat memigrasikan database ke cluster yang sudah ada. Pastikan cluster tujuan diaktifkan untuk Private Service Connect dan tidak menerapkan mTLS dengan konektor AlloyDB. Lakukan tindakan berikut:

   1. Dari menu Destination instance type, pilih Existing cluster.
   2. Dari menu ID cluster yang ada, pilih ID cluster.
8. Klik Mulai migrasi.

   Database Migration Service kini membuat tugas migrasi dan memulai proses migrasi. Anda dapat memantau progres migrasi, serta kondisi cluster tujuan di AlloyDB untuk PostgreSQL. Untuk mengetahui informasi selengkapnya, lihat Melihat detail instance dalam dokumentasi AlloyDB untuk PostgreSQL.

gcloud

Untuk membuat dan menjalankan migrasi mulai cepat menggunakan gcloud CLI, lakukan hal berikut:

1. Konfigurasi lampiran jaringan.
   Tentukan apakah Anda ingin membuat network attachment baru atau menggunakan kembali network attachment yang sudah ada. Anda harus memiliki lampiran jaringan di jaringan tempat IP pribadi database sumber dapat dijangkau.

   • Jika Anda ingin membuat network attachment baru, jalankan perintah berikut (klik untuk meluaskan detail lengkap):

     gcloud compute network-attachments create

     Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

     • NETWORK_ATTACHMENT dengan nama network attachment yang akan dibuat.
     • REGION dengan region untuk lampiran jaringan.
     • DEST_PROJECT_ID dengan project ID project tujuan Anda.
     • SOURCE_PROJECT_ID dengan project ID tempat jaringan sumber berada.

     Jalankan perintah berikut:

     Linux, macOS, atau Cloud Shell

     Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

     gcloud compute network-attachments create NETWORK_ATTACHMENT \
       --region=REGION \
       --connection-preference=ACCEPT_MANUAL \
       --producer-accept-list=DEST_PROJECT_ID \
       --subnets=default \
       --project=SOURCE_PROJECT_ID

     Windows (PowerShell)

     Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

     gcloud compute network-attachments create NETWORK_ATTACHMENT `
       --region=REGION `
       --connection-preference=ACCEPT_MANUAL `
       --producer-accept-list=DEST_PROJECT_ID `
       --subnets=default `
       --project=SOURCE_PROJECT_ID

     Windows (cmd.exe)

     Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

     gcloud compute network-attachments create NETWORK_ATTACHMENT ^
       --region=REGION ^
       --connection-preference=ACCEPT_MANUAL ^
       --producer-accept-list=DEST_PROJECT_ID ^
       --subnets=default ^
       --project=SOURCE_PROJECT_ID

2. Izinkan project tenant Database Migration Service mengakses lampiran jaringan Anda.
   Lampiran jaringan Anda harus mengizinkan koneksi dari project tenant Database Migration Service. Lakukan langkah-langkah berikut:

   1. Ambil ID project tenant Database Migration Service dengan melakukan pembuatan koneksi pribadi uji coba (klik untuk meluaskan):

      gcloud database-migration private-connections create --validate-only

      Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

      • PRIVATE_CONN dengan nama resource koneksi pribadi.
      • REGION dengan region untuk koneksi pribadi.
      • NETWORK_ATTACHMENT_URI dengan URI lampiran jaringan.

      Jalankan perintah berikut:

      Linux, macOS, atau Cloud Shell

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud database-migration private-connections create PRIVATE_CONN \
        --region=REGION \
        --network-attachment=NETWORK_ATTACHMENT_URI \
        --display-name=PRIVATE_CONN \
        --format="value(metadata.metadata.tenant_project_id)" \
        --validate-only

      Windows (PowerShell)

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud database-migration private-connections create PRIVATE_CONN `
        --region=REGION `
        --network-attachment=NETWORK_ATTACHMENT_URI `
        --display-name=PRIVATE_CONN `
        --format="value(metadata.metadata.tenant_project_id)" `
        --validate-only

      Windows (cmd.exe)

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud database-migration private-connections create PRIVATE_CONN ^
        --region=REGION ^
        --network-attachment=NETWORK_ATTACHMENT_URI ^
        --display-name=PRIVATE_CONN ^
        --format="value(metadata.metadata.tenant_project_id)" ^
        --validate-only

      Simpan project ID project tenant yang ditampilkan untuk digunakan dengan perintah berikutnya.

   2. Izinkan project tenant Database Migration Service dan project tujuan terhubung ke lampiran jaringan (klik untuk meluaskan):

      gcloud compute network-attachments update

      Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

      • NETWORK_ATTACHMENT dengan nama network attachment.
      • REGION dengan region.
      • DEST_PROJECT_ID dengan project ID project tujuan Anda.
      • DMS_TENANT_ID dengan project ID tenant Database Migration Service yang diambil.
      • SOURCE_PROJECT_ID dengan project ID tempat jaringan sumber berada.

      Jalankan perintah berikut:

      Linux, macOS, atau Cloud Shell

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud compute network-attachments update NETWORK_ATTACHMENT \
        --region=REGION \
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID \
        --project=SOURCE_PROJECT_ID

      Windows (PowerShell)

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud compute network-attachments update NETWORK_ATTACHMENT `
        --region=REGION `
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID `
        --project=SOURCE_PROJECT_ID

      Windows (cmd.exe)

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud compute network-attachments update NETWORK_ATTACHMENT ^
        --region=REGION ^
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID ^
        --project=SOURCE_PROJECT_ID

3. Buat koneksi pribadi.
   Buat resource koneksi pribadi agar Database Migration Service dapat terhubung ke jaringan sumber Anda (klik untuk meluaskan):

   gcloud database-migration private-connections create

   Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • PRIVATE_CONN dengan nama resource koneksi pribadi.
   • REGION dengan region untuk koneksi pribadi.
   • NETWORK_ATTACHMENT_URI dengan URI lampiran jaringan.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration private-connections create PRIVATE_CONN \
     --region=REGION \
     --network-attachment=NETWORK_ATTACHMENT_URI \
     --display-name=PRIVATE_CONN

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration private-connections create PRIVATE_CONN `
     --region=REGION `
     --network-attachment=NETWORK_ATTACHMENT_URI `
     --display-name=PRIVATE_CONN

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration private-connections create PRIVATE_CONN ^
     --region=REGION ^
     --network-attachment=NETWORK_ATTACHMENT_URI ^
     --display-name=PRIVATE_CONN

4. Buat profil koneksi sumber.
   Jalankan perintah berikut (klik untuk meluaskan):

   gcloud database-migration connection-profiles create postgresql

   Contoh ini menggunakan tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --no-async untuk menjalankan perintah secara asinkron. Jika ya, Anda harus menggunakan perintah gcloud database-migration operations describe untuk memverifikasi apakah operasi Anda berhasil.

   Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • SOURCE_CONN_ID dengan ID profil koneksi sumber Anda.
   • REGION dengan region tempat Anda ingin menyimpan profil koneksi.
   • SOURCE_PRIVATE_IP dengan alamat IP pribadi database sumber Anda.
   • SOURCE_PORT dengan port database sumber Anda (defaultnya adalah 5432).
   • SOURCE_USER dengan nama pengguna pengguna migrasi di database sumber Anda.
   • SOURCE_PASSWORD dengan sandi pengguna migrasi di database sumber Anda.
   • PRIVATE_CONN dengan nama resource koneksi pribadi.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration connection-profiles create postgresql \
     SOURCE_CONN_ID \
     --region=REGION \
     --role=SOURCE \
     --host=SOURCE_PRIVATE_IP \
     --port=SOURCE_PORT \
     --username=SOURCE_USER \
     --password=SOURCE_PASSWORD \
     --private-connection=PRIVATE_CONN \
     --no-async

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration connection-profiles create postgresql `
     SOURCE_CONN_ID `
     --region=REGION `
     --role=SOURCE `
     --host=SOURCE_PRIVATE_IP `
     --port=SOURCE_PORT `
     --username=SOURCE_USER `
     --password=SOURCE_PASSWORD `
     --private-connection=PRIVATE_CONN `
     --no-async

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration connection-profiles create postgresql ^
     SOURCE_CONN_ID ^
     --region=REGION ^
     --role=SOURCE ^
     --host=SOURCE_PRIVATE_IP ^
     --port=SOURCE_PORT ^
     --username=SOURCE_USER ^
     --password=SOURCE_PASSWORD ^
     --private-connection=PRIVATE_CONN ^
     --no-async

5. Buat profil koneksi tujuan.
   Pilih tab berdasarkan apakah Anda ingin bermigrasi ke cluster AlloyDB untuk PostgreSQL yang baru atau yang sudah ada:

   Cluster baru

   Untuk menggunakan cluster tujuan baru untuk migrasi mulai cepat, buat terlebih dahulu cluster dan instance utamanya dengan AlloyDB untuk PostgreSQL Google Cloud CLI, lalu buat profil koneksi tujuan. Ikuti langkah-langkah berikut:

   1. Buat cluster dan instance utamanya dengan Google Cloud CLI AlloyDB untuk PostgreSQL. Pastikan Anda menggunakan --enable-private-service-connect flag untuk mengaktifkan cluster tujuan Anda untuk Private Service Connect. Migrasi mulai cepat hanya mendukung tujuan yang mendukung Private Service Connect.
   2. Buat profil koneksi tujuan untuk cluster baru Anda. Luaskan bagian berikut untuk melihat detail perintah lengkap.

      gcloud database-migration connection-profiles create postgresql

      Contoh ini menggunakan tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --no-async untuk menjalankan perintah secara asinkron. Jika ya, Anda harus menggunakan perintah gcloud database-migration operations describe untuk memverifikasi apakah operasi Anda berhasil.

      Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

      • DEST_CONN_ID dengan ID profil koneksi tujuan.
      • REGION dengan region tempat Anda ingin menyimpan profil koneksi. Region ini harus sama dengan region cluster tujuan Anda.
      • DEST_CLUSTER dengan ID atau jalur resource lengkap cluster AlloyDB untuk PostgreSQL tujuan Anda.
      • DEST_USER dengan nama pengguna migrasi di database tujuan Anda.
      • DEST_PASSWORD dengan sandi untuk pengguna migrasi di database tujuan.

      Jalankan perintah berikut:

      Linux, macOS, atau Cloud Shell

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
        --region=REGION \
        --alloydb-cluster=DEST_CLUSTER \
        --username=DEST_USER \
        --password=DEST_PASSWORD \
        --role=DESTINATION \
        --no-async

      Windows (PowerShell)

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
        --region=REGION `
        --alloydb-cluster=DEST_CLUSTER `
        --username=DEST_USER `
        --password=DEST_PASSWORD `
        --role=DESTINATION `
        --no-async

      Windows (cmd.exe)

      Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI melalui autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
        --region=REGION ^
        --alloydb-cluster=DEST_CLUSTER ^
        --username=DEST_USER ^
        --password=DEST_PASSWORD ^
        --role=DESTINATION ^
        --no-async

      Anda akan melihat respons seperti berikut:

      Waiting for connection profile [CONNECTION_PROFILE_ID]
      to be created with [OPERATION_ID]
      
      Waiting for operation [OPERATION_ID] to complete...done.
      
      Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
      

   Cluster yang ada

   Untuk bermigrasi ke cluster tujuan yang ada, buat profil koneksi yang mengarah ke cluster yang telah dibuat sebelumnya. Jalankan perintah berikut (klik untuk meluaskan):

   gcloud database-migration connection-profiles create postgresql

   Contoh ini menggunakan tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --no-async untuk menjalankan perintah secara asinkron. Jika ya, Anda harus menggunakan perintah gcloud database-migration operations describe untuk memverifikasi apakah operasi Anda berhasil.

   Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • DEST_CONN_ID dengan ID profil koneksi tujuan.
   • REGION dengan region tempat Anda ingin menyimpan profil koneksi. Region ini harus sama dengan region cluster tujuan Anda.
   • DEST_CLUSTER dengan ID atau jalur resource lengkap cluster AlloyDB untuk PostgreSQL tujuan Anda.
   • DEST_USER dengan nama pengguna migrasi di database tujuan Anda.
   • DEST_PASSWORD dengan sandi untuk pengguna migrasi di database tujuan.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
     --region=REGION \
     --alloydb-cluster=DEST_CLUSTER \
     --username=DEST_USER \
     --password=DEST_PASSWORD \
     --role=DESTINATION \
     --no-async

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
     --region=REGION `
     --alloydb-cluster=DEST_CLUSTER `
     --username=DEST_USER `
     --password=DEST_PASSWORD `
     --role=DESTINATION `
     --no-async

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI melalui autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
     --region=REGION ^
     --alloydb-cluster=DEST_CLUSTER ^
     --username=DEST_USER ^
     --password=DEST_PASSWORD ^
     --role=DESTINATION ^
     --no-async

   Anda akan melihat respons seperti berikut:

   Waiting for connection profile [CONNECTION_PROFILE_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
   

6. Buat tugas migrasi.
   Jalankan perintah berikut untuk membuat tugas migrasi berkelanjutan (klik untuk meluaskan):

   gcloud database-migration migration-jobs create

   Contoh ini menggunakan tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --no-async untuk menjalankan perintah secara asinkron. Jika ya, Anda harus menggunakan perintah gcloud database-migration operations describe untuk memverifikasi apakah operasi Anda berhasil.

   Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • MIGRATION_JOB_ID dengan ID tugas migrasi Anda.
   • REGION dengan region tempat Anda ingin menyimpan tugas migrasi.
   • SOURCE_CONN_ID dengan ID profil koneksi sumber.
   • DEST_CONN_ID dengan ID profil koneksi tujuan.
   • DATABASES_LIST dengan daftar database yang dipisahkan koma yang ingin Anda migrasikan.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration migration-jobs create \
     MIGRATION_JOB_ID \
     --region=REGION \
     --type=CONTINUOUS \
     --source=SOURCE_CONN_ID \
     --destination=DEST_CONN_ID \
     --use-postgres-native \
     --postgres-max-additional-subscriptions=10 \
     --databases-filter=DATABASES_LIST \
     --no-async

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration migration-jobs create `
     MIGRATION_JOB_ID `
     --region=REGION `
     --type=CONTINUOUS `
     --source=SOURCE_CONN_ID `
     --destination=DEST_CONN_ID `
     --use-postgres-native `
     --postgres-max-additional-subscriptions=10 `
     --databases-filter=DATABASES_LIST `
     --no-async

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI melalui autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration migration-jobs create ^
     MIGRATION_JOB_ID ^
     --region=REGION ^
     --type=CONTINUOUS ^
     --source=SOURCE_CONN_ID ^
     --destination=DEST_CONN_ID ^
     --use-postgres-native ^
     --postgres-max-additional-subscriptions=10 ^
     --databases-filter=DATABASES_LIST ^
     --no-async

   Anda akan melihat respons seperti berikut:

   Waiting for migration job [MIGRATION_JOB_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created migration job MIGRATION_JOB_ID [OPERATION_ID]
   

7. Mulai tugas migrasi.
   Untuk memulai tugas migrasi, jalankan perintah berikut (klik untuk meluaskan):

   gcloud database-migration migration-jobs start

   gcloud database-migration migration-jobs start MIGRATION_JOB_ID \
     --region=REGION

Menyelesaikan migrasi

Saat Anda memutuskan untuk mengalihkan aplikasi ke instance AlloyDB untuk PostgreSQL yang baru, selesaikan migrasi dengan mengikuti langkah-langkah berikut:

1. Hentikan semua operasi penulisan di database sumber Anda. Anda dapat mengalihkannya ke mode hanya baca untuk mempertahankan fungsi operasional.
2. Mempromosikan tugas migrasi. Untuk migrasi mulai cepat, instance tujuan Anda tetap dapat ditulis selama proses migrasi. Mempromosikan tugas migrasi hanya akan mengakhiri replikasi dan tidak memengaruhi instance tujuan Anda.
3. Opsional: Verifikasi kelengkapan data migrasi.

Langkah berikutnya

• Pelajari lebih lanjut AlloyDB untuk PostgreSQL.