Migrasi Oracle ke PostgreSQL

Ekstensi PostgreSQL untuk Visual Studio Code menyediakan alur kerja end-to-end untuk memigrasikan database Oracle ke PostgreSQL. Asisten terpandu memandu Anda melalui proses menghubungkan ke sumber Oracle Anda, memilih skema, mengonfigurasi model Microsoft Foundry untuk konversi DDL berbantuan AI, dan memilih database sementara PostgreSQL untuk validasi. Setelah proyek dibuat, dasbor melacak ekstraksi, konversi, ekspor, dan tinjauan dalam satu tampilan.

Important

Alur kerja migrasi Oracle ke PostgreSQL hanya tersedia di Visual Studio Code.

Bagaimana skema dan konversi aplikasi cocok bersama-sama

Ekstensi mengonversi beban kerja Oracle dalam dua pass. Konversi skema berjalan terlebih dahulu dan menghasilkan bahasa definisi data (DDL) PostgreSQL untuk objek database Anda. Konversi aplikasi berjalan setelahnya dan memperbarui kode yang memanggil objek tersebut.

Konversi skema

Konversi skema membaca kamus data Oracle untuk skema yang Anda pilih, mengelompokkan objek yang diekstrak menjadi potongan yang diurutkan dependensi, dan mengonversi setiap gugus dengan menggunakan penyebaran Microsoft Foundry Anda. Objek yang dikonversi dikompilasi terhadap database awal sebelum ditulis, sehingga DDL yang Anda terima diverifikasi daripada tebakan terbaik. Eksekusi menghasilkan:

  • File PostgreSQL .sql tingkat objek, diatur oleh skema Oracle dan jenis objek.
  • Laporan konversi yang merekam objek mana yang dikonversi, yang dilewati, dan tingkat keberhasilan keseluruhan.
  • Tinjau tugas untuk objek yang memerlukan penilaian manusia, seperti DDL fallback atau perilaku yang berbeda antara Oracle dan PostgreSQL.
  • Catatan pengkodean yang menjelaskan pola Oracle yang ditemukan dalam skema dan bagaimana mereka memetakan ke PostgreSQL.

Konversi aplikasi

Konversi aplikasi menargetkan kode khusus Oracle yang mengelilingi database: Skrip SQL, panggilan prosedur tersimpan, file kontrol pemuat, skrip shell, dan file Java. Dibutuhkan catatan pengkodean dari konversi skema sebagai input, sehingga kode aplikasi yang dikonversi berbaris dengan nama objek, jenis, dan konvensi panggilan yang sebenarnya dihasilkan oleh konversi skema.

Anda dapat mengonversi kode aplikasi terkait database di dalam ekstensi ini, atau menyerahkan pekerjaan ke ekstensi modernisasi gitHub aplikasi Copilot untuk lulus modernisasi penuh.

Urutan dua lolos

Jalankan konversi skema terlebih dahulu. Konversi aplikasi tergantung pada catatan pengkodean dan nama objek yang dikonversi yang dihasilkan konversi skema, jadi mengonversi kode aplikasi sebelum skema selesai menghasilkan kode yang menargetkan objek yang mungkin masih berubah. Jika Anda menjalankan ulang konversi skema setelah mengubah cakupan skema atau memperbaiki objek sumber, tinjau kode aplikasi lagi terhadap catatan pengodean yang diperbarui.

Prerequisites

Sebelum memulai, pastikan Anda memiliki:

  • Visual Studio Code terinstal.
  • Ekstensi PostgreSQL terinstal.
  • Akses ke database sumber Oracle dengan izin baca untuk ekstraksi skema.
  • Server Azure Database for PostgreSQL fleksibel untuk digunakan sebagai database validasi awal. Konversi skema tidak mendukung Azure HorizonDB sebagai database awal.
  • Sumber daya Microsoft Foundry dengan model gpt-5.2 yang diterapkan. Anda memerlukan URL titik akhir dan kunci API atau akun Microsoft Entra ID dengan akses.

Memverifikasi fitur migrasi diaktifkan

Pengaturan pgsql.enableMigrations mengontrol tampilan Migrasi dan semua perintah migrasi. Setelan ini diaktifkan secara asali.

Jika tampilan Migrasi tidak muncul di bar samping, buka pengaturan Visual Studio Code (Ctrl+, pada Windows/Linux, Cmd+, di macOS) dan verifikasi bahwa pgsql.enableMigrations diatur ke true.

Membuat proyek migrasi

Proyek migrasi adalah panduan empat langkah yang mengumpulkan sumber, target, dan konfigurasi AI Anda sebelum membuat ruang kerja proyek tersebut.

Langkah 1: penyiapan Project

  1. Buka tampilan Migrasi di bar samping.

  2. Mulai proyek baru dengan salah satu cara berikut:

    • Jika ruang kerja belum berisi project migrasi, pilih + Buat Project Migrasi dalam tampilan.
    • Pilih tombol + di toolbar tampilan.
    • Klik kanan folder ruang kerja di Explorer dan pilih Buka Project Migrasi.

    Halaman proyek migrasi New Oracle ke Azure Database for PostgreSQL terbuka, mencantumkan apa yang Anda butuhkan:

    • Detail koneksi untuk database sumber
    • Nama skema yang akan dikonversi
    • URL dan kunci titik akhir untuk sumber daya Microsoft Foundry
    • Nama koneksi untuk instans Azure Database for PostgreSQL yang sudah ada

  3. Masukkan nama di bidang Nama Project.

  4. Pilih Berikutnya: Koneksi Oracle.

Cuplikan layar halaman project migrasi baru dengan bidang Nama Project.

Langkah 2: Sambungkan ke Oracle

Halaman Sambungkan ke Oracle mengumpulkan kredensial database sumber Oracle Anda dan memungkinkan Anda memuat skema.

  1. Lengkapi bidang koneksi Oracle:

    Ladang Deskripsi
    Nama Host Oracle Nama host atau alamat IP server database Oracle.
    Oracle Port Port pendengar (default: 1521).
    Oracle SID atau Nama Layanan Oracle SID atau nama layanan untuk instans database.
    Nama Pengguna Oracle Pengguna database dengan akses baca ke objek skema.
    Kata Sandi Oracle Kata sandi untuk pengguna Oracle.

  2. Pilih Muat Skema untuk menyambungkan dan mengambil daftar skema yang tersedia.

  3. Di daftar dropdown Skema , pilih satu atau beberapa skema untuk dimigrasikan.

  4. Pilih Berikutnya: Koneksi PostgreSQL.

Langkah 3: Pilih database sementara Azure Database for PostgreSQL

Pada halaman Pilih database sementara Azure Database for PostgreSQL, Anda memilih instans PostgreSQL yang digunakan model AI untuk memvalidasi file DDL hasil konversi.

Note

Gunakan database scratch khusus untuk validasi. Ekstensi mungkin menjalankan DDL yang dikonversi terhadap database ini selama proses konversi.

  1. Di daftar dropdown Koneksi PostgreSQL , pilih profil koneksi yang sudah ada. Jika koneksi yang Anda butuhkan tidak tercantum, pilih Refresh Profil untuk memuat ulang profil yang tersedia, atau buat koneksi baru di tampilan Koneksi dan identitas terlebih dahulu.
  2. Di daftar dropdown Database PostgreSQL , pilih database target. Pilih Muat Database jika daftar kosong.
  3. Setelah Anda memilih database, ekstensi secara otomatis memverifikasi bahwa ekstensi PostgreSQL yang direkomendasikan diinstal. Anda juga dapat memilih Verifikasi Ekstensi untuk menjalankan pemeriksaan secara manual. Jika ada ekstensi yang hilang, halaman akan mencantumkannya beserta panduan untuk menambahkan ekstensi tersebut ke daftar yang diizinkan dan memasangnya.
  4. Pilih Berikutnya: Konfigurasi Model Microsoft Foundry.

Langkah 4: Mengonfigurasi model Microsoft Foundry

Halaman Pilih Model Microsoft Foundry mengonfigurasi penyebaran Microsoft Foundry yang mendukung skema dan konversi kode.

  1. Lengkapi bidang model bahasa:

    Ladang Deskripsi
    Nama Model gpt-5.2.
    Titik Akhir Microsoft Foundry URL titik akhir sumber daya Microsoft Foundry (misalnya, https://<resource>.openai.azure.com/).
    Metode Autentikasi Pilih Kunci API atau Id Microsoft Entra.
    Kunci API Microsoft Foundry Kunci API untuk sumber daya Microsoft Foundry (ditampilkan saat Metode Autentikasi adalah Kunci API).
    Akun Azure akun Microsoft dengan akses ke sumber daya (ditampilkan saat Metode Autentikasi adalah Microsoft Entra Id).
    Tenant Microsoft Entra penyewa untuk akun (ditampilkan saat Metode AutentikasiMicrosoft Entra Id).
    Nama Penyebaran Nama model yang disebarkan di sumber daya Microsoft Foundry Anda.

  2. Pilih Uji Koneksi Microsoft Foundry untuk memverifikasi konektivitas.

  3. Pilih Buat Proyek Migrasi.

Tip

Microsoft Foundry merekomendasikan 500.000 TPM (Token Per Menit) untuk performa migrasi yang optimal.

Menjalankan migrasi skema

Setelah proyek dibuat, dasbor Migrasi Oracle terbuka. Dasbor menampilkan kartu Migrasi Skema dan Tinjauan Skema , bersama dengan akordion Pengaturan yang meringkas konfigurasi proyek Anda.

Mengekstrak dan mengonversi skema

Kartu Migrasi Skema (Langkah 1) menjalankan ekstraksi, konversi, dan ekspor sebagai alur berkelanjutan.

  1. Pada kartu Migrasi Skema , pilih Migrasi.

    Teks tombol diperbarui seiring pipeline berjalan:

    Status Label tombol
    Ekstraksi sedang berlangsung Sedang mengekstrak...
    Ekstraksi selesai, konversi tertunda Lanjutkan Migrasi
    Konversi berjalan Mengkonversi...
    Semua fase selesai Migrasi Selesai

  2. Pantau kemajuan di kartu yang diperluas:

    • Ekstraksi menunjukkan jumlah objek yang diekstrak (misalnya, "15 dari 42 objek yang diekstrak") dan skema dan objek saat ini sedang diproses.
    • Konversi menampilkan jumlah chunk yang dikonversi (misalnya, "3 dari 8 chunk dikonversi") serta chunk yang sedang diproses saat ini.

  3. Setelah ekspor selesai, pilih Lihat Laporan Migrasi untuk membuka laporan migrasi yang dihasilkan.

Meninjau tugas migrasi

Kartu Tinjauan Skema (Langkah 2) menampilkan item yang memerlukan perhatian manual setelah konversi. PengalihTugas / di bagian atas area tinjauan memungkinkan Anda memilih cara bekerja melalui daftar.

Tampilan yang dikelompokkan

Tampilan Dikelompokkan mengatur tugas peninjauan ke dalam kelompok akordeon yang bisa diciutkan berdasarkan kategori. Gunakan tampilan ini saat Anda ingin memproses masalah terkait bersama-sama.

  1. Pada kartu Tinjauan Skema , pilih Tinjau untuk memperluas permukaan tinjauan, lalu pilih Dikelompokkan.

  2. Gunakan tab Tertunda dan Teratasi untuk beralih antar tugas yang masih memerlukan perhatian dan tugas yang telah Anda setujui.

  3. Perluas grup untuk melihat metadatanya (skema, jenis objek, kekritisan) dan kartu tugas individual di dalamnya.

  4. Gunakan tindakan tingkat grup untuk memproses tugas secara massal:

    Tindakan Deskripsi
    Jalankan semua Buka setiap tugas yang tertunda dalam grup dalam Mode Agen Copilot untuk tinjauan yang dibantu AI.
    Atasi semua Tandai semua tugas di grup sebagai terselesaikan. Dialog konfirmasi memperlihatkan nama grup dan jumlah tugas sebelum melanjutkan.
    Reset semua Mengembalikan semua tugas yang diselesaikan dalam grup ke status tertunda. Tersedia di tab Teratasi .
    Tampilkan dalam Tugas Beralih ke tampilan datar Tugas yang difilter untuk grup ini.

  5. Untuk bertindak pada satu tugas di dalam grup, pilih Jalankan Tugas untuk membukanya dalam Mode Agen Copilot, atau pilih Selesaikan untuk menandainya selesai. Pilih Reset pada tugas yang diselesaikan untuk mengembalikannya ke status tertunda.

Note

Atasi semua dan Reset semua dinonaktifkan saat grup berisi lebih dari 800 tugas.

Tampilan tugas

Tampilan Tugas memperlihatkan semua tugas tinjauan dalam tabel datar. Gunakan tampilan ini saat Anda ingin mengurutkan, memfilter, atau mencari di semua tugas terlepas dari grup.

  1. Pilih Tugas di pengalih.
  2. Gunakan menu dropdown filter (Status, Kekritisan, Jenis Objek, Skema) untuk mempersempit daftar tugas.
  3. Pilih Jalankan Tugas pada item yang tertunda untuk membukanya dalam Mode Agen Copilot untuk tinjauan dan koreksi yang dibantu AI.
  4. Setelah memperbaiki item, pilih Selesaikan untuk menandainya selesai.

Tip

Pilih Tampilkan Log di dasbor untuk memeriksa file log ekstraksi dan konversi untuk pemecahan masalah.

Memigrasikan kode aplikasi

Setelah migrasi skema, konversikan kode aplikasi khusus Oracle (skrip SQL, prosedur tersimpan, file kontrol pemuat, skrip shell, atau file Java) ke setara yang kompatibel dengan PostgreSQL. Migrasi aplikasi adalah fitur pratinjau.

Pilih metode migrasi

Ekstensi ini menawarkan dua jalur untuk migrasi kode aplikasi:

  • Modernisasi aplikasi penuh: Jika Anda menginstal ekstensi modernisasi GitHub aplikasi Copilot, pilih Migrasi menggunakan modernisasi aplikasi untuk melanjutkan migrasi dengan catatan pengkodian dari konversi skema. Pilih Tampilkan catatan pengkodian untuk meninjau panduan yang dihasilkan sebelum melanjutkan.
  • Opsi khusus database: Untuk mengonversi hanya kode aplikasi terkait database dalam ekstensi ini, pilih Migrasi menggunakan ekstensi PostgreSQL.

Mengonversi kode aplikasi dalam ekstensi

  1. Pada kartu Migrasi Aplikasi , pilih Migrasi Data (atau Pilih Metode jika ekstensi modernisasi aplikasi terdeteksi).
  2. Di halaman Konversi Aplikasi , pilih Pilih Aplikasi Oracle untuk Dikonversi dan pilih folder yang berisi kode aplikasi Oracle.
  3. Pilih Koneksi PostgreSQL dan Database PostgreSQL untuk konteks konversi.
  4. Pilih Muat Database jika daftar database kosong.
  5. Pilih Konversi Aplikasi untuk memulai konversi.

Menggunakan alat Copilot untuk migrasi aplikasi

Ekstensi ini mendaftarkan dua alat model bahasa Copilot untuk bantuan migrasi:

  • Oracle Client Code Application Converter (pgsql_migration_oracle_app): Mengonversi kode aplikasi klien Oracle ke setara PostgreSQL dengan menggunakan templat prompt dan panduan pengodean dari analisis migrasi skema. Menerima parameter berikut:

    • Folder Basis Kode Aplikasi (diperlukan): Lokasi kode yang akan dikonversi.
    • Coding Notes Location Path (opsional): Jalur ke catatan pengkodian dari migrasi skema.
    • Nama Postgres DB (opsional): Nama database PostgreSQL untuk konteks konversi.
    • Koneksi Postgres DB (opsional): Nama koneksi untuk database PostgreSQL.

  • Tampilkan Oracle ke Laporan Migrasi Postgres (pgsql_migration_show_report): Menampilkan laporan migrasi yang dihasilkan oleh konversi skema. Memerlukan parameter Path to Report File .

Untuk informasi selengkapnya tentang menggunakan alat Copilot, lihat integrasi Copilot.

Membandingkan file yang dikonversi

Setelah konversi, tinjau perubahan secara berdampingan menggunakan perintah diff bawaan.

  1. Di Explorer, klik kanan file SQL yang dikonversi di bawah oracle folder atau postgres dalam proyek migrasi dan pilih Bandingkan Pasangan File Migrasi DDL.
  2. Untuk file kode aplikasi yang dikonversi (.sql, .ctl, , .sh.load, atau .java), klik kanan file dan pilih Bandingkan Pasangan File Migrasi Aplikasi.

Tampilan diff berdampingan menunjukkan sumber Oracle asli bersama output PostgreSQL yang dikonversi, sehingga Anda dapat mengidentifikasi artefak apa pun yang memerlukan penyesuaian manual.

Note

File DDL harus mengikuti struktur folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql untuk perintah bandingkan untuk menemukan pasangan file yang cocok.

Mengelola proyek migrasi

Gunakan tampilan Migrasi di bar samping untuk mengelola proyek Anda:

Tindakan Deskripsi
Proyek Migrasi Terbuka Buka proyek migrasi yang sudah ada di dasbor.
Ungkapkan di Explorer Perlihatkan folder proyek dalam tampilan Explorer.
Menghapus Menghapus proyek migrasi. Anda diminta untuk mengonfirmasi sebelum penghapusan.
Refresh Muat ulang daftar proyek migrasi di ruang kerja saat ini.

Konten terkait

  • Last updated on