SQL-DB Client Connect

تُستخدم هذه الدالة (function block) لتكوين وإقامة اتصال بقاعدة بيانات SQL (MySQL, PostgreSQL, MSSQL, SQLite). استخدمها لإنشاء عميل قاعدة بيانات دائم يمكن لباقي البلوكات استخدامه لتنفيذ استعلامات أو عمليات بيانات.

📥 المدخلات

هذه الدالة ليس لديها مخارج/مداخل (input sockets).

📤 المخرجات

• DB Client — كائن عميل قاعدة بيانات قابل لإعادة الاستخدام يمكن لباقي البلوكات (مثل SQL-DB Operations) استخدامه لتنفيذ استعلامات ومعاملات.

• Connection Success — قيمة منطقية تُشير ما إذا تم إنشاء الاتصال بنجاح أم لا.

🕹️ الضوابط (Controls)

• Database Type — قائمة منسدلة لاختيار نوع قاعدة البيانات (MySQL, PostgreSQL, MSSQL, SQLite). اختيار SQLite يبسط واجهة المستخدم لأن الحقول host/port/user/password ستكون مخفية.

• Host — اسم المضيف أو عنوان IP لخادم قاعدة البيانات. مخفي عند اختيار SQLite.

• Database — اسم قاعدة البيانات. في حالة SQLite يُستخدم هذا الحقل كمسار ملف قاعدة البيانات.

• Port — منفذ TCP لخادم قاعدة البيانات. مخفي عند اختيار SQLite.

• User — اسم مستخدم قاعدة البيانات. مخفي عند اختيار SQLite.

• Password — كلمة مرور قاعدة البيانات. مخفي عند اختيار SQLite.

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

🎯 الميزات (Features)

• دعم بسيط لعدة قواعد بيانات من خلال واجهة موحدة للأنواع الشائعة من SQL.

• توافق مع SQLite مع حقول أقل عند اختيار قاعدة بيانات ملفية.

• يصدر DB Client جاهز للاستخدام وعلَم Connection Success للاعتماد عليه في المنطق التالي ومعالجة الأخطاء.

• إعادة اتصال تلقائية عند اكتشاف تغييرات في التكوين.

📝 تعليمات الاستخدام (Usage Instructions)

1. اختر Database Type الذي يتوافق مع خادمك.

2. املأ Host، Port، User، Password، و Database حسب الحاجة (بالنسبة لـ SQLite ضع مسار الملف في Database).

3. شغّل السيناريو أو قيّم البلوك. سيحاول البلوك الاتصال وسيضبط Connection Success وفق النتيجة.

4. استخدم DB Client المقدم مع SQL-DB Operations لتنفيذ استعلامات، إدخالات، تحديثات أو مهام قاعدة بيانات أخرى.

5. إذا قمت بتغيير أي حقول اتصال، سيعيد البلوك ضبط الاتصال الحالي وسيحاول إعادة الاتصال عند التقييم التالي.

📊 التقييم (Evaluation)

عند التقييم، يتحقق البلوك من المعايير المقدمة ويقوم بمحاولة إقامة الاتصال. عند النجاح يعرض عميلًا قابلاً لإعادة الاستخدام عبر مخرج DB Client ويضبط Connection Success إلى true. عند الفشل يقوم بتسجيل خطأ ويضبط Connection Success إلى false.

💡 نصائح وحيل (Tips and Tricks)

• اجمعه مع SQL-DB Operations لتشغيل الاستعلامات وإرجاع النتائج داخل التدفق.

• استخدم Data to JSON لتسلسل النتائج المعقدة قبل حفظها في ملفات أو إرسالها عبر الشبكة.

• استخدم CSV Export أو Image Logger (لمتاديتا الصور) لحفظ نتائج الاستعلامات.

• استخدم Data Write Local أو Data Write Global لتخزين DB Client أو نتائج الاستعلام الأخيرة لإعادة الاستخدام في أجزاء مختلفة من مشروعك.

• استخدم Debug Input لفحص المخرجات الأولية من SQL-DB Operations أثناء البناء واستكشاف الأخطاء.

🛠️ استكشاف الأخطاء وإصلاحها (Troubleshooting)

• فشل الاتصال مع أن بيانات الاعتماد صحيحة: تحقّق من الوصول الشبكي إلى Host وأن المنفذ Port مفتوح ويستقبل الاتصالات.

• عند استخدام SQLite: تأكد أن المسار في Database قابل للوصول وأن التطبيق لديه أذونات قراءة/كتابة على الملف.

• إذا بدت التغييرات في التكوين غير فعالة: عدّل أي تحكم (مثلاً Host) لإجبار البلوك على إعادة ضبط وإعادة إنشاء الاتصال.

• إذا احتجت لتأكيد البيانات المرجعة أثناء التطوير، قم بتوصيل SQL-DB Operations و Debug Input لفحص الاستجابات قبل دمجها.