Oracle'ı PostgreSQL'e geçirme

Visual Studio Code için PostgreSQL uzantısı, Oracle veritabanlarını PostgreSQL'e geçirmek için uçtan uca bir iş akışı sağlar. Yönlendirmeli bir sihirbaz, Oracle kaynağınıza bağlanma, şemaları seçme, yapay zeka destekli DDL dönüştürmesi için bir Microsoft Foundry modelini yapılandırma ve doğrulama için bir PostgreSQL çalışma veritabanı seçme adımlarında size rehberlik eder. Proje oluşturulduktan sonra, bir pano ayıklamayı, dönüştürmeyi, dışarı aktarmayı ve gözden geçirmeyi tek bir görünümde izler.

Important

Oracle’dan PostgreSQL’e geçiş iş akışı yalnızca Visual Studio Code’da kullanılabilir.

Prerequisites

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • Visual Studio Code yüklendi.
  • PostgreSQL uzantısı yüklü.
  • Şema ayıklama için okuma izinlerine sahip bir Oracle kaynak veritabanına erişim.
  • Geçici doğrulama veritabanı olarak kullanılacak bir PostgreSQL örneği (örneğin, PostgreSQL için Azure Veri Tabanı için Esnek Sunucu).
  • Dağıtıma alınmış bir gpt-5.2 modele sahip Microsoft Foundry kaynağı. Uç nokta URL'sine ve erişimi olan bir API anahtarına veya Microsoft Entra ID hesabına ihtiyacınız vardır.

Geçişler özelliğinin etkinleştirildiğini doğrulayın

Ayar, pgsql.enableMigrationsGeçişler (Önizleme) görünümünü ve tüm geçiş komutlarını denetler. Bu ayar varsayılan olarak etkindir.

Geçişler (Önizleme) görünümü kenar çubuğunda görünmüyorsa ayarı doğrulayın:

  1. VS Code ayarlarını açın (Ctrl+, Windows/Linux, Cmd+, macOS üzerinde).
  2. pgsql.enableMigrations için arama yapın.
  3. Değerin true olduğunu onaylayın.

Geçiş projesi oluşturma

Geçiş projesi, proje çalışma alanını oluşturmadan önce kaynak, hedef ve yapay zeka yapılandırmanızı toplayan dört adımlı bir sihirbazdır.

1. Adım: Proje kurulumu

  1. Kenar çubuğunda Geçişler (Önizleme) görünümünü açın.

  2. Görünüm araç çubuğundaki düğmeyi + seçin veya Gezgin'de bir çalışma alanı klasörüne sağ tıklayıp Geçiş Project Oluştur'u seçin.

    Yeni Oracle'dan PostgreSQL için Azure Veri Tabanı'e geçiş projesi sayfası açılır ve ihtiyacınız olanlar listelenir:

    • Kaynak veritabanı için bağlantı ayrıntıları
    • Dönüştürülecek şemaların adı
    • Microsoft Dökümhane kaynağı için uç nokta URL'si ve anahtarı
    • Mevcut bir PostgreSQL örneğinin bağlantı adı

  3. Project Adı alanına bir ad girin.

  4. İleri: Oracle Bağlantısı'nı seçin.

Project Adı alanına sahip yeni geçiş project sayfasının ekran görüntüsü.

2. Adım: Oracle'a bağlanma

Oracle'a Bağlan sayfası Oracle kaynak veritabanı kimlik bilgilerinizi toplar ve şemaları yüklemenize olanak tanır.

  1. Oracle bağlantı alanlarını tamamlayın:

    Alan Açıklama
    Oracle Hostname Oracle veritabanı sunucusunun ana bilgisayar adı veya IP adresi.
    Oracle Bağlantı Noktası Dinleyici bağlantı noktası (varsayılan: 1521).
    Oracle SID veya Hizmet Adı Veritabanı örneği için Oracle SID veya hizmet adı.
    Oracle Kullanıcı Adı Şema nesnelerine okuma erişimi olan veritabanı kullanıcısı.
    Oracle Parolası Oracle kullanıcısının parolası.

  2. Bağlanmak ve kullanılabilir şemaların listesini almak için Şemaları Yükle'yi seçin.

  3. Şemalar açılır listesinde, taşımak için bir veya daha fazla şema seçin.

  4. İleri: PostgreSQL Bağlantısı'nı seçin.

3. Adım: PostgreSQL için Azure Veri Tabanı için bir geçici veritabanı seçin

PostgreSQL için Azure Database taslak veritabanı seçin sayfası, yapay zeka modelinin dönüştürülen DDL dosyalarını doğrulamak için kullandığı PostgreSQL örneğini seçer.

Uyarı

Doğrulama için özel bir geçici veritabanı kullanın. Uzantı, dönüştürme işlemi sırasında dönüştürülmüş DDL'yi bu veritabanına karşı yürütebilir.

  1. PostgreSQL Bağlantısı açılan listesinde mevcut bir bağlantı profilini seçin. İhtiyacınız olan bağlantı listede yoksa, kullanılabilir profilleri yeniden yüklemek için Profilleri Yenile'yi seçin veya önce Bağlantılar ve kimlik görünümünde yeni bir bağlantı oluşturun.
  2. PostgreSQL Veritabanı açılan listesinde hedef veritabanını seçin. Liste boşsa Veritabanlarını Yükle'yi seçin.
  3. Bir veritabanı seçtikten sonra, uzantı önerilen PostgreSQL uzantılarının yüklendiğini otomatik olarak doğrular. Denetimi el ile çalıştırmak için Uzantıları Doğrula'yı da seçebilirsiniz. Eksik uzantılar varsa, sayfa bunları listeler ve esnek PostgreSQL için Azure Veri Tabanı sunucu belgeleri aracılığıyla izin verilenler listesine ekleme ve yükleme konusunda rehberlik sağlar.
  4. sonraki: Microsoft Döküm Modeli Yapılandırması'nı seçin.

4. Adım: Microsoft Dökümhane modelini yapılandırma

Microsoft Döküm Modeli Seçin sayfası, şema ve kod dönüştürmeyi destekleyen Microsoft Dökümhane dağıtımını yapılandırıyor.

  1. Dil modeli alanlarını tamamlayın:

    Alan Açıklama
    Model Adı gpt-5.2.
    Microsoft Foundry Uç Noktası Microsoft Döküm kaynak uç noktası URL'si (örneğin, https://<resource>.openai.azure.com/).
    Kimlik Doğrulama Yöntemi API Anahtarı veya Microsoft Entra Kimliği'ni seçin.
    Microsoft Foundry API Anahtarı Microsoft Döküm kaynağı için API anahtarı (Kimlik Doğrulama YöntemiAPI Anahtarı olduğunda gösterilir).
    Azure Hesabı Kaynağa erişimi olan Microsoft hesabı (Kimlik Doğrulama YöntemiMicrosoft Entra Id olduğunda gösterilir).
    Kiracı Hesap için Azure AD kiracısı (Kimlik Doğrulama YöntemiMicrosoft Entra Id olduğunda gösterilir).
    Dağıtım Adı Microsoft Foundry kaynağınızda dağıtılan modelin adı.

  2. Bağlantıyı doğrulamak için Microsoft Foundry Bağlantısını Test Et seçin.

  3. Geçiş Projesi Oluştur seçeneğini belirleyin.

Tip

Microsoft Foundry, en iyi geçiş performansı için 500.000 TPM (Dakika Başına Belirteç) önerir.

Şema geçişlerini çalıştırma

Proje oluşturulduktan sonra Oracle Migration panosu açılır. Panoda Şema Geçişi ve Şema Gözden Geçirme kartlarının yanı sıra proje yapılandırmanızı özetleyen bir Ayarlar akordeonu görüntülenir.

Şemaları ayıklama ve dönüştürme

Şema Geçişi kartı (1. Adım), ayıklama, dönüştürme ve dışa aktarma işlemlerini tek bir kesintisiz işlem hattı olarak çalıştırır.

  1. Şema Geçişi kartında Geçir'i seçin.

    İşlem hattı ilerledikçe düğme etiketi güncelleştirilir:

    Statü Düğme etiketi
    Çıkarma sürüyor Ayıklanıyor ...
    Çıkarma tamamlandı, dönüştürme beklemede Geçişi Sürdür
    Dönüştürme sürüyor Dönüştürülüyor ...
    Tüm aşamalar tamamlandı Geçiş Tamamlandı

  2. Genişletilmiş karttaki ilerleme durumunu izleyin:

    • Ayıklama , ayıklanan nesnelerin sayısını (örneğin, "ayıklanan 42 nesnenin 15'i") ve işlenen geçerli şemayı ve nesneyi gösterir.
    • Dönüştürme, dönüştürülen öbeklerin sayısını (örneğin, "8 öbeğin 3'ü dönüştürüldü") ve o anda işlenen öbeği gösterir.

  3. Dışarı aktarma tamamlandıktan sonra, oluşturulan geçiş raporunu açmak için Geçiş Raporunu Görüntüle'yi seçin.

Geçiş görevlerini gözden geçirme

Şema Gözden Geçirme kartı (2. Adım) dönüştürme işleminden sonra el ile dikkat gerektiren öğeleri görüntüler. Gözden geçirme alanının en üstündeki Gruplandırılmış / Görevler değiştiricisi, listede nasıl çalışabileceğinizi seçmenize olanak tanır.

Gruplandırılmış görünüm

Gruplandırılmış görünüm, gözden geçirme görevlerini kategoriye göre daraltılabilir akordeon grupları halinde düzenler. İlgili sorunları birlikte işlemek istediğinizde bu görünümü kullanın.

  1. Şema Gözden Geçirme kartında Gözden Geçir'i seçerek gözden geçirme yüzeyini genişletin ve ardından Gruplandırılmış'ı seçin.

  2. Hala dikkat etmeniz gereken görevlerle zaten onayladığınız görevler arasında geçiş yapmak için Beklemede ve Çözümlendi sekmelerini kullanın.

  3. Meta verilerini (şemalar, nesne türleri, kritiklik) ve içindeki tek tek görev kartlarını görmek için grubu genişletin.

  4. Görevleri toplu olarak işlemek için grup düzeyindeki eylemleri kullanın:

    Eylem Açıklama
    Tümünü çalıştır Yapay zeka destekli gözden geçirme için gruptaki bekleyen tüm görevleri Copilot Aracı Modu'nda açın.
    Tümünü çözümle Gruptaki tüm görevleri çözümlendi olarak işaretleyin. Devam etmeden önce grup adını ve görev sayısını gösteren bir onay iletişim kutusu.
    Tümünü sıfırla Gruptaki tüm çözümlenen görevleri bekleyen duruma döndürebilirsiniz. Çözümlendi sekmesinde kullanılabilir.
    Görevler'de Görüntüle Bu gruba filtrelenmiş düz Görevler görünümüne geçin.

  5. Grubun içindeki tek bir görev üzerinde işlem yapmak için Görevi Çalıştır'ı seçerek Copilot Aracı Modu'nda açın veya tamamlandı olarak işaretlemek için Çözümle'yi seçin. Çözümlenen bir görevde Sıfırla'yı seçerek bekleyen duruma döndürebilirsiniz.

Uyarı

Bir grup 800'den fazla görev içerdiğinde tümünü çözümle ve Tümünü sıfırla devre dışı bırakılır.

Görevler görünümü

Görevler görünümü, düz bir tablodaki tüm gözden geçirme görevlerini gösterir. Gruptan bağımsız olarak tüm görevler arasında sıralamak, filtrelemek veya arama yapmak istediğinizde bu görünümü kullanın.

  1. Değiştiricide Görevler'i seçin.
  2. Görev listesini daraltmak için filtre açılan listelerini (Durum, Kritiklik, Nesne Türü, Şema) kullanın.
  3. Bekleyen bir öğede Görevi Çalıştır'ı seçerek yapay zeka destekli gözden geçirme ve düzeltme için Copilot Aracı Modu'nda açın.
  4. Bir öğeyi düzelttikkten sonra, tamamlandı olarak işaretlemek için Çözümle'yi seçin.

Tip

Ayıklama ve dönüştürme günlük dosyalarını sorun giderme amacıyla incelemek için panoda Günlükleri Görüntüle'yi seçin.

Uygulama kodunu geçirme

Şema geçişi sonrasında Oracle'a özgü uygulama kodunu (SQL betikleri, saklı yordamlar, yükleyici denetim dosyaları, kabuk betikleri veya Java dosyaları) PostgreSQL uyumlu eşdeğerlere dönüştürün. Uygulama geçişi bir Önizleme özelliğidir.

Geçiş yöntemi seçme

Uzantı, uygulama kodu geçişi için iki yol sunar:

  • Tam uygulama modernleştirmesi — GitHub Copilot uygulaması modernleştirme uzantısı yüklüyse, şema dönüştürmesinden kodlama notlarıyla geçişe devam etmek için Uygulama modernleştirmesini kullanarak geçir'i seçin. Devam etmeden önce oluşturulan kılavuzu gözden geçirmek için Kodlama notlarını görüntüle'yi seçin.
  • Yalnızca veritabanı seçeneği — Bu uzantı içindeki yalnızca veritabanıyla ilgili uygulama kodlarını geçirmek için PostgreSQL uzantısını kullanarak geçir seçeneğini belirleyin.

Uzantı içindeki uygulama kodunu dönüştürme

  1. Uygulama Geçişi kartında Verileri Geçir'i (veya uygulama modernleştirme uzantısı algılanırsa Yöntem'i seçin) seçin.
  2. Uygulamayı Dönüştür sayfasında Dönüştürülecek Oracle Uygulamasını Seç'i seçin ve Oracle uygulama kodunu içeren klasörü seçin.
  3. Dönüştürme bağlamı için bir PostgreSQL Bağlantısı ve PostgreSQL Veritabanı seçin.
  4. Veritabanı listesi boşsa Veritabanlarını Yükle'yi seçin.
  5. Dönüştürmeyi başlatmak için Uygulamayı Dönüştür'ü seçin.

Uygulama geçişi için Copilot araçlarını kullanma

Uzantı, geçiş yardımı için iki Copilot dil modeli aracı kaydeder:

  • Oracle İstemci Kodu Uygulama Dönüştürücüsü (pgsql_migration_oracle_app) — Şema geçiş analizinden istem şablonlarını ve kodlama kılavuzlarını kullanarak Oracle istemci uygulama kodunu PostgreSQL eşdeğerlerine dönüştürür. Aşağıdaki parametreleri kabul eder:

    • Application Codebase Klasörü (gerekli) — Dönüştürülecek kodun konumu.
    • Kodlama Notları Konum Yolu (isteğe bağlı) — Şema geçişinden not kodlama yolu.
    • Postgres DB Adı (isteğe bağlı) — Dönüştürme bağlamı için PostgreSQL veritabanının adı.
    • Postgres DB Bağlantısı (isteğe bağlı) — PostgreSQL veritabanı için bağlantı adı.

  • Oracle to Postgres Geçiş Raporunu Göster (pgsql_migration_show_report) — Şema dönüştürmesi tarafından oluşturulan geçiş raporunu görüntüler. Rapor Dosyasının Yolu parametresini gerektirir.

Copilot araçlarını kullanma hakkında daha fazla bilgi için bkz. Copilot tümleştirme.

Dönüştürülen dosyaları karşılaştırma

Dönüştürme işleminden sonra yerleşik fark komutlarını kullanarak değişiklikleri yan yana gözden geçirin.

  1. Gezgin'de, geçiş projesindeki oracle veya postgres klasörü altında dönüştürülmüş bir SQL dosyasına sağ tıklayın ve DDL Geçiş Dosyası Çiftlerini Karşılaştır seçeneğini belirleyin.
  2. Dönüştürülen uygulama kodu dosyaları (.sql, .ctl, .sh, .loadveya .java) için dosyaya sağ tıklayın ve Uygulama Geçiş Dosyası Çiftlerini Karşılaştır'ı seçin.

Yan yana fark görünümü, dönüştürülen PostgreSQL çıkışının yanında özgün Oracle kaynağını gösterir, böylece el ile ayarlama gerektiren yapıtları tanımlayabilirsiniz.

Uyarı

DDL dosyalarının eşleşen dosya çiftini bulmak için karşılaştır komutunun yapısına folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql uyması gerekir.

Geçiş projelerini yönetme

Projelerinizi yönetmek için kenar çubuğundaki Geçişler (Önizleme) görünümünü kullanın:

Eylem Açıklama
Açık Geçiş Projesi Panoda var olan bir geçiş projesini açın.
Dosya Gezgini'nde göster Gezgin görünümünde proje klasörünü gösterin.
Delete Geçiş projesini kaldırma. Silme işleminden önce onaylamanız istenir.
Yenileme Geçerli çalışma alanında geçiş projelerinin listesini yeniden yükleyin.

İlgili içerik

  • Last updated on