دليل المستخدم

يشرح هذا الدليل سير العمل الكامل لاستخدام Data Source Explorer (DSE).

استخدمه كمرجع تفصيلي يغطي:

• الاستكشاف والاكتشاف
• مراجعة الاتصالات واختبارها
• تصفح الكائنات
• العمل على Schema Catalog و Data Catalog
• تكوين أهداف الإخراج
• إنشاء الـ deployables
• مراجعة النتائج والمخطط الرسومي وعمليات التصدير
• حفظ مساحة العمل وإعدادات المهمة

1. ما الذي صُمم التطبيق للقيام به

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

التدفق المعتاد يكون كالتالي:

1. اختيار الهدف ثم تشغيل Discover
2. مراجعة شجرة المصادر المكتشفة
3. مراجعة معلومات الاتصال أو تعديلها
4. اختبار الاتصال
5. تحميل الجداول / المجموعات / الـ buckets / الكائنات الأخرى
6. فحص بنية الكائن ومعاينة البيانات
7. بناء Schema Catalog / Data Catalog لما يهمك فعلاً
8. تكوين output targets عندما تحتاج إلى كائنات وجهة محددة
9. إنشاء deployables لوجهة تشغيل واحدة أو أكثر
10. مراجعة الملفات الناتجة، وعند الحاجة إنشاء المخطط الرسومي

2. تخطيط النافذة الرئيسية

منطقة الأوامر العلوية

استخدم هذه المنطقة من أجل:

• اختيار اللغة
• العمل مع قائمة Workspace
• فتح Plugins و Logs و Help
• تبديل المظهر
• تحديد هدف الاكتشاف والضغط على Discover

شجرة التنقل اليسرى

يعرض الجانب الأيسر البيئة المكتشفة. وقد ترى حسب السياق:

• قواعد بيانات
• جداول
• Views
• Collections
• Buckets
• مخازن ملفات أو كائنات
• عقد cloud أو SaaS
• عقد مرتبطة بالـ mainframe

منطقة العمل اليمنى

تعرض:

• ملخص المصدر المحدد
• إجراءات خاصة بالمصدر
• قوائم الكائنات
• تبويبات مثل table info و preview و row details و catalog schema و data catalog و output data

3. بدء جلسة عمل

1. شغّل التطبيق.
2. اختر لغة الواجهة إذا لزم الأمر.
3. في مربع الهدف، أدخل الجهاز أو المضيف أو البيئة أو مسار الاكتشاف الذي تريد فحصه.
4. اختر نوع الاكتشاف إذا كانت هناك أوضاع متعددة.
5. اضغط Discover.

ممارسات جيدة

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

4. اكتشاف المصادر واستكشافها

بعد انتهاء الاكتشاف، راجع الشجرة اليسرى بعناية.

ما الذي يجب ملاحظته:

• أيقونات نوع المصدر
• أسماء المصادر
• تلميحات المضيف أو endpoint
• حالات مثل reachable أو offline أو local only أو configured
• العقد الفرعية مثل قواعد البيانات والجداول والمجموعات والـ buckets والخدمات

تسلسل عمل موصى به

1. وسّع الشجرة مستوى بعد مستوى
2. اختر مصدرًا مهمًا
3. راجع الملخص في الجهة اليمنى
4. قرر هل تريد فتح التفاصيل أو تعديل الاتصال أو إزالة النطاق أو متابعة تحميل الكائنات

5. مراجعة التفاصيل وتعديل معلومات الاتصال

بالنسبة للمصدر المحدد، قد يعرض DSE إجراءات مثل:

• Open details
• Edit connection
• Remove scope
• Test connection
• Load tables
• Run sample query
• Generate deployables
• Compose targets

Open details

استخدمه لعرض ملخص تقني للقراءة فقط عن العقدة أو الاتصال المحدد.

Edit connection

استخدمه عندما:

• يتم اكتشاف المصدر لكنه يحتاج إلى بيانات اعتماد
• تحتاج إلى تصحيح host أو port أو database أو service أو path
• تريد استخدام connection string أو endpoint بديل

التسلسل المقترح:

1. عدّل الحقول الضرورية فقط
2. احفظ التغييرات
3. نفّذ Test connection مباشرة
4. بعد ذلك فقط تابع إلى تحميل الكائنات أو إنشاء deployables

6. اختبار الاتصال

استخدم Test connection قبل أي عملية مهمة.

الاختبار الجيد يؤكد أن:

• الـ endpoint قابل للوصول
• المصادقة تعمل
• قاعدة البيانات / الخدمة / الـ bucket صحيحة
• الـ plugin أو الـ provider قادر على الاتصال بالمصدر

إذا فشل الاختبار:

• تحقق من host و port واسم instance/service
• تحقق من بيانات الاعتماد
• تحقق من الشبكة والجدار الناري والقيود المحلية
• تحقق من أن الـ driver/plugin المطلوب مثبت ومفعّل
• افتح Logs لمزيد من التفاصيل

7. تحميل الكائنات وفحص البنية

بعد نجاح الاتصال، اضغط Load tables أو الأمر المكافئ.

حسب نوع المصدر قد يتم تحميل:

• جداول وViews علائقية
• مجموعات وثائق
• Buckets و measurements
• مجموعات أخرى من الكائنات

كيف تفحص الكائنات

1. اختر كائنًا من القائمة
2. راجع Table info أو التبويب المكافئ
3. افتح Preview لمعاينة صفوف أو وثائق نموذجية
4. استخدم Row details لفحص سجل محدد بالتفصيل
5. راجع Catalog Schema و Data Catalog عندما تريد تحويل البنية إلى تعريف قابل لإعادة الاستخدام

8. بناء Schema Catalog و Data Catalog

Schema Catalog

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

Data Catalog

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

ممارسات جيدة

• اجعل الكتالوج مركزًا على ما تحتاجه فعلاً
• لا تضف كائنات تجريبية إلا إذا كنت تريد ظهورها في الإخراج النهائي
• راجع أسماء الكائنات قبل الانتقال إلى تكوين الأهداف

9. إنشاء Output Data مباشرة

استخدم Output Data عندما تريد إنتاج ملفات بيانات من الكتالوج المحدد.

يفيد ذلك في:

• تشغيلات التحقق
• أخذ عينات
• المراجعة التشغيلية
• التأكد من أن الربط والوصول للبيانات يعملان كما هو متوقع

أنواع المخرجات الشائعة:

• CSV
• Excel (.xlsx)
• JSON ملخّص أو ملفات log

قبل تشغيل كبير:

• تأكد من الكائنات المحددة
• تأكد من تنسيقات الإخراج
• تأكد من حدود الصفوف إن وُجدت
• تأكد من مجلد الإخراج

10. تكوين أهداف الإخراج

استخدم Compose targets عندما تحتاج إلى ربط موجه للوجهة، وليس مجرد استعراض المصدر.

عادة ستعمل مع ثلاث طبقات:

1. الصفوف/الحقول المصدرية المتاحة في اليسار
2. هدف أو أكثر في الوسط
3. الكائنات الهدف وعمليات الربط في اليمين

سير العمل المعتاد

1. أنشئ target جديدًا
2. اختر preset أو نوع نظام الوجهة
3. أنشئ target object واحدًا أو أكثر
4. اختر الصفوف/الحقول المصدرية
5. أضفها إلى target object المحدد
6. راجع جدول الـ mappings
7. أصلح تحذيرات التحقق
8. احفظ تعريف الهدف

نصائح التحقق

أصلح قبل الحفظ:

• أسماء targets المفقودة
• الأسماء المكررة
• أسماء الحقول غير الصالحة للتقنية المختارة
• الـ mappings المفقودة

11. إنشاء deployables

استخدم Generate deployables لإنشاء portable runner أو مخرجات نشر مرتبطة اعتمادًا على الكتالوج و/أو الأهداف المحفوظة.

أوضاع الإدخال

يدعم DSE نمطين شائعين:

• استخدام اختيار الكتالوج الحالي مباشرة
• استخدام واحد أو أكثر من saved output targets

عند تفعيل targets المحفوظة يمكنك إضافة targets من القائمة المنسدلة، وتكوين مجموعة multi-target، والتنقل بين الـ chips، وإزالة targets من المهمة الحالية.

قسم Destination instance

يحدد هذا القسم كيف سيتصل الـ deployable بالوجهة أو كيف سيفسر target definition.

راجع حقولًا مثل:

• target category
• instance/site name
• host/IP
• port
• database/service/path
• user name
• password
• optional connection string override

المنصات و runtimes

اختر منصة واحدة أو أكثر، ثم اختر runtime identifiers المتوافقة.

Output options

اختر الملفات التي يجب أن ينتجها الـ runner، مثل:

• CSV
• Excel

وراجع أيضًا:

• الحد الأقصى للصفوف لكل كائن
• مجلد الإخراج
• ما إذا كان يجب تضمين connection strings في المخطط الناتج

لوحة readiness

قبل الإنشاء، اقرأ قسم الاستعداد/preflight.

يجب أن يوضح ما إذا كان لا يزال هناك نقص في:

• المنصات
• الـ runtimes
• تنسيقات الإخراج
• مجلد الإخراج
• تعريف إدخال صالح

Generate

عندما تصبح الإعدادات جاهزة:

1. راجع الـ targets والـ chips المحددة
2. راجع قيم الوجهة
3. راجع المنصات و runtimes والتنسيقات والمجلد
4. اضغط Generate

12. حفظ إعدادات المهمة

عند مغادرة صفحة Generate deployables قد يسألك التطبيق إن كنت تريد الاحتفاظ بإعدادات المهمة.

إذا اخترت الاحتفاظ بها

يمكن للتطبيق استعادة:

• الـ saved targets المحددة
• الـ chip النشط
• قيم destination instance
• المنصات و RIDs المحددة
• خيارات الإخراج
• مجلد الإخراج
• حدود الصفوف
• بقية إعدادات التوليد ذات الصلة

إذا اخترت عدم الاحتفاظ بها

سيتم مسح الإعدادات المؤقتة.

13. مراجعة deployables التي تم إنشاؤها

بعد التوليد يعرض DSE منطقة ملخص.

استخدمها من أجل:

• فحص العناصر الناتجة
• فتح مجلد الإخراج
• عرض النتائج
• تشغيل الـ runner مباشرة إذا كان مسار التشغيل متاحًا

14. مراجعة نتائج التشغيل

نافذة النتائج هي سطح التحقق بعد التشغيل.

وهي تعرض عادة:

• قائمة الملفات الناتجة
• نوع كل ملف وحجمه
• إجراءات فتح الملفات
• معاينة جدوليّة لملفات CSV/Excel
• معاينة نصية لملفات JSON/log/text
• شرائح ملخص توضّح عدد الملفات وأنواعها وتوفر المعاينة وحالة المخطط الرسومي

تسلسل مراجعة موصى به

1. افتح نافذة النتائج
2. حدّد كل ملف مرة واحدة على الأقل
3. راجع التبويبات أو النص
4. تحقق من عدد الصفوف وأسماء الأعمدة
5. افتح الملف الفعلي إذا احتجت إلى تحقق خارجي

15. إنشاء المخطط الرسومي

من نافذة النتائج استخدم Generate schema لبناء مخطط مرئي للتشغيل.

يمكن أن يربط المخطط بين:

• Data Source Explorer
• المصادر المكتشفة
• الكائنات المحددة مثل tables و collections و buckets
• الأهداف المكوّنة
• ملفات الإخراج الناتجة

وهو مفيد من أجل:

• التوثيق
• المراجعة التشغيلية
• التحقق من التصميم
• شرح سير العمل لشخص آخر

أثناء البناء يجب أن يوضح شريط التقدم أن هناك نشاطًا جاريًا.

Save graph

استخدم Save graph لتصدير المخطط إلى تنسيق مدعوم مثل:

• PDF
• SVG
• PNG
• BMP
• draw.io
• PlantUML / UML text
• HTML preview

16. Workspaces

استخدم قائمة Workspace لإدارة الجلسات القابلة لإعادة الاستخدام.

الإجراءات الشائعة:

• فتح workspace جديد
• فتح workspace موجود
• recent workspaces
• حفظ workspace الحالي
• Save As
• استيراد/تصدير XML
• حفظ والخروج

توصية

• احفظ بعد نجاح الاكتشاف
• احفظ مرة أخرى بعد العمل على الكتالوج
• احفظ مرة أخرى بعد تكوين targets إذا كان الربط مهمًا
• استخدم Save As قبل التجارب الكبيرة

17. Plugins و Logs و Help

Plugins

افتح Plugins لمراجعة الـ providers/extensions المتاحة. إذا كان نوع مصدر مفقودًا أو يتصرف بطريقة غير متوقعة، فتحقق أولًا من حالة الـ plugin.

Logs

افتح Logs كلما احتجت إلى تفاصيل تقنية عن الاكتشاف أو الاتصال أو التوليد أو مشاكل التشغيل.

Help

افتح Help للحصول على وثائق قابلة للبحث. اضغط F1 للمساعدة السياقية.

18. تسلسل تشغيل موصى به لعملية نظيفة

1. افتح أو أنشئ workspace
2. نفّذ discovery للنطاق المطلوب
3. اختر مصدرًا وراجع تفاصيله
4. عدّل الاتصال إذا لزم الأمر
5. نفّذ test connection
6. حمّل الكائنات
7. افحص المعاينة والبنية
8. ابنِ الكتالوج
9. كوّن targets إذا احتاج التشغيل إلى mapping صريح للوجهة
10. افتح generate deployables
11. اختر saved targets أو إدخال الكتالوج
12. راجع إعدادات الوجهة والمنصات و runtimes والتنسيقات والمجلد
13. نفّذ التوليد
14. افتح الملخص ثم النتائج
15. راجع الملفات والمعاينات
16. أنشئ واحفظ المخطط الرسومي إذا كنت تحتاج إلى توثيق
17. احفظ workspace

19. قائمة تحقق لاستكشاف الأخطاء

Discovery يعيد نتائج كثيرة أو قليلة جدًا

• ضيّق النطاق
• تحقق من نوع الهدف
• تأكد من البيئة التي تعمل عليها

Test connection يفشل

• تحقق من endpoint
• تحقق من بيانات الاعتماد
• تحقق من database/service/path
• تحقق من الشبكة والجدار الناري
• افحص Logs

الكائنات لا تظهر بعد التحميل

• تأكد أولًا من نجاح test connection
• تحقق من صلاحيات المصدر
• أعد التحميل بعد تصحيح إعدادات الاتصال

إنشاء deployables متوقف

• راجع readiness panel
• تأكد من اختيار منصة واحدة على الأقل و runtime واحد على الأقل
• تأكد من تحديد التنسيقات ومجلد الإخراج
• تأكد من صحة تعريف الإدخال

النتائج تبدو غير مكتملة

• تحقق من حدود الصفوف
• تحقق من استخدام الاختيار الصحيح للـ targets/objects
• افتح الملفات مباشرة من القرص للمقارنة
• راجع summary JSON/log للحصول على معلومات إضافية

20. توصيات نهائية

للحصول على أفضل موثوقية:

• نظّم workspaces حسب البيئة أو المشروع
• تحقّق من الاتصالات قبل التحميل أو التوليد
• اجعل تعريفات الأهداف واضحة ونظيفة
• راجع الملفات الناتجة قبل مشاركتها
• استخدم تصدير المخطط الرسومي من أجل التتبّع والتوثيق