Öğretici: Oracle'dan PostgreSQL için Azure Veri Tabanı esnek sunucusuna uygulama dönüştürme (Önizleme)

Bu öğretici, kod dönüştürmeyi otomatikleştirmek ve doğrulamak için GitHub Copilot Aracı Modu ile Visual Studio Code PostgreSQL uzantısını kullanarak Oracle istemci uygulama kodunu PostgreSQL için Azure Veri Tabanı dönüştürme işleminde size yol gösterir.

Ortamınızı ayarlamayı, uygulama kod tabanınızı içeri aktarmayı, dönüştürme işlemini çalıştırmayı ve oluşturulan PostgreSQL uyumlu kodu gözden geçirmeyi kapsar. Başlamadan önce, en iyi sonuçlar için şema dönüştürme projesini tamamladığınızdan emin olun.

Dönüştürme sırasında şunları bekleyebilirsiniz:

• Ortam kurulumu: GitHub Copilot Aracı Modu'nu uygun yapay zeka modeliyle yapılandırma
• Codebase içeri aktarma: Uygulama kodunuzu geçiş projesi yapısında düzenleme
• AI işleme: GitHub Copilot veritabanı bağlamı kullanarak uygulama kodunu işler ve dönüştürür
• TODO görev yürütme: Otomatik görev listesi oluşturma ve sistematik dönüştürme
• Rapor oluşturma: Sonuçlar ve öneriler içeren kapsamlı dönüştürme raporu
• Dosya karşılaştırması: Özgün ve dönüştürülen kodu gözden geçirmek için yerleşik fark araçları

Prerequisites

Bu bölümde, bir dönüştürme işlemine başlamadan önce Visual Studio Code'da uygulama dönüştürme özelliğini PostgreSQL için Azure Veri Tabanı için Oracle'ı kullanmanın önkoşulları açıklanmaktadır.

Sistem gereksinimleri

Gereksinim	Özellik
Visual Studio Code sürümü	1.95.2 veya üzeri
GitHub Copilot aboneliği	Pro+, İş, Kurumsal

İşletim sistemi desteği

Platform	Mimarlık
Windows	x64 ve ARM64
Linux	x64 ve ARM64
macOS	x64 (Intel) ve ARM64 (Apple Silicon)

Yapay zeka modeli gereksinimleri

GitHub Copilot Aracı Modu'nda yapılandırılmış aşağıdaki yapay zeka modellerinden birine ihtiyacınız vardır:

Model	Sürüm
Claude	Sonnet 4.6 veya Opus 4.6 veya üzeri

Uygulama dönüştürmeye başlamadan önce, en iyi kod dönüştürme sonuçları için GitHub Copilot Aracı Modu Modelinizi Claude Sonnet 4.6 veya Claude Opus 4.6 veya üzeri olarak ayarlayın.

PostgreSQL sürüm desteği

Hedef Veritabanı	Sürüm
esnek sunucu PostgreSQL için Azure Veritabanı	PostgreSQL sürüm 15 veya üzeri
Azure HorizonDB	PostgreSQL sürüm 17 veya üzeri

Şema dönüştürme önerisi

Önceden bir veritabanı şeması dönüştürmesi gerçekleştirmek gerekli olmasa da, önce bir şema geçişinin tamamlanması kesinlikle önerilir. Oracle şemanızı zaten PostgreSQL'e dönüştürdüyseniz, uygulama dönüştürme işlemi aşağıdakiler aracılığıyla daha doğru bağlam ve daha yüksek kaliteli kod dönüştürme sonuçları sağlar:

• Kodlama Notları: Şema dönüştürme sırasında oluşturulan meta veri yapıtları (aşağıdaki Kodlama Notları nedir? bölümüne bakın)
• Veritabanı bağlamı: Dönüştürülen şema nesnelerine doğrudan erişim
• Veri türü eşlemeleri: Tür dönüştürmelerini doğru anlama

Diğer önkoşullar

• PostgreSQL için Azure Veri Tabanı örneğine veritabanı bağlantısı
• Visual Studio Code uzantı marketine ve GitHub Copilot hizmetlerine erişim

Kodlama Notları nedir?

Kodlama Notları, şema dönüştürme aşamasında otomatik olarak oluşturulan meta veri yapıtlarıdır. Oracle'dan PostgreSQL'e şema dönüşümünüzün önemli dönüştürme ayrıntılarını ve içgörülerini yakalar ve işlem daha sonra uygulama kodu dönüştürmeyi geliştirmek için kullanır.

Kodlama Notları şunlar gibi bilgiler içerebilir:

• Veri türü eşlemeleri ve yapısal değişiklikler
• Diziler, kimlikler ve bileşik türler için dönüştürme ayrıntıları
• Tarih/saat veya aralık uygulamalarında yapılan ayarlamalar
• Bilgi tutarlılığı kısıtlamaları olan tablolara başvurular
• Yordam ve işlev imzaları dahil olmak üzere karmaşık Oracle paketlerinin özetleri
• Kod çevirisi doğruluğunu geliştirmek için yapay zeka tarafından oluşturulan ek ipuçları

Uygulama dönüştürme sırasında yapay zeka modeli, daha hassas ve görsel olarak hizalanmış PostgreSQL uyumlu kodlar üretmek için bağlamsal sinyaller olarak bu notları kullanır.

Uygulama dönüştürme işlemi

Bu bölümde tüm uygulama dönüştürme iş akışında yol gösterilir: ortamınızı ayarlama, kod tabanınızı içeri aktarma, dönüştürmeyi çalıştırma, oluşturulan raporu gözden geçirme ve dosya değişikliklerini karşılaştırma.

1. Adım: Ortamınızı ayarlama

• PostgreSQL uzantısı yüklü Visual Studio Code açın.
• GitHub Copilot sohbet arabirimini açın.
• Model için Claude Sonnet 4.6 veya Claude Opus 4.6'yi seçin.

En iyi uygulama dönüştürme sonuçları için Claude Sonnet 4.6 veya Claude Opus 4.6 kullanmak gerekir. Düşük modeller daha az doğru dönüştürmeler üretebilir.

2. Adım: Geçiş projenizi açma

• Şema dönüştürme projenizi içeren çalışma alanını açın.

• Geçiş projesi klasör yapısına gidin:

  .github/postgres-migration/project_name/
  

• Proje yapısının şema dönüştürme işleminden gerekli klasörleri ve dosyaları içerdiğini doğrulayın.

3. Adım: Kod tabanınızı geçiş projesine kopyalama

• application_code Projenizde klasörü bulun:

  .github/postgres-migration/project_name/application_code/
  

• Geçirmek istediğiniz application_code kod tabanı klasörünü proje klasörünüzün içindeki klasöre kopyalayın.

• Sistematik dönüştürmeyi kolaylaştırmak için dosyaları mantıksal olarak düzenleyin.

Özgün uygulama kodunuzu yedek olarak ayrı bir konumda tutun. Yalnızca geçiş projesi yapısına dönüştürmek istediğiniz dosyaları kopyalayın.

4. Adım: İstemci kodu geçişlerini başlatma

• PostgreSQL uzantısı Geçiş panelinde Uygulamayı Geçir'i seçerek uygulama dönüştürme sihirbazını başlatın.
• Yüklenen formda, çalışma alanınızın köküne kopyaladığınız klasörü seçin.
• Uygulamanızın bağlamını içeren veritabanını seçin:
  • Dönüştürülen DDL'nizi dağıttığınız PostgreSQL veritabanı veya
  • Uygulama şemanızın zaten mevcut olduğu PostgreSQL veritabanı
• Uygulamayı Dönüştür'ü seçin.

Bu eylem aşağıdaki işlemleri başlatır:

• Özel bileşik istemi ve Aracı Modu İşlevini çağırır
• Aracı Modu'nun üzerinde çalışmaya devam eden görevlerin TODO listesini oluşturur
• Gelişmiş bağlam için veritabanınıza bağlanır ve veritabanınızı okur
• Uygulama kodu dosyalarını sistematik olarak dönüştürür

5. Adım: Dönüştürme ilerleme durumunu izleme

• Dosyaları işlerken GitHub Copilot Aracı Modu arabirimini izleyin.
• Ajan, oluşturulan TODO listesini sistematik olarak kullanarak çalışır.
• Ajanstan gelen ve giriş gerektirebilecek tüm istemleri veya soruları gözden geçirin.
• Sonuçları gözden geçirmeden önce dönüştürme işleminin tamamen tamamlanmasına izin verin.

6. Adım: GitHub Copilot Uygulama Modernleştirme uzantısıyla geliştirilmiş Java dönüştürme (isteğe bağlı)

Java koduyla çalışıyorsanız: Dönüştürmeye başlamadan önce GitHub Copilot Uygulama Modernleştirme Uzantısı yükleyerek dönüştürme işleminizi geliştirebilirsiniz.

Otomatik test derlemesi

İki VS Code uzantısı, sorunsuz tümleştirme sağlamak için birbirleriyle iletişim kurar. Java kodu dönüştürürken Uygulama Modernleştirme Uzantısı, işlemin başlarındaki söz dizimi hatalarını veya derleme sorunlarını belirlemek için dönüştürülen kodunuzun test derlemesini otomatik olarak gerçekleştirir.

Otomatik birim testi oluşturma

Dönüştürülen kod tabanınıza bağlı olarak, Uygulama Modernleştirme Uzantısı dönüştürülen uygulamanızın doğru şekilde davrandığını doğrulamaya yardımcı olmak için otomatik olarak birim testleri oluşturur. Bu tümleştirme, Uygulama Modernleştirme Uzantısı'nın şu özelliklerden yararlanır:

• Dönüştürülmüş Java sınıflarınızı ve yöntemlerinizi analiz etme
• Kritik kod yolları için uygun test çalışmaları oluşturma
• PostgreSQL veritabanı bağlantılarınızla çalışan test fikstürleri oluşturma

GitHub Copilot Uygulama Modernleştirme Uzantısı'nın yüklenmesi, doğrulamayı önemli ölçüde hızlandırıp otomatik derleme denetimleri ve test oluşturma yoluyla dönüştürme kalitesini iyileştirdiğinden Java geçiş projeleri için önerilir.

7. Adım: Kod dönüştürme raporunu gözden geçirme

• Uygulama dönüştürme Aracı Modu'nda tamamlandığında, otomatik olarak kapsamlı bir rapor oluşturur ve açar.
• Rapor, dönüştürmeniz için ayrıntılı sonuçlar ve önerilen sonraki adımlar sağlar.

Kapsamlı rapor kılavuzu için: Dönüştürme sonuçlarınızı yorumlama, dosya durumlarını anlama ve doğrulama stratejinizi planlama hakkında ayrıntılı bilgi için Oracle to PostgreSQL için Azure Veri Tabanı application conversion generated reports (Preview) konusuna bakın.

8. Adım: Dosya fark özelliğini kullanarak kod değişikliklerini karşılaştırma

• Dönüştürülen bir dosyaya (örneğin, bir .java dosya) sağ tıklayın ve Uygulama Geçiş Dosyası Çiftlerini Karşılaştır'ı seçin.
• Bu, özgün ve dönüştürülen dosyaların yan yana görünümünü açar.
• Test etmeden önce kritik dönüşümleri doğrulamak için bunu kullanın.

Etkin dosya karşılaştırma stratejisi: Hangi dosyaları öncelikli olarak incelemeniz ve doğrulama çalışmalarınızı nasıl odaklamanız gerektiği konusunda rehberlik almak için Oracle'tan PostgreSQL için Azure Veri Tabanı uygulama dönüşümü ile oluşturulan raporları (Önizleme) bölümüne bakın.

9. Adım: Dönüştürülen uygulama kodunu doğrulama

Temel doğrulama adımları:

• Dönüştürülen PostgreSQL şemanızla üretim dışı bir test ortamı ayarlama
• Yeni PostgreSQL bağlantı dizeleriyle veritabanı bağlantısını test etme
• Uygulama davranışını doğrulamak için kritik iş iş akışlarını yürütme
• SQL sorgu sonuçlarını Oracle'dan beklenen sonuçlara karşı doğrulama
• Dönüştürme raporunda tanımlanan bayrak eklenmiş alanları adresle

Important

Yapay zeka sistemleri zaman zaman hata yapabilir. İşlevsel regresyonları, güvenlik sorunlarını veya veri erişimi sorunlarını önlemek için, üretime dağıtmadan önce dönüştürülen tüm uygulama kodunu bağımsız olarak doğrulayın.

Sistem doğrulama yaklaşımı: Oracle tümleştirme karmaşıklığı ve dönüştürme raporu sonuçlarınıza göre testlere öncelik vermek için Oracle uygulama kodunu PostgreSQL için Azure Veri Tabanı (Önizleme) dönüştürmeye yönelik Best uygulamalarında doğrulama çerçevelerini kullanın.

Dönüştürme sonrası adımları

Uygulama dönüştürmeyi tamamladıktan sonra:

• Birim testleri çalıştırma: Dönüştürülen koda karşı uygulamanızın test paketini yürütün.
• Tümleştirme testi: Uygulamayı PostgreSQL veritabanınızla test edin.
• Performans testi: Sorgu performansının gereksinimleri karşıladığını doğrulayın.
• Kod incelemesi: Ekip üyelerinin dönüştürülen kodu doğruluk açısından gözden geçirmesini sağlayın.
• Belge güncelleştirmesi: Oracle'a özgü özelliklere başvuran tüm belgeleri güncelleştirin.

Kapsamlı doğrulama stratejileri: Ayrıntılı doğrulama çerçeveleri, test öncelikleri ve dönüştürme karmaşıklığınıza dayalı ekip koordinasyon yaklaşımları için Oracle uygulama kodunu PostgreSQL için Azure Veri Tabanı (Önizleme)'e dönüştürmek için En iyi uygulamalarına bakın.

Visual Studio Code uzantısı hakkında daha fazla bilgi için Visual Studio Code için PostgreSQL uzantısı adresini ziyaret edin

İlgili içerik

• Oracle'dan Azure için PostgreSQL Veritabanına uygulama dönüştürmesi (Önizleme) nedir?
• Oracle'dan Azure PostgreSQL Veritabanına uygulama dönüştürme tarafından oluşturulan raporlar (Önizleme)
• Oracle uygulama kodunu PostgreSQL için Azure Veri Tabanı (Önizleme)'ye dönüştürmek için en iyi uygulamalar
• Oracle'dan PostgreSQL için Azure Veri Tabanı'a uygulama dönüştürme sınırlamaları (Önizleme)