الدرس: Oracle إلى قاعدة بيانات Azure لـ PostgreSQL تحويل مخطط الخادم المرن

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

يغطي الاتصال بمصدر Oracle الخاص بك وقاعدة بيانات Azure لقاعدة بيانات PostgreSQL المستهدفة، وتكوين Microsoft Foundry، وتشغيل معالج الترحيلات، ومراجعة التشكيلات الناتجة عن PostgreSQL. قبل أن تبدأ، تأكد من أن لديك وصول إلى الشبكة وبيانات الاعتماد لكل من الخوادم ونشر Microsoft Foundry.

إليك ما يمكنك توقعه أثناء التحويل:

  • اكتشاف المخطط: تقوم الأداة بتحليل كائنات مخطط Oracle الخاصة بك.
  • AI processing: Microsoft Foundry يعالج ويحول الكائنات المتوافقة.
  • التحقق من الصحة: يتم التحقق من صحة الكائنات المحولة في قاعدة بيانات الخدش.
  • مراجعة المهام: يتم تمييز الأشياء التي تتطلب انتباها يدويا.
  • توليد المخرجات: يتم حفظ الكائنات المحولة بنجاح كملفات PostgreSQL.

المتطلبات المسبقه

يصف هذا القسم المتطلبات الأساسية لاستخدام ميزة تحويل مخطط Oracle إلى Azure لPostgreSQL في كود Visual Studio قبل بدء التحويل.

متطلبات النظام

الفئة التفاصيل
نسخة كود Visual Studio 1.95.2 أو ما أحدثه
اشتراك GitHub Copilot Pro+، الأعمال، المؤسسات

دعم نظام التشغيل

نظام تشغيل تفاصيل الدعم
Windows هندسة x64 فقط
ينكس هندسة x64
نظام تشغيل macOS macOS 13+

متطلبات قاعدة بيانات Azure لـ PostgreSQL الهدف

المكون متطلبات الإصدار
قاعدة بيانات Azure ل PostgreSQL PostgreSQL الإصدار 15 أو أحدثه
قاعدة بيانات سكراتش خادم مرن قاعدة بيانات Azure لـ PostgreSQL

متطلبات نموذج الذكاء الاصطناعي

تحتاج إلى أحد المكونات التالية في الذكاء الاصطناعي مكونا:

مكون الذكاء الاصطناعي إصدار النموذج
مايكروسوفت فاوندري نشر GPT-5.2

تكوين نشر Microsoft Foundry

في Microsoft Foundry، أنشئ نشرا يستخدم نموذج gpt-5.2. اسم النشر هو الذي اخترته عند إنشاء النشر؛ لا يجب أن يتطابق مع اسم الطراز.

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

  • https://{your-resource}.services.ai.azure.com
  • https://{your-resource}.openai.azure.com
  • https://{your-resource}.cognitiveservices.azure.com

استبدل {your-resource} باسم مورد Microsoft Foundry الخاص بك (على سبيل المثال، oracletopg). إذا كنت بحاجة إلى استدعاء مسار استنتاج مباشرة، فإن مسار المعاينة الحالي هو /openai/responses?api-version=2025-04-01-preview.

لمزيد من المعلومات حول صيغ نقاط النهاية ومسارات الاستدلال، راجع Endpoints لنماذج Microsoft Foundry.

تلميح

لتوجيه حركة مرور Microsoft Foundry عبر إدارة Azure API للحوكمة المركزية، والتقييد والتقييث، وقابلية الملاحظة، قم بتكوين بوابة ذكاء اصطناعي أمام مورد Foundry الخاص بك واستخدم عنوان URL الخاص بالبوابة كنقطة نهاية. لمزيد من المعلومات، راجع تكوين بوابة الذكاء الاصطناعي في موارد Foundry الخاصة بك.

الامتيازات المطلوبة لقاعدة البيانات

قبل تشغيل تحويل المخطط، تأكد من أن الحسابات التي تستخدمها لديها الحد الأدنى من الصلاحيات المطلوبة على كل من قاعدة بيانات Oracle المصدر وخادم Extended قاعدة بيانات Azure لـ PostgreSQL المرن. يحتاج حساب أوراكل إلى وصول القراءة إلى البيانات وعرض القاموس حتى تتمكن الأداة من تحليل المخطط والشيفرة. يجب أن يكون حساب الخدش في قاعدة بيانات Azure لقاعدة بيانات PostgreSQL قادرا على إنشاء مخططات وجداول وكائنات أخرى للتحقق من الصحة. استخدم حساب خدمة مخصص حيثما أمكن. اتبع مبدأ الأقل امتيازًا. نسق مع مسؤولي قواعد البيانات لمنح أي حقوق مرتفعة مؤقتة والتحقق من الاتصال والوصول قبل بدء التحويل.

امتيازات أوراكل المصدر

الامتيازات الدنيا التالية مطلوبة في قاعدة بيانات Oracle المصدرية:

Privilege (امتياز) الغرض
CONNECT الاتصال الأساسي بقاعدة البيانات
SELECT_CATALOG_ROLE الوصول إلى مشاهدات قاموس البيانات
اختر أي قاموس قراءة بيانات النظام الوصفية وكائنات القاموس
اختار SYS.ARGUMENT$ الوصول إلى معلومات الوسيط عن الإجراءات والدالة

صلاحيات قاعدة البيانات المفقودة

الامتيازات التالية مطلوبة على خادم قاعدة بيانات Azure لـ PostgreSQL المرن (قاعدة بيانات الscratch):

Privilege (امتياز) الغرض
إنشاء شيما إنشاء مخططات التحقق
إنشاء على قاعدة البيانات إنشاء كائنات قاعدة البيانات للتحقق من الصحة
اتصال المنح على قاعدة البيانات أصلاحيات الاتصال لعمليات التحقق

متطلبات الشبكة

  • الاتصال الخارجي: نقاط نهاية Microsoft Foundry.
  • Database connectivity: كل من Oracle المصدر والهدف قاعدة بيانات Azure لـ PostgreSQL خادم مرن.
  • HTTPS access: سوق تعليمة Visual Studio برمجية Extensions وخدمات GitHub Copilot.
  • GitHub وصول المستودع: https://github.com/microsoft/pgsql-tools/.

عميل أوراكل الفوري (لوضع العميل السميك)

تتصل أداة تحويل المخطط بأوراكل باستخدام وضع العميل الرقيق بشكل افتراضي، والذي لا يتطلب برامج إضافية. إذا كانت بيئتك تتطلب وضع العميل السميك، قم بتثبيت Oracle Instant Client على الجهاز الذي يعمل ب تعليمة Visual Studio برمجية. الأداة تقرأ إعدادات ال sqlnet.ora and tnsnames.ora الخاصة بك ثم تنتقل تلقائيا إلى الوضع السميك عندما يتطلب إعداد ذلك.

يمكنك تحديد ما إذا كان وضع العميل السميك مطلوبا من خلال التحقق من ملفات تكوين شبكة أوراكل في بيئة المصدر الخاصة بك. ابحث عن المعلمات التالية في الملف (عادة ما تكون sqlnet.ora موجودة في $ORACLE_HOME/network/admin/):

المعلمة يشير إلى أن الوضع السميك مطلوب
SQLNET.CRYPTO_CHECKSUM_CLIENT قم بتعيين أو REQUIREDREQUESTED لتشفير الشبكة الأصلي
SQLNET.ENCRYPTION_CLIENT قم بتعيين أو REQUIREDREQUESTED لتشفير الشبكة الأصلي

مصادقة Microsoft Foundry

قم بتكوين أحد طرق المصادقة التالية ل Microsoft Foundry:

أسلوب المصادقة المتطلبات
مفتاح واجهة برمجة التطبيقات رابط نقطة النهاية ومفتاح واجهة برمجة التطبيقات في Microsoft Foundry.
Microsoft Entra ID Azure تم تسجيل دخول امتداد الحساب، Foundry User (سابقا Azure AI User) المخصص لمورد Microsoft Foundry.

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

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

الخطوة 1: تثبيت إضافة PostgreSQL تعليمة Visual Studio برمجية

  1. افتح تعليمة Visual Studio برمجية.

  2. اذهب إلى عرض الإضافات (Ctrl+Shift+X).

  3. ابحث عن PostgreSQL وقم بتثبيت امتداد PostgreSQL المنشور بواسطة Microsoft.

    1. تحميل السوق

    لقطة شاشة لتثبيت إضافة PostgreSQL في تعليمة Visual Studio برمجية.

الخطوة 2: إنشاء قاعدة بيانات قاعدة بيانات Azure لـ PostgreSQL connection

  1. في لوحة التوسعات PostgreSQL، أنشئ اتصالا بنسخة الخادم قاعدة بيانات Azure لـ PostgreSQL المرن الخاصة بك.

  2. أدخل تفاصيل الاتصال (المضيف، قاعدة البيانات، اسم المستخدم، كلمة المرور).

  3. اختبر واحفظ الاتصال.

    لقطة شاشة لإضافة اتصال جديد لقاعدة بيانات Azure لPostgreSQL.

الخطوة 3: افتح مساحة عمل جديدة

  1. أنشئ مجلد جديد على جهازك المحلي لمشروع الترحيل.

  2. افتح المجلد ك new workspace في تعليمة Visual Studio برمجية.

    لقطة شاشة لإضافة مساحة عمل جديدة في تعليمة Visual Studio برمجية.

الخطوة 4: تهيئة مشروع ترحيل

  1. افتح إضافة PostgreSQL.

  2. انتقل إلى لوحة عمليات الترحيل .

  3. اختر Create Migration Project.

    لقطة شاشة لإنشاء مشروع ترحيل جديد.

الخطوة 5: تكوين إعدادات المشروع

  1. في معالج الترحيلات، أدخل اسم مشروعك.

  2. حدد التالي للمتابعة.

    لقطة شاشة لاسم المشروع.

الخطوة 6: تكوين اتصال أوراكل

  1. أدخل تفاصيل الاتصال الخاص بك في أوراكل:

    • اسم المضيف أو الخادم.
    • رقم المنفذ.
    • قاعدة بيانات أو اسم خدمة.
    • اسم المستخدم وكلمة المرور.

    الأداة تختار وضع العميل الرقيق أو السميك تلقائيا من إعدادات و sqlnet.oratnsnames.ora ؛ واجهة المستخدم لا تعرض محددا يدويا. يتم استخدام وضع Thin بشكل افتراضي. إذا كنت sqlnet.ora تحتاج إلى وضع سميك، تأكد من تثبيت Oracle Instant Client وأن موقعه على PATH متغير البيئة قبل أن تستمر. لمزيد من المعلومات، راجع Oracle Instant Client.

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

  3. اختر مخططا أو أكثر لتحويله إلى PostgreSQL.

  4. حدد التالي للمتابعة.

    لقطة شاشة لتكوين خادم أوراكل.

الخطوة 7: تكوين قاعدة بيانات قاعدة بيانات Azure لـ PostgreSQL scratch database

  1. اختر قاعدة بيانات Azure لـ PostgreSQL connection الذي حددته في امتداد PostgreSQL.

  2. اختر قاعدة البيانات المستهدفة من القائمة المنسدلة.

  3. حدد التالي للمتابعة.

    لقطة شاشة لتكوين قاعدة بيانات سكراتش.

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

  1. أدخل تفاصيل Microsoft الخاصة بك:

    • رابط نقطة النهاية.
    • اسم النشر (الاسم الذي خصصته للنشر في Microsoft Foundry؛ يجب أن يكون النموذج الأساسي gpt-5.2).

  2. اختر طريقة المصادقة:

    • <مفتاح c0>API : أدخل مفتاح API لنشر Microsoft Foundry الخاص بك.
    • Microsoft Entra ID: تسجيل الدخول باستخدام إضافة Azure Account. تحصل الأداة على رمز المصادقة تلقائيا. تأكد من أن هوية المسجل لها دور Foundry User (المعروف سابقا Azure AI User) في مورد Microsoft Foundry. لمزيد من المعلومات، راجع التحكم في الوصول القائم على الأدوار ل Microsoft Foundry.

  3. اختر اتصال الاختبار للتحقق من الإعدادات.

  4. بعد نجاح الاتصال، اختر إنشاء ترحيل Project.

    لقطة شاشة لتكوين نموذج اللغة.

الخطوة 9: شغل تحويل المخطط

  1. يتنقل النظام إلى ساحر الهجرة الرئيسي.

  2. اختر الترحيل لبدء عملية تحويل المخطط.

  3. راقب تقدم التحويل في واجهة تعليمة Visual Studio برمجية.

    لقطة شاشة لتقدم خطوة الهجرة.

الخطوة 10: راجع تقرير تحويل المخطط

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

الخطوة 11: مراجعة وتحسين مهام التحويل

  1. بعد الانتهاء من تحويل المخطط، تنشئ الأداة مهام مراجعة للكائنات التي تحتاج إلى اهتمام.
  2. استخدم وضع GitHub عامل Copilot mode لحل المهام، أو تحويل المخططات يدويا إلى PostgreSQL.
  3. قارن بين بيانات تحويل المخطط السابقة والجديدة.
  4. لمزيد من المعلومات حول أولويات المهام وملفات SQL التي تم إنشاؤها ومجلدات الإخراج، راجع مراجعة المهام ومجلدات الإخراج ل Oracle قاعدة بيانات Azure لـ PostgreSQL تحويل مخطط الخادم المرن.

الخطوة 12: التحقق من صحة الكائنات المحولة قبل النشر

  1. التحقق بشكل مستقل من جميع الكائنات المحولة في بيئة غير إنتاجية.
  2. تأكد من أن التبعيات والقيود وأعباء العمل الممثلة تتصرف كما هو متوقع.
  3. راجع القرارات لجميع مهام المراجعة وأعد الاختبار بعد التغييرات.

هام

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

لمزيد من المعلومات حول ملحق تعليمة Visual Studio برمجية، تفضل بزيارة ملحق PostgreSQL تعليمة Visual Studio برمجية والمؤشر.

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

  • Last updated on