Menggunakan migrasi mulai cepat dengan Database Migration Service

MySQL | PostgreSQL | SQL Server

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 untuk PostgreSQL yang ada, atau membuat instance baru saat mengonfigurasi migrasi. Migrasi mulai cepat paling cocok untuk:

Migrasi dasar, saat Anda tidak memerlukan kontrol yang akurat 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 Migrasi mulai cepat dalam dokumentasi Database Migration Service.

Sebelum memulai

Verifikasi apakah migrasi mulai cepat dapat sepenuhnya mendukung skenario Anda. Lihat Batasan migrasi mulai cepat dalam dokumentasi Database Migration Service.

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.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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 for PostgreSQL dengan Database Migration Service, minta administrator 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.

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: 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:
```
service-DESTINATION_PROJECT_NUMBER@gcp-sa-datamigration.iam.gserviceaccount.com
```

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:

Buat akun pengguna migrasi khusus di instance Anda.
- Untuk sumber Cloud SQL untuk PostgreSQL, lihat Membuat pengguna dalam dokumentasi Cloud SQL untuk PostgreSQL.
- Untuk sumber lainnya, lihat dokumentasi penyedia database Anda atau buat dan kelola pengguna dalam dokumentasi PostgreSQL.

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.

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.
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.
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

Saat menggunakan migrasi mulai cepat, Anda dapat membuat instance Cloud SQL baru dan memigrasikan database Anda ke sana, atau memigrasikan database ke instance yang sudah ada.

Migrasi mulai cepat untuk instance baru

Untuk membuat instance Cloud SQL untuk PostgreSQL baru dan segera memigrasikan database Anda ke sana, ikuti langkah-langkah berikut:

Buka halaman Instances.
Buka Instances
Klik Create instance > From an existing database.
Di jendela Migrate existing database, pilih Quick-start PostgreSQL migration, lalu klik Continue.
Formulir migrasi mulai cepat Database Migration Service akan terbuka.
Di bagian Konfigurasi migrasi, lakukan hal berikut:
1. Dari menu Destination region, pilih region instance Cloud SQL for PostgreSQL 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.
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 untuk PostgreSQL.
Di bagian Konfigurasi tujuan, lakukan tindakan berikut:
1. Dari menu Destination instance type, pilih New instance.
  Database Migration Service menggunakan konfigurasi Cloud SQL untuk PostgreSQL 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.
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 dalam dokumentasi Database Migration Service.

Migrasi mulai cepat untuk instance yang ada

Untuk memigrasikan database ke instance Cloud SQL yang ada, ikuti langkah-langkah berikut:

Buka halaman Instances.
Buka Instances
Pilih instance Cloud SQL tempat Anda ingin memigrasikan database.
Di halaman detail instance, klik Migrasikan database.
Formulir migrasi mulai cepat Database Migration Service akan terbuka.
Di bagian Konfigurasi migrasi, lakukan hal berikut:
1. Dari menu Destination region, pilih region instance Cloud SQL for PostgreSQL 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 antarmuka Private Service Connect di jaringan VPC database sumber. 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, subnet lampiran jaringan, dan konfigurasi konektivitas pribadi baru di jaringan VPC database sumber.
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 untuk PostgreSQL.
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 dalam dokumentasi Database Migration Service.

Menyelesaikan migrasi

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

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

Langkah berikutnya

Pelajari alur migrasi lainnya dan kemampuan Database Migration Service secara keseluruhan.