ترحيل Oracle إلى PostgreSQL

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

مهم

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

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

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

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

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

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

إذا لم تظهر عرض الترحيلات (المعاينة) في الشريط الجانبي، تحقق من الإعداد:

1. إعدادات Open VS Code (Ctrl+، على Windows/Linux، Cmd+، على macOS).
2. ابحث عن pgsql.enableMigrations.
3. أكد أن القيمة هي true.

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

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

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

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

2. اختر الزر في + شريط أدوات العرض، أو انقر بزر الفأرة الأيمن على مجلد workspace في Explorer واختر إنشاء ترحيل Project.

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

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

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

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

الخطوة 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 الموصى بها. يمكنك أيضا اختيار التحقق من الإضافات لتشغيل الفحص يدويا. إذا كانت هناك أي امتدادات مفقودة، تقوم الصفحة بسردها وتقديم إرشادات حول إدراج القوائم المتاحة وتثبيتها من خلال وثائق الخوادم المرنة قاعدة بيانات Azure لـ 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).
   مستأجر	مستأجر Azure AD للحساب (يظهر عندما تكون طريقة المصادقة هي Microsoft Entra Id).
   اسم النشر	اسم النموذج المنشور في مورد 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، اختر Migrationrate باستخدام تحديث التطبيق لمواصلة الترحيل مع ملاحظات البرمجة من تحويل المخطط. اختر عرض ملاحظات الترميز لمراجعة الإرشادات المولدة قبل المتابعة.
• خيار قاعدة البيانات فقط — لتحويل كود التطبيقات المتعلق بقاعدة البيانات فقط ضمن هذا الامتداد، اختر الترحيل باستخدام امتداد PostgreSQL.

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

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

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

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

• محول تطبيقات كود العميل أوراكل (pgsql_migration_oracle_app) — يحول كود تطبيقات عميل أوراكل إلى مكافئات PostgreSQL باستخدام قوالب الأوامر وإرشادات البرمجة من تحليل ترحيل المخطط. يقبل المعايير التالية:

  • مجلد قاعدة الشيفرة في التطبيق (مطلوب) — موقع الكود المراد تحويله.
  • مسار موقع ملاحظات الترميز (اختياري) — مسار إلى ملاحظات الترميز من ترحيل المخطط.
  • Postgres DB Name (اختياري) — اسم قاعدة بيانات PostgreSQL لسياق التحويل.
  • اتصال قاعدة بيانات Postgres (اختياري) — اسم الاتصال لقاعدة بيانات 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	افتح مشروع ترحيل موجود في لوحة التحكم.
الكشف في إكسبلورر	عرض مجلد المشروع في عرض المستكشف.
حذف	أزل مشروع ترحيل. يطلب منك التأكد قبل الحذف.
تحديث	أعد تحميل قائمة مشاريع الترحيل في مساحة العمل الحالية.

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

• تكامل Copilot
• الروابط والهوية
• مرجع الإعدادات
• مرجع أدوات Copilot