ترحيل Oracle إلى PostgreSQL

يوفر امتداد PostgreSQL ل تعليمة Visual Studio برمجية سير عمل شامل من البداية إلى النهاية لنقل قواعد بيانات Oracle إلى PostgreSQL. يوجهك الساحر الموجه خلال الاتصال بمصدر Oracle الخاص بك، واختيار المخططات، وتكوين نموذج Microsoft Foundry لتحويل DDL بمساعدة الذكاء الاصطناعي، واختيار قاعدة بيانات PostgreSQL للتحقق من الصحة. بعد إنشاء المشروع، يتتبع لوحة التحكم عمليات الاستخلاص والتحويل والتصدير والمراجعة في عرض واحد.

مهم

يتوفر سير عمل ترحيل Oracle إلى PostgreSQL فقط بنظام تعليمة Visual Studio برمجية.

كيفية احتواء المخطط وتحويل التطبيق معا

يحول الملحق حمل عمل Oracle في تمريرتين. يتم تشغيل تحويل المخطط أولا وينتج لغة تعريف بيانات PostgreSQL (DDL) لكائنات قاعدة البيانات. يتم تشغيل تحويل التطبيق بعد ذلك ويحدث التعليمات البرمجية التي تستدعي هذه الكائنات.

تحويل المخطط

يقرأ تحويل المخطط قاموس بيانات Oracle للمخططات التي تحددها، ويدمج الكائنات المستخرجة في مجموعات مرتبة بالتبعية، ويحول كل مجموعة باستخدام نشر Microsoft Foundry. يتم تجميع الكائنات المحولة مقابل قاعدة بيانات الصفر قبل كتابتها، لذلك يتم التحقق من DDL الذي تتلقاه بدلا من أفضل تخمين. ينتج عن التشغيل ما يلي:

  • ملفات PostgreSQL .sql على مستوى الكائن، منظمة حسب مخطط Oracle ونوع العنصر.
  • تقرير تحويل يسجل الكائنات التي تم تحويلها، والتي تم تخطيها، ومعدل النجاح الكلي.
  • راجع المهام للعناصر التي تحتاج إلى حكم بشري، مثل DDL الاحتياطي أو السلوك الذي يختلف بين Oracle وPostgreSQL.
  • ملاحظات الترميز التي تصف أنماط Oracle الموجودة في المخطط وكيفية تعيينها إلى PostgreSQL.

تحويل التطبيقات

يستهدف تحويل التطبيق التعليمات البرمجية الخاصة ب Oracle التي تحيط بقاعدة البيانات: البرامج النصية SQL واستدعاءات الإجراء المخزنة وملفات التحكم في التحميل والبرامج النصية shell وملفات Java. يأخذ ملاحظات الترميز من تحويل المخطط كإدخل، لذلك تصطف التعليمات البرمجية للتطبيق المحول مع أسماء الكائنات والأنواع واصطلاحات الاستدعاء التي تم إنتاجها بالفعل لتحويل المخطط.

يمكنك تحويل التعليمات البرمجية للتطبيق المتعلق بقاعدة البيانات داخل هذا الملحق، أو تسليم العمل إلى ملحق تحديث GitHub تطبيق Copilot لتمرير التحديث الكامل.

تسلسل التمريرين

قم بتشغيل تحويل المخطط أولا. يعتمد تحويل التطبيق على ملاحظات الترميز وأسماء الكائنات المحولة التي ينشئها تحويل المخطط، لذا فإن تحويل التعليمات البرمجية للتطبيق قبل أن يستقر المخطط ينتج تعليمة برمجية تستهدف الكائنات التي قد لا تزال تتغير. إذا قمت بإعادة تشغيل تحويل المخطط بعد تغيير نطاق المخطط أو إصلاح كائن مصدر، فراجع التعليمات البرمجية للتطبيق مرة أخرى مقابل ملاحظات الترميز المحدثة.

المتطلبات الأساسية

قبل أن تبدأ، تأكد من أنك تملك:

  • تعليمة Visual Studio برمجية مثبت.
  • تم تثبيت إضافة PostgreSQL.
  • الوصول إلى قاعدة بيانات مصدر أوراكل مع أذونات قراءة لاستخراج المخطط.
  • خادم مرن قاعدة بيانات Azure لـ PostgreSQL لاستخدامه كقاعدة بيانات للتحقق من صحة الصفر. لا يدعم تحويل المخطط Azure HorizonDB كقاعدة بيانات الصفر.
  • مورد من Microsoft Foundry مع نموذج منشورgpt-5.2. تحتاج إلى رابط نقطة النهاية وإما مفتاح API أو حساب Microsoft Entra ID مع إمكانية الوصول.

تحقق من تفعيل ميزة الترحيل

pgsql.enableMigrations يتحكم الإعداد في طريقة عرض عمليات الترحيل وجميع أوامر الترحيل. يتم تمكين هذا الإعداد افتراضيًا.

إذا لم تظهر طريقة العرض عمليات الترحيل في الشريط الجانبي، فافتح إعدادات تعليمة Visual Studio برمجية (Ctrl+، على Windows/Linux، Cmd+، على macOS) وتحقق من تعيين pgsql.enableMigrations إلى true.

قم بإنشاء مشروع ترحيل.

مشروع الترحيل هو ساحر من أربع خطوات يجمع إعدادات المصدر والهدف والذكاء الاصطناعي قبل إنشاء مساحة عمل المشروع.

الخطوة 1: إعداد Project

  1. افتح طريقة عرض عمليات الترحيل في الشريط الجانبي.

  2. ابدأ مشروعا جديدا بإحدى الطرق التالية:

    • إذا لم تحتوي مساحة العمل على project ترحيل بعد، فحدد + Create Migration Project في طريقة العرض.
    • + حدد الزر في شريط أدوات العرض.
    • انقر بزر الماوس الأيمن فوق مجلد مساحة عمل في Explorer وحدد Open Migration Project.

    صفحة مشروع الترحيل الجديدة من Oracle إلى قاعدة بيانات Azure لـ PostgreSQL تفتح، وتدرج ما تحتاجه:

    • تفاصيل الاتصال لقاعدة البيانات المصدرية
    • أسماء المخططات المراد تحويلها
    • رابط نقطة النهاية ومفتاح مورد Microsoft Foundry
    • اسم الاتصال لمثيل قاعدة بيانات Azure لـ PostgreSQL موجود

  3. أدخل اسما في حقل Project Name.

  4. اختر التالي: اتصال أوراكل.

لقطة شاشة لصفحة project ترحيل جديدة مع حقل Project Name.

الخطوة 2: الاتصال ب Oracle

صفحة Connect to Oracle تجمع بيانات اعتماد قاعدة بيانات Oracle المصدرية وتتيح لك تحميل المخططات.

  1. أكمل حقول اتصال أوراكل:

    الميدان الوصف
    اسم المضيف أوراكل اسم المضيف أو عنوان IP لخادم قاعدة بيانات أوراكل.
    منفذ أوراكل منفذ المستمع (الافتراضي: 1521).
    اسم أوراكل SID أو الخدمة اسم OPRIC أو الخدمة الخاصة بمثيل قاعدة البيانات.
    اسم المستخدم أوراكل مستخدم قاعدة البيانات لديه وصول للقراءة إلى كائنات المخطط.
    كلمة مرور أوراكل كلمة المرور لمستخدم أوراكل.

  2. اختر تحميل المخططات للاتصال واسترجاع قائمة المخططات المتاحة.

  3. في قائمة المخططات المنسدلة، اختر مخططا واحدا أو أكثر للترحيل.

  4. اختر التالي: اتصال PostgreSQL.

الخطوة 3: اختر قاعدة بيانات Azure Database ل PostgreSQL scratch database

صفحة قاعدة البيانات العشوائية "اختر قاعدة بيانات Azure ل Azure ل PostgreSQL" تختار نسخة PostgreSQL التي يستخدمها نموذج الذكاء الاصطناعي للتحقق من صحة ملفات DDL المحولة.

ملحوظة

استخدم قاعدة بيانات مخصصة للخدش للتحقق. قد يقوم الامتداد بتنفيذ DDL المحولة ضد هذه قاعدة البيانات أثناء عملية التحويل.

  1. في قائمة المنسدلة PostgreSQL Connection ، اختر ملف تعريف اتصال موجود. إذا لم يكن الاتصال الذي تحتاجه مدرجا، اختر تحديث الملفات الشخصية لإعادة تحميل الملفات المتاحة، أو أنشئ اتصالا جديدا في عرض الاتصالات والهوية أولا.
  2. في قائمة قاعدة بيانات PostgreSQL المنسدلة، اختر قاعدة البيانات المستهدفة. اختر تحميل قواعد البيانات إذا كانت القائمة فارغة.
  3. بعد تحديد قاعدة بيانات، يتحقق الملحق تلقائيا من تثبيت ملحقات PostgreSQL الموصى بها. يمكنك أيضا اختيار التحقق من الإضافات لتشغيل الفحص يدويا. إذا كانت هناك أي ملحقات مفقودة، تسردها الصفحة مع إرشادات حول السماح بها وتثبيتها.
  4. اختر التالي: تكوين نموذج Microsoft Foundry.

الخطوة 4: تكوين نموذج Microsoft Foundry

صفحة Choose a Microsoft Foundry Model تحدد نشر Microsoft Foundry الذي يدعم تحويل المخطط والشيفرة.

  1. أكمل حقول نموذج اللغة:

    الميدان الوصف
    اسم النموذج gpt-5.2.
    نقطة نهاية Microsoft Foundry رابط نقطة نهاية موارد Microsoft Foundry (على سبيل المثال، https://<resource>.openai.azure.com/).
    أسلوب المصادقة اختر مفتاح API أو معرف Microsoft Entra.
    مفتاح واجهة برمجة التطبيقات Microsoft Foundry مفتاح API لمورد Microsoft Foundry (يظهر عندما تكون طريقة المصادقةهي مفتاح API).
    حساب Azure حساب Microsoft مع إمكانية الوصول إلى المورد (يظهر عندما تكون طريقة التحقق من Microsoft Entra Id).
    مستأجر Microsoft Entra المستأجر للحساب (يظهر عندما يكون أسلوب المصادقةهو معرف Microsoft Entra).
    اسم النشر اسم النموذج المنشور في مورد Microsoft Foundry الخاص بك.

  2. اختر اختبار اتصال Microsoft Foundry للتحقق من الاتصال.

  3. اختر Create Migration Project.

نصيحة

توصي Microsoft Foundry ب 500,000 TPM (رمز في الدقيقة) لتحقيق أداء ترحيل مثالي.

تشغيل ترحيل المخطط

بعد إنشاء المشروع، يفتح جهاز تحكم Oracle Migration . تعرض لوحة التحكم بطاقات ترحيل المخططومراجعة المخطط ، بالإضافة إلى أكورديون الإعدادات الذي يلخص تكوين مشروعك.

استخراج وتحويل المخططات

بطاقة ترحيل المخطط (الخطوة 1) تشغل عمليات الاستخراج والتحويل والتصدير كخط أنابيب مستمر.

  1. في بطاقة ترحيل المخطط ، اختر الترحيل.

    يتم تحديث تسمية الزر مع تقدم خط الأنابيب:

    Status تسمية الزر
    جاري الاستخراج استخراج ...
    اكتمل الاستخراج، والتحويل قيد الانتظار ترشيح السيرة الذاتية
    تشغيل التحويل تحويل ...
    جميع المراحل مكتملة الهجرة اكتملت

  2. راقب التقدم في البطاقة الموسعة:

    • يظهر الاستخلاص عدد الكائنات المستخرجة (على سبيل المثال، "15 من أصل 42 كائنا تم استخراجها") والمخطط الحالي والكائن الذي يتم معالجته.
    • يظهر التحويل عدد الأجزاء المحولة (على سبيل المثال، "3 من 8 أجزاء محولة") والقطعة الحالية التي تتم معالجتها.

  3. بعد اكتمال التصدير، اختر عرض تقرير الترحيل لفتح تقرير الترحيل المولد.

مراجعة مهام الترحيل

تعرض بطاقة مراجعة المخطط (الخطوة 2) العناصر التي تتطلب اهتماما يدويا بعد التحويل. مبدلالمهام / في أعلى منطقة المراجعة يتيح لك اختيار كيفية المرور على القائمة.

العرض المجمع

ينظم العرض المجمع مهام المراجعة إلى مجموعات أكورديون قابلة للطي حسب الفئة. استخدم هذا المنظور عندما ترغب في معالجة القضايا ذات الصلة معا.

  1. على بطاقة مراجعة المخطط ، اختر المراجعة لتوسيع سطح المراجعة، ثم اختر المجموعة (Grouped).

  2. استخدم علامات التبويب المعلقةوالمحلولة للتبديل بين المهام التي لا تزال تحتاج إلى اهتمام والمهام التي وافقت عليها بالفعل.

  3. قم بتوسيع المجموعة لرؤية بياناتها الوصفية (المخططات، أنواع الكائنات، الحرجية) وبطاقات المهام الفردية بداخلها.

  4. استخدم الإجراءات على مستوى المجموعة لمعالجة المهام بكميات كبيرة:

    الإجراء الوصف
    شغل كل افتح كل مهمة معلقة في المجموعة في وضع Copilot Agent للمراجعة بمساعدة الذكاء الاصطناعي.
    حل الجميع قم بوضع علامة على جميع المهام في المجموعة على أنها محلولة. يظهر مربع التأكيد اسم المجموعة وعدد المهام قبل المتابعة.
    إعادة ضبط الجميع أعد جميع المهام المحلولة في المجموعة إلى الحالة المعلقة. متوفر في تبويب الحلول .
    عرض في المهام انتقل إلى عرض المهام المسطح المصفاة في هذه المجموعة.

  5. للعمل على مهمة واحدة داخل المجموعة، اختر تشغيل المهمة لفتحها في وضع Copilot Agent، أو اختر Resolve لوضع إتمامها. اختر إعادة تعيين مهمة محلولة لإعادتها إلى الحالة المعلقة.

ملحوظة

يتم تعطيل حل كلوإعادة تعيين الجميع عندما تحتوي المجموعة على أكثر من 800 مهمة.

طريقة عرض المهام

عرض المهام يعرض جميع مهام المراجعة في جدول مسطح. استخدم هذا العرض عندما ترغب في فرز أو تصفية أو البحث عبر جميع المهام بغض النظر عن المجموعة.

  1. اختر المهام في جهاز التبديل.
  2. استخدم قوائم المرشح المنسدلة (الحالة، الحرجية، نوع الكائن، المخطط) لتضييق قائمة المهام.
  3. اختر تشغيل المهمة على عنصر معلق لفتحه في وضع Copilot Agent للمراجعة والتصحيح بمساعدة الذكاء الاصطناعي.
  4. بعد إصلاح عنصر، اختر Resolve لوضع علامة اكتماله.

نصيحة

اختر عرض السجلات في لوحة التحكم لفحص ملفات سجل الاستخراج والتحويل لحل المشكلة.

ترحيل كود التطبيق

بعد ترحيل المخطط، قم بتحويل كود التطبيقات الخاص بأوراكل (سكريبتات SQL، الإجراءات المخزنة، ملفات التحكم في المحمل، سكريبتات الشيل، أو ملفات Java) إلى ما يعادلها المتوافق مع PostgreSQL. ترحيل التطبيق هو ميزة معاينة.

اختيار أسلوب ترحيل

تقدم الإضافة مسارين لترحيل كود التطبيقات:

  • تحديث التطبيق الكامل: إذا قمت بتثبيت ملحق تحديث GitHub تطبيق Copilot، فحدد Migrate using app modernization لمتابعة الترحيل مع ملاحظات الترميز من تحويل المخطط. اختر عرض ملاحظات الترميز لمراجعة الإرشادات المولدة قبل المتابعة.
  • خيار قاعدة البيانات فقط: لتحويل التعليمات البرمجية للتطبيق المتعلق بقاعدة البيانات فقط ضمن هذا الملحق، حدد ترحيل باستخدام ملحق PostgreSQL.

تحويل كود التطبيق داخل الامتداد

  1. على بطاقة ترحيل التطبيق ، اختر ترحيل البيانات (أو اختر الطريقة إذا تم اكتشاف امتداد تحديث التطبيق).
  2. في صفحة تحويل التطبيق ، اختر اختيار تطبيق أوراكل للتحويل واختر المجلد الذي يحتوي على كود تطبيق أوراكل.
  3. اختر اتصال PostgreSQLوقاعدة بيانات PostgreSQL لسياق التحويل.
  4. اختر تحميل قواعد البيانات إذا كانت قائمة قواعد البيانات فارغة.
  5. اختر تحويل التطبيق لبدء التحويل.

استخدم أدوات Copilot لترحيل التطبيقات

يسجل الامتداد أداتين لنموذج لغة Copilot للمساعدة في الهجرة:

  • Oracle Client Code Application Converter (pgsql_migration_oracle_app): تحويل التعليمات البرمجية لتطبيق عميل Oracle إلى مكافئات PostgreSQL باستخدام قوالب المطالبة وإرشادات الترميز من تحليل ترحيل المخطط. يقبل المعايير التالية:

    • مجلد قاعدة التعليمات البرمجية للتطبيق (مطلوب): موقع التعليمات البرمجية المراد تحويلها.
    • مسار موقع ملاحظات الترميز (اختياري): مسار ترميز الملاحظات من ترحيل المخطط.
    • Postgres DB Name (اختياري): اسم قاعدة بيانات PostgreSQL لسياق التحويل.
    • اتصال Postgres DB (اختياري): اسم الاتصال لقاعدة بيانات PostgreSQL.

  • إظهار Oracle إلى تقرير ترحيل Postgres (pgsql_migration_show_report): يعرض تقرير الترحيل الذي تم إنشاؤه بواسطة تحويل المخطط. يتطلب معلمة مسار للإبلاغ عن الملف .

لمزيد من المعلومات حول استخدام أدوات Copilot، راجع دمج Copilot.

مقارنة الملفات المحولة

بعد التحويل، يتم مراجعة التغييرات جنبا إلى جنب باستخدام أوامر الفرق المدمجة.

  1. في المستكشف، انقر بزر الفأرة الأيمن على ملف SQL محوله تحت مجلد oracle or postgres في مشروع الترحيل واختر مقارنة أزواج ملفات ترحيل DDL.
  2. لملفات كود التطبيقات المحولة (.sql, .ctl, .sh, .load, أو .java)، انقر بزر الفأرة الأيمن على الملف واختر مقارنة أزواج ملفات ترحيل التطبيق.

عرض التفاضلات جنبا إلى جنب يظهر المصدر الأصلي لأوراكل إلى جانب مخرج PostgreSQL المحول، بحيث يمكنك تحديد أي تشوهات تحتاج إلى تعديل يدوي.

ملحوظة

يجب أن تتبع ملفات DDL هيكل folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql أمر المقارنة لتحديد موقع زوج الملف المطابق.

إدارة مشاريع الهجرة

استخدم طريقة العرض عمليات الترحيل في الشريط الجانبي لإدارة مشاريعك:

الإجراء الوصف
مشروع الهجرة المفتوحة Project افتح مشروع ترحيل موجود في لوحة التحكم.
الكشف في إكسبلورر عرض مجلد المشروع في عرض المستكشف.
حذف أزل مشروع ترحيل. يطلب منك التأكد قبل الحذف.
تحديث أعد تحميل قائمة مشاريع الترحيل في مساحة العمل الحالية.

المحتوى ذو الصلة

  • Last updated on