Membuat ruang kerja konversi dan mengonversi skema

Halaman ini menunjukkan cara membuat ruang kerja konversi dan menggunakannya untuk segera melakukan konversi kode dan skema deterministik dari Oracle ke PostgreSQL.

Anda dapat membuat ruang kerja konversi interaktif dengan dua cara:

  • Melalui koneksi database langsung: Database Migration Service terhubung langsung ke database sumber yang sedang berjalan melalui profil koneksi dan mengambil skema melalui koneksi jaringan.

  • Dengan file skema di Cloud Storage: Anda dapat mengekstrak metadata skema secara lokal menggunakan skrip ekstraksi yang disediakan Google, mengupload file yang dihasilkan ke bucket Cloud Storage, dan menyiapkan ruang kerja tanpa terhubung ke database sumber.

Terhubung langsung ke database sumber

Anda dapat membuat ruang kerja konversi interaktif dan melakukan konversi skema dengan terhubung langsung ke database sumber menggunakan Database Migration Service. Sebelum membuat ruang kerja dengan cara ini, pastikan Anda membuat profil koneksi untuk database sumber.

Peran yang diperlukan untuk metode koneksi langsung

Untuk mendapatkan izin yang diperlukan untuk membuat ruang kerja konversi, minta administrator untuk memberi Anda peran IAM Database Migration Admin (roles/datamigration.admin) di project Anda.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses dalam dokumentasi Identity and Access Management.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk membuat ruang kerja konversi di Database Migration Service. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat ruang kerja konversi di Database Migration Service:

  • cloudaicompanion.entitlements.get

    Izin ini disertakan dalam peran roles/datamigration.admin. Hal ini diperlukan untuk fitur konversi yang ditingkatkan Gemini.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Membuat ruang kerja konversi dengan profil koneksi

Untuk membuat ruang kerja konversi tempat Database Migration Service terhubung ke database sumber Anda dan menyiapkan snapshot awal objek database sumber Anda, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka ruang kerja konversi.

    Buka Conversion workspaces

  2. Klik Siapkan ruang kerja.
  3. Di halaman Buat ruang kerja konversi, lakukan hal berikut:
    1. Masukkan nama, ID, dan region untuk ruang kerja konversi Anda.
    2. Dari menu drop-down Source database engine, pilih Oracle.
    3. Dari mesin database Tujuan, pilih Cloud SQL untuk PostgreSQL.

    4. Di bagian Aktifkan setelan Gemini untuk ruang kerja Anda, gunakan kotak centang untuk mengaktifkan fitur konversi yang didukung Gemini. Anda juga dapat mengaktifkan fitur ini nanti saat ingin Mengonversi kode dan skema dengan bantuan Gemini.

      Fitur konversi yang didukung Gemini memerlukan Gemini for Google Cloud API. Untuk informasi selengkapnya, lihat Fitur konversi yang didukung Gemini.

    5. Klik Buat ruang kerja dan lanjutkan.
  4. Di halaman Define source and pull schema snapshot, lakukan tindakan berikut:
    1. Di bagian Source connection method, pilih Connection profile.
    2. Dari menu drop-down Source connection profile, pilih profil koneksi untuk database sumber Anda.
    3. Klik Pull schema snapshot and continue.

    Database Migration Service kini terhubung ke database sumber dan mengambil skema Anda. Proses ini dapat memerlukan waktu beberapa menit.

  5. Di halaman Select and convert objects, gunakan kotak centang untuk memilih objek yang ingin Anda konversi ke sintaksis PostgreSQL.

    Anda tidak perlu mengonversi semua objek sekaligus. Sebagai gantinya, Anda dapat memilih beberapa objek saja sekarang dan menambahkan lebih banyak objek ke konversi nanti.

  6. Klik Konversi dan lanjutkan.

    Ruang kerja konversi akan terbuka.

  7. Saat membuka ruang kerja baru untuk pertama kalinya, Anda dapat mengupgradenya untuk mengakses fitur konversi otomatis yang didukung Gemini. Lakukan hal berikut:
    • Dalam dialog Memperkenalkan konversi otomatis Gemini, centang kotak Upgrade ruang kerja untuk menjelajahi pengalaman baru, lalu klik Lanjutkan.
    • Di dialog Convert source objects with Gemini?, klik Convert.

      Database Migration Service kini melakukan proses konversi lagi untuk menerapkan peningkatan konversi yang didukung Gemini di atas hasil konversi deterministik. Untuk mengetahui informasi selengkapnya tentang fitur konversi otomatis Gemini, lihat Konversi otomatis Gemini.

Menggunakan file skema yang disimpan di Cloud Storage

Anda dapat mengekstrak metadata skema secara lokal menggunakan skrip ekstraksi yang disediakan Google, mengupload file yang dihasilkan ke bucket Cloud Storage, dan menyiapkan ruang kerja tanpa terhubung ke database sumber.

Peran yang diperlukan untuk menggunakan file skema di Cloud Storage

Untuk mendapatkan izin yang diperlukan guna membuat ruang kerja konversi menggunakan file skema yang disimpan di Cloud Storage, minta administrator Anda untuk memberikan peran IAM yang diperlukan pada project Anda untuk akun berikut yang terlibat dalam proses migrasi:

  • Akun pengguna yang membuat ruang kerja konversi: Database Migration Admin (roles/datamigration.admin)
  • Akun layanan Database Migration Service: Peran Storage Object Viewer (roles/storage.objectViewer) di bucket Cloud Storage yang menyimpan file skema.

    Alamat email akun layanan Database Migration Service menggunakan format berikut: service-PROJECT_NUMBER@gcp-sa-datamigration.. Ganti PROJECT_NUMBER dengan nomor project Google Cloud Anda. Untuk mengetahui informasi selengkapnya tentang akun layanan ini, lihat Akun layanan Database Migration Service.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses dalam dokumentasi Identity and Access Management.

Peran bawaan roles/datamigration.admin berisi izin yang diperlukan untuk membuat ruang kerja konversi di Database Migration Service. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat ruang kerja konversi di Database Migration Service:

  • cloudaicompanion.entitlements.get

    Izin ini disertakan dalam peran roles/datamigration.admin. Hal ini diperlukan untuk fitur konversi yang ditingkatkan Gemini.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Membuat ruang kerja konversi dengan file skema

Untuk membuat ruang kerja konversi dengan file skema, ikuti langkah-langkah berikut.

  1. Ambil skrip Python dari konsol Google Cloud . Ikuti langkah-langkah berikut:
    1. Di konsol Google Cloud , buka ruang kerja konversi.

      Buka Conversion workspaces

    2. Klik Siapkan ruang kerja.
    3. Di halaman Buat ruang kerja konversi:
      1. Masukkan nama, ID, dan region ruang kerja.
      2. Dari menu drop-down Source database engine, pilih Oracle.
      3. Dari menu drop-down mesin database tujuan, pilih Cloud SQL untuk PostgreSQL.

      4. Di bagian Aktifkan setelan Gemini untuk ruang kerja Anda, gunakan kotak centang untuk mengaktifkan fitur konversi yang didukung Gemini, lalu klik Lanjutkan.

        Anda juga dapat mengaktifkan fitur ini nanti saat ingin Mengonversi kode dan skema dengan bantuan Gemini. Fitur konversi yang didukung Gemini memerlukan API Google Cloud Gemini for. Untuk mengetahui informasi selengkapnya, lihat Fitur konversi yang didukung Gemini.

    4. Di halaman Define source and pull schema snapshot, di bagian Source connection method, pilih Cloud Storage.
    5. Di bagian Before selecting a folder, di samping judul Oracle metadata extractor, klik Open. Ikuti petunjuk di panel samping untuk mendownload dan menjalankan utilitas ekstraksi pada database sumber Anda guna menghasilkan file JSON metadata skema. Utilitas ini mengharuskan Anda dapat membuat koneksi jaringan dengan database sumber.
  2. Buat bucket Cloud Storage khusus tempat Anda mengupload file JSON metadata skema. Untuk mengetahui informasi selengkapnya tentang cara membuat bucket Cloud Storage, lihat Membuat bucket dalam dokumentasi Cloud Storage.
  3. Di dalam bucket Cloud Storage khusus, buat folder khusus yang kosong untuk file skema database yang Anda ekspor di langkah sebelumnya. Untuk mengetahui informasi selengkapnya tentang cara membuat folder Cloud Storage, lihat Membuat dan mengelola folder dalam dokumentasi Cloud Storage.
  4. Upload hanya file skema JSON metadata yang Anda buat dengan skrip Python yang Anda ambil dari konsol Google Cloud pada langkah sebelumnya ke folder database khusus yang kosong di bucket Cloud Storage Anda.
  5. Lanjutkan membuat ruang kerja di konsol Google Cloud , atau buat yang baru dengan Google Cloud CLI.

    Konsol

    1. Setelah Anda mengupload file metadata skema yang diekstrak ke bucket Cloud Storage, lanjutkan di halaman Define source and pull schema snapshot.
    2. Di kolom Folder, klik Browse, lalu pilih folder yang berisi file skema Anda.
    3. Klik Pull schema snapshot and continue.

      Database Migration Service kini mengurai metadata skema dari bucket.

    4. Pada halaman Select and convert objects, pilih objek yang ingin Anda konversi, lalu klik Convert and continue.

    gcloud

    Setelah mengupload file metadata skema yang diekstrak ke bucket Cloud Storage, Anda dapat membuat dan melakukan inisialisasi ruang kerja baru dengan Google Cloud CLI. Ikuti langkah-langkah berikut:

    1. Buat ruang kerja konversi kosong.
      Jalankan perintah berikut (klik untuk meluaskan):

      gcloud database-migration conversion-workspaces create

        gcloud database-migration conversion-workspaces create WORKSPACE_ID \
      --region=REGION \
      --source-database-engine=ORACLE \
      --destination-database-engine=POSTGRESQL

      Ganti kode berikut:

      • WORKSPACE_ID: Dengan ID untuk ruang kerja konversi Anda.
      • REGION: Region tempat Anda ingin membuat ruang kerja.

    2. Melakukan inisialisasi ruang kerja menggunakan file skema Anda di Cloud Storage.
      Untuk mengurai dan memuat file metadata skema yang disimpan di bucket Anda ke dalam ruang kerja konversi, jalankan perintah berikut (klik untuk meluaskan):

      gcloud database-migration conversion-workspaces seed

        gcloud database-migration conversion-workspaces seed WORKSPACE_ID \
      --region=REGION \
      --gcs-path=gs://BUCKET_NAME/PREFIX/

      Ganti kode berikut:

      • WORKSPACE_ID: Dengan ID untuk ruang kerja konversi Anda.
      • REGION: Region tempat Anda ingin membuat ruang kerja.
      • BUCKET_NAME: Nama bucket Cloud Storage yang berisi file skema Anda.
      • PREFIX: Jalur ke folder yang berisi file metadata skema yang diekstrak.

Ruang kerja konversi lama

Ruang kerja konversi lama adalah jenis ruang kerja konversi yang lebih lama dan lebih terbatas. Sebaiknya jangan gunakan jenis ruang kerja konversi lama untuk migrasi Anda. Jika Anda perlu menggunakan ruang kerja konversi lama, luaskan bagian Membuat ruang kerja konversi lama dan mengonversi skema untuk mengetahui informasi selengkapnya.

Membuat ruang kerja konversi lama dan mengonversi skema

Ruang kerja konversi lama menggunakan file konfigurasi Ora2Pg. Sebelum membuat ruang kerja konversi lama, pastikan Anda membuat konfigurasi Ora2Pg terlebih dahulu di luar Database Migration Service. Untuk mengetahui informasi selengkapnya, lihat Bekerja dengan ruang kerja konversi lama.

  1. Di konsol Google Cloud , buka ruang kerja konversi.

    Buka Conversion workspaces

  2. Klik Siapkan ruang kerja.
  3. Di halaman Buat ruang kerja konversi, lakukan hal berikut:
    1. Masukkan nama, ID, dan region untuk ruang kerja konversi Anda.
    2. Dari menu drop-down Source database engine, pilih Oracle.
    3. Dari mesin database Tujuan, pilih Cloud SQL untuk PostgreSQL.
    4. Luaskan bagian Customize workspace configurations, lalu centang kotak Enable legacy conversion workspace.
    5. Klik Buat ruang kerja dan lanjutkan.
  4. Di halaman Connect to source and convert objects, lakukan tindakan berikut:
    1. Dari menu drop-down Source connection profile, pilih profil koneksi untuk database sumber Anda.

    2. Di kotak file konfigurasi, klik Browse dan gunakan pemilih file sistem untuk memilih file pemetaan konversi Anda.

      Anda dapat mengupload beberapa file pemetaan konversi dengan mengklik Tambahkan file.

    3. Di bagian Convert the configuration, klik Pull schema and convert.

      Database Migration Service kini terhubung ke database sumber, mengambil skema Anda, dan mengonversinya ke skema SQL tujuan sesuai dengan aturan yang ditentukan dalam file pemetaan konversi Anda. Proses ini dapat memerlukan waktu beberapa menit.

  5. Klik Simpan dan tutup.

    Halaman detail ruang kerja konversi akan terbuka.

Sekarang Anda dapat menerapkan skema yang dikonversi ke database tujuan. Jika database sumber Anda menyertakan tabel yang tidak memiliki kunci utama, Anda juga harus membuat batasan kunci utama secara manual di tabel yang dikonversi dalam database tujuan setelah menerapkan skema yang dikonversi. Untuk mengetahui informasi selengkapnya, lihat Bekerja dengan ruang kerja konversi lama.

Langkah berikutnya

Sekarang Anda dapat menggunakan ruang kerja konversi untuk memperbaiki masalah konversi, mengubah objek dengan editor interaktif, dan menerapkan skema yang dikonversi ke database tujuan. Lihat Mengonversi kode dan skema Oracle ke sintaksis PostgreSQL.