ترحيل Oracle إلى PostgreSQL

يوفر ملحق PostgreSQL تعليمة Visual Studio برمجية سير عمل موجه لمخطط Oracle وتحويل التطبيق. يرشدك المعالج خلال الاتصال ب Oracle، وتحديد المخططات، ومراجعة الاكتشاف، واختيار قاعدة بيانات PostgreSQL الصفرية، وتكوين Microsoft Foundry. بعد التحويل، راجع تقرير HTML Object Explorer التحويل، ثم قم بإعداد النشر باستخدام تجربة الإعداد. تخطيط ترحيل بيانات الصف بشكل منفصل.

مهم

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

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

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

تحويل المخطط

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

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

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

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

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

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

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

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

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

  • تعليمة Visual Studio برمجية مثبت.
  • تم تثبيت إضافة PostgreSQL.
  • الوصول إلى قاعدة بيانات مصدر Oracle مع أذونات لقراءة بيانات تعريف المخطط وطرق عرض القاموس. الوصول إلى بيانات الصف غير مطلوب.
  • خادم مرن قاعدة بيانات Azure لـ PostgreSQL مع قاعدة بيانات فارغة أو مخصصة وغير مستخدمة تحتوي على أي شيء تحتاج إلى الاحتفاظ به. يجب أن يكون مستخدم الاتصال قادرا على إسقاط وإعادة إنشاء مخططات مطابقة وإنشاء كائنات التحقق من الصحة. لا يدعم تحويل المخطط Azure HorizonDB كقاعدة بيانات الصفر.
  • مورد Microsoft Foundry مع نموذج منشور gpt-5.2 وحصة أكبر من 1000000 رمز مميز في الدقيقة (TPM). تحتاج إلى رابط نقطة النهاية وإما مفتاح 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. حدد Next: Discovery.

الخطوة 3: مراجعة الاكتشاف

يتحقق Discovery من أذونات المصدر ويجرد المخططات المحددة قبل استخراج DDL.

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

للحصول على شاشة الاكتشاف والإرشادات الكاملة، راجع مراجعة نتائج الاكتشاف في البرنامج التعليمي.

الخطوة 4: اختر قاعدة بيانات قاعدة بيانات Azure لـ PostgreSQL الصفر

تحدد صفحة Choose an قاعدة بيانات Azure لـ PostgreSQL scratch database قاعدة البيانات المستخدمة للتحقق من صحة DDL المحولة.

التحذير

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

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

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

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

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

    الميدان الوصف
    اسم النموذج .
    نقطة نهاية 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.

تخصيص حصة توزيع أكبر من 1,000,000 TPM. راجع تكوين سعة Microsoft Foundry.

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

بعد إنشاء المشروع، قم بتشغيل التحويل ومراجعة النتائج في مشروع الترحيل.

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

  1. حدد ترحيل لبدء الاستخراج والتحويل.
  2. مراقبة تقدم الاستخراج والتحويل.
  3. عندما يظهر المشروع اكتمال تحويل المخطط، حدد مراجعة ملخص التحويل.

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

مراجعة الكائنات المحولة

استخدم Object Explorer التحويل لفحص كل من الكائنات المحولةوغير المحولة:

  1. افتح كائن لمقارنة تعريفات Oracle وPostgreSQL الخاصة به، حيثما كان ذلك متاحا، واقرأ ملاحظات التحويل الخاصة به.
  2. حدد طلب شرح أو إصلاح عمليات التحرير بمساعدة Copilot إلى ملف PostgreSQL الخاص به.
  3. إذا تم نشر المخطط بالفعل في قاعدة بيانات غير إنتاجية، فقم بتجميع التصحيحات هناك عن طريق تأكيد الخادم النشط وقاعدة البيانات، وتحديد عبارات كاملة، وتنفيذ هذا التحديد فقط. وإلا، قم أولا بإعداد النشر الموضح في القسم التالي.
  4. تأكد من أن نشر SQL يتضمن التصحيحات التي تنوي نشرها. لا يثبت تحرير ملف كائن أن كائن قاعدة البيانات الخاص به أو البرنامج النصي للتوزيع الذي تم إنشاؤه قد تغير.

للحصول على عوامل التصفية وأعضاء الحزمة والخطوات التفصيلية، راجع تحويل Object Explorer.

التحضير للنشر

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

راجع تقارير النشر وتحقق من صحة البيانات وسلوك التطبيق بشكل مستقل قبل استخدام الإنتاج. للحصول على المتطلبات الأساسية وأوضاع قاعدة البيانات والأوامر، راجع نشر المخططات المحولة باستخدام تجربة الإعداد.

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

بعد ترحيل المخطط، قم بتحويل كود التطبيقات الخاص بأوراكل (سكريبتات 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 لتحديد موقع زوج مطابق. لإخراج تحويل المخطط، استخدم Object Explorer التحويل للتنقل في تعيينات المصدر إلى الهدف.

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

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

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

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

  • تاريخ آخر تحديث في