Menggunakan migrasi mulai cepat untuk bermigrasi ke Cloud SQL

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 Cloud SQL untuk PostgreSQL.

Ringkasan

Migrasi mulai cepat adalah alur migrasi berkelanjutan yang 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 instance Cloud SQL yang ada, atau membuat instance 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 instance tujuan di project yang berbeda dengan sumber dan menyetel Database Migration Service untuk membuat lampiran jaringan dan subnet di jaringan Virtual Private Cloud (VPC) project lain.

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

  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 Cloud SQL Admin API.

   Aktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menjalankan migrasi mulai cepat ke Cloud SQL 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 diwariskan 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 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)
• Cloud SQL Admin (roles/cloudsql.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.*
• cloudsql.instances.create
• cloudsql.instances.delete
• cloudsql.instances.get
• cloudsql.instances.list
• cloudsql.instances.update
• cloudsql.instances.connect
• cloudsql.instances.executeSql
• cloudsql.instances.export
• cloudsql.instances.import
• cloudsql.instances.login
• cloudsql.operations.get
• cloudsql.users.get
• cloudsql.users.list
• cloudsql.users.create
• cloudsql.users.update
• cloudsql.users.delete

Mengonfigurasi database sumber Anda

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. Berikan 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 langkah berikut:
   • Tetapkan peran PostgreSQL SUPERUSER ke akun migrasi.
     • Untuk sumber Cloud SQL untuk PostgreSQL, tetapkan peran cloudsqlsuperuser.
     • Untuk sumber lain, tetapkan peran SUPERUSER atau lihat dokumentasi penyedia database Anda untuk mengetahui kumpulan izin yang setara.
   • 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, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Mulai.

   Buka Mulai

2. Di menu Source engine, pilih PostgreSQL.
3. Di menu Destination engine, pilih CloudSQL for PostgreSQL.

   Bagian Memperkenalkan migrasi PostgreSQL mulai cepat akan muncul.

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

   Halaman Migrate to Cloud SQL for PostgreSQL akan terbuka.

5. Di bagian Konfigurasi migrasi, lakukan hal berikut:
   1. Dari menu Destination region, pilih region instance Cloud SQL tujuan Anda.
   2. Di kotak Awalan migrasi, masukkan string yang mudah dipahami yang akan ditambahkan ke nama semua entitas migrasi yang dibuat untuk migrasi mulai cepat: profil koneksi, konfigurasi konektivitas pribadi, lampiran jaringan dan subnetnya, serta tugas migrasi.
   3. Dari menu Configuration type, pilih salah satu opsi berikut:
      1. Konfigurasi konektivitas yang ada: Pilih opsi ini jika Anda sudah memiliki lampiran jaringan 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 lampiran jaringan baru dan subnet lampiran jaringan di jaringan VPC database sumber. Konfigurasi konektivitas pribadi akan dibuat di project yang sama dengan instance 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 Cloud SQL.
   Klik Lanjutkan.
7. Di bagian Konfigurasi tujuan, Anda dapat membuat instance tujuan baru, atau memilih instance yang ada.

   Instance baru

   Jika Anda ingin membuat instance tujuan baru, lakukan langkah berikut:

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

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

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

   Instance yang ada

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

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

   Database Migration Service kini membuat tugas migrasi dan memulai proses migrasi. Anda dapat memantau progres migrasi di detail tugas migrasi Database Migration Service. Untuk mengetahui informasi selengkapnya, lihat Mengelola tugas migrasi.

Menyelesaikan migrasi

Saat Anda memutuskan untuk mengalihkan aplikasi ke instance Cloud SQL baru, selesaikan migrasi dengan mengikuti langkah-langkah berikut:

1. Hentikan semua operasi tulis pada database sumber Anda. Anda dapat mengalihkannya ke mode hanya baca untuk mempertahankan fungsi operasional.
2. Mempromosikan tugas migrasi.
3. Opsional: Verifikasi kelengkapan data migrasi.

Langkah berikutnya

• Pelajari lebih lanjut Cloud SQL.