Tutorial: Konversi aplikasi Oracle ke Azure Database for PostgreSQL Flexible Server (Pratinjau)

Tutorial ini memandu Anda mengonversi kode aplikasi klien Oracle ke Azure Database for PostgreSQL menggunakan ekstensi Visual Studio Code PostgreSQL dengan Mode Agen GitHub Copilot untuk mengotomatiskan dan memvalidasi transformasi kode.

Ini mencakup pengaturan lingkungan Anda, mengimpor basis kode aplikasi Anda, menjalankan proses konversi, dan meninjau kode yang kompatibel dengan PostgreSQL yang dihasilkan. Sebelum memulai, pastikan Anda telah menyelesaikan proyek konversi skema untuk hasil yang optimal.

Berikut adalah apa yang dapat Anda harapkan selama konversi:

Penyiapan Lingkungan: Mengonfigurasi Mode Agen GitHub Copilot dengan model AI yang sesuai
Impor basis kode: Atur kode aplikasi Anda dalam struktur proyek migrasi
pemrosesan AI: GitHub Copilot memproses dan mengonversi kode aplikasi menggunakan konteks database
Eksekusi tugas TODO: Pembuatan daftar tugas otomatis dan konversi sistematis
Pembuatan laporan: Laporan konversi komprehensif dengan hasil dan rekomendasi
Perbandingan berkas: Alat diff bawaan untuk membandingkan kode asli dan kode setelah dikonversi

Prerequisites

Bagian ini menjelaskan prasyarat untuk menggunakan fitur konversi aplikasi dari Oracle ke Azure Database untuk PostgreSQL di Visual Studio Code sebelum memulai konversi.

Persyaratan sistem

Persyaratan	Specification
Versi dari Visual Studio Code	1.95.2 atau lebih tinggi
langganan GitHub Copilot	Pro+, Bisnis, Perusahaan

Dukungan sistem operasi

Platform	Architecture
Windows	x64 dan ARM64
Linux	x64 dan ARM64
macOS	x64 (Intel) dan ARM64 (Apple Silicon)

Persyaratan model AI

Anda memerlukan salah satu model AI berikut yang dikonfigurasi dalam Mode Agen GitHub Copilot:

Model	Versi
Claude	Sonnet 4.6 atau Opus 4.6 atau yang lebih tinggi

Sebelum memulai konversi aplikasi, atur Model Mode Agen GitHub Copilot Anda ke Claude Sonnet 4.6 atau Claude Opus 4.6 atau yang lebih tinggi untuk hasil transformasi kode yang optimal.

Dukungan versi PostgreSQL

Target Database	Versi
Database Azure untuk Server Fleksibel PostgreSQL	PostgreSQL versi 15 atau lebih tinggi
Azure HorizonDB	PostgreSQL versi 17 atau lebih tinggi

Rekomendasi konversi skema

Meskipun tidak diperlukan untuk melakukan konversi skema database sebelumnya, menyelesaikan migrasi skema terlebih dahulu sangat disarankan. Jika Anda sudah mengonversi skema Oracle Anda ke PostgreSQL, proses konversi aplikasi memberikan konteks yang lebih akurat dan hasil transformasi kode berkualitas lebih tinggi melalui:

Catatan Pengkodian: Artefak metadata yang dihasilkan selama konversi skema (lihat Apa itu Catatan Pengkodian? di bawah)
Konteks database: Akses langsung ke objek skema yang dikonversi
Pemetaan jenis data: Pemahaman akurat tentang transformasi jenis

Prasyarat lain

Konektivitas database ke instans Azure Database for PostgreSQL Anda
Akses ke layanan marketplace ekstensi Visual Studio Code dan GitHub Copilot

Apa itu Catatan Pengkodian?

Coding Notes adalah artefak metadata yang dihasilkan secara otomatis selama fase konversi skema. Mereka menangkap detail transformasi utama dan wawasan dari konversi skema Oracle-to-PostgreSQL Anda yang kemudian digunakan proses untuk meningkatkan konversi kode aplikasi.

Catatan Pengkodian mungkin menyertakan informasi seperti:

Pemetaan jenis data dan perubahan struktural
Detail konversi untuk urutan, identitas, dan jenis komposit
Penyesuaian implementasi tanggal/waktu atau interval
Referensi ke tabel dengan batasan integritas referensial
Ringkasan paket Oracle yang kompleks, termasuk prosedur dan tanda tangan fungsi
Petunjuk tambahan yang dihasilkan AI untuk meningkatkan akurasi terjemahan kode

Selama konversi aplikasi, model AI menggunakan catatan ini sebagai sinyal kontekstual untuk menghasilkan kode yang kompatibel dengan PostgreSQL yang lebih tepat dan selaras secara semantik.

Proses konversi aplikasi

Bagian ini memandu alur kerja konversi aplikasi lengkap: menyiapkan lingkungan Anda, mengimpor basis kode Anda, menjalankan konversi, meninjau laporan yang dihasilkan, dan membandingkan perubahan file.

Langkah 1: Siapkan lingkungan Anda

Buka Visual Studio Code dengan ekstensi PostgreSQL terinstal.
Buka antarmuka obrolan GitHub Copilot.
Pilih Claude Sonnet 4.6 atau Claude Opus 4.6 untuk model.

Menggunakan Claude Sonnet 4.6 atau Claude Opus 4.6 diperlukan untuk hasil konversi aplikasi yang optimal. Model yang lebih rendah mungkin menghasilkan konversi yang kurang akurat.

Langkah 2: Buka proyek migrasi Anda

Buka ruang kerja yang berisi proyek konversi skema Anda.
Navigasikan ke struktur folder proyek migrasi:
```
.github/postgres-migration/project_name/
```
Verifikasi struktur proyek memuat folder dan file yang penting untuk konversi skema.

Langkah 3: Salin basis kode Anda ke dalam proyek migrasi

Temukan folder application_code di proyek Anda.

.github/postgres-migration/project_name/application_code/

Salin folder basis kode yang ingin Anda migrasikan ke folder di application_code dalam folder proyek Anda.
Atur file secara logis untuk memfasilitasi konversi sistematis.

Simpan kode aplikasi asli Anda di lokasi terpisah sebagai cadangan. Hanya salin file yang ingin Anda konversi ke dalam struktur proyek migrasi.

Langkah 4: Mulai migrasi kode klien

Di panel Migrasi ekstensi PostgreSQL, pilih Migrasi Aplikasi untuk memulai wizard konversi aplikasi.
Pada formulir yang dimuat, pilih folder yang Anda salin ke akar ruang kerja Anda.
Pilih database yang memiliki konteks untuk aplikasi Anda:
- Database PostgreSQL tempat Anda menyebarkan DDL yang dikonversi, atau
- Database PostgreSQL tempat skema aplikasi Anda sudah ada
Pilih Konversi Aplikasi.

Tindakan ini memulai proses berikut:

Memanggil petunjuk komposit kustom dan Alat Mode Agen
Menghasilkan daftar tugas yang perlu dilakukan yang akan diproses oleh Mode Agen.
Menghubungkan dan membaca database Anda untuk konteks yang lebih baik
Mengonversi file kode aplikasi secara sistematis

Langkah 5: Memantau kemajuan konversi

Saksikan antarmuka Mode Agen dari GitHub Copilot saat memproses file.
Agen bekerja melalui daftar tugas yang dihasilkan secara sistematis.
Tinjau perintah atau pertanyaan apa pun dari agen yang mungkin memerlukan input.
Izinkan proses konversi selesai sepenuhnya sebelum meninjau hasil.

Langkah 6: Konversi Java yang ditingkatkan dengan ekstensi Modernisasi Aplikasi GitHub Copilot (opsional)

Jika bekerja dengan kode Java: Anda dapat meningkatkan proses konversi dengan menginstal Ekstensi Modernisasi Aplikasi GitHub Copilot sebelum memulai konversi Anda.

Kompilasi pengujian otomatis

Dua ekstensi Visual Studio Code berkomunikasi satu sama lain untuk memberikan integrasi yang mulus. Saat mengonversi kode Java, Ekstensi Modernisasi Aplikasi secara otomatis melakukan kompilasi pengujian kode yang dikonversi untuk mengidentifikasi kesalahan sintaks atau masalah kompilasi di awal proses.

Pembuatan pengujian unit otomatis

Berdasarkan basis kode yang dikonversi, Ekstensi Modernisasi Aplikasi secara otomatis menghasilkan pengujian unit untuk membantu memvalidasi bahwa aplikasi Anda yang dikonversi berulah dengan benar. Integrasi ini memanfaatkan kemampuan Ekstensi Modernisasi Aplikasi untuk:

Menganalisis kelas dan metode Java yang dikonversi
Hasilkan kasus pengujian yang sesuai untuk jalur kode penting
Membuat perlengkapan pengujian yang berfungsi dengan koneksi database PostgreSQL Anda

Menginstal Ekstensi Modernisasi Aplikasi GitHub Copilot sangat disarankan untuk Java proyek migrasi, karena secara signifikan mempercepat validasi dan meningkatkan kualitas konversi melalui pemeriksaan kompilasi otomatis dan pembuatan pengujian.

Langkah 7: Meninjau laporan konversi kode

Ketika konversi aplikasi selesai dalam Mode Agen, konversi aplikasi secara otomatis menghasilkan dan membuka laporan komprehensif.
Laporan ini memberikan hasil terperinci dan langkah berikutnya yang direkomendasikan untuk konversi Anda.

Untuk panduan laporan yang komprehensif: Lihat laporan konversi aplikasi dari Oracle ke Azure Database for PostgreSQL yang dihasilkan (Pratinjau) untuk informasi terperinci mengenai cara menafsirkan hasil konversi, memahami status file, dan merencanakan strategi validasi.

Langkah 8: Membandingkan perubahan kode menggunakan fitur diff file

Klik kanan file yang dikonversi (misalnya, .java file) dan pilih Bandingkan Pasangan File Migrasi Aplikasi.
Ini membuka tampilan berdampingan dari file asli dan yang dikonversi.
Gunakan ini untuk memvalidasi transformasi penting sebelum pengujian.

Strategi perbandingan file yang efektif: Lihat laporan konversi aplikasi Oracle ke Azure Database untuk PostgreSQL yang dihasilkan (Pratinjau) untuk panduan tentang memprioritaskan file-file mana yang akan ditinjau terlebih dahulu dan cara memusatkan upaya validasi Anda.

Langkah 9: Memvalidasi kode aplikasi yang dikonversi

Langkah-langkah validasi penting:

Menyiapkan lingkungan pengujian nonproduksi dengan skema PostgreSQL Anda yang dikonversi
Menguji konektivitas database dengan string koneksi PostgreSQL baru
Menjalankan alur kerja bisnis penting untuk memverifikasi perilaku aplikasi
Memvalidasi hasil kueri SQL terhadap hasil yang diharapkan dari Oracle
Alamat area yang ditandai yang diidentifikasi dalam laporan konversi

Important

Sistem AI terkadang dapat membuat kesalahan. Untuk mencegah regresi fungsional, masalah keamanan, atau masalah akses data, validasi semua kode aplikasi yang dikonversi secara independen sebelum menyebarkan ke produksi.

Pendekatan validasi sistematis: Gunakan kerangka kerja validasi dalam praktik terbaik untuk mengonversi kode aplikasi Oracle ke Azure Database for PostgreSQL (pratinjau) untuk memprioritaskan pengujian berdasarkan kompleksitas integrasi Oracle dan hasil laporan konversi.

Langkah-langkah pasca-konversi

Setelah menyelesaikan konversi aplikasi:

Jalankan pengujian unit: Jalankan rangkaian pengujian aplikasi Anda terhadap kode yang dikonversi.
Pengujian integrasi: Uji aplikasi dengan database PostgreSQL Anda.
Pengujian performa: Validasi bahwa performa kueri memenuhi persyaratan.
Tinjauan kode: Minta anggota tim meninjau kode yang dikonversi untuk akurasi.
Pembaruan dokumentasi: Perbarui dokumentasi apa pun yang mereferensikan fitur khusus Oracle.

Pahami strategi validasi: Lihat Praktik terbaik untuk mengonversi kode aplikasi Oracle ke Azure Database for PostgreSQL (Pratinjau) untuk kerangka kerja validasi terperinci, prioritas pengujian, dan pendekatan koordinasi tim berdasarkan kompleksitas konversi Anda.

Untuk informasi selengkapnya tentang ekstensi Visual Studio Code, kunjungi ekstensi PostgreSQL untuk Visual Studio Code

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-06-08