this guide:

مقدمة إلى مصادر البيانات

يمكن تكوين مصادر البيانات لجعل جداول قاعدة البيانات أو طرق العرض متاحة في لوحات معلومات SKOOR.

مع الإصدار 7.2 من SKOOR، تمت إضافة ميزات جديدة لإنشاء الجداول وتحريرها بالإضافة إلى بيانات الجدول.

قواعد بيانات MySQL و PostgreSQL مدعومة.

إنشاء مصدر تاريخ

انقر على علامة + وأضف معلمات الاتصال ضمن علامة التبويب عام:

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

يمكن استخدام علامة التبويب عام لتحديث اسم مصدر البيانات ومعلمات الاتصال وإعدادات المهلة. انقر فوق حفظ لحفظ هذه التغييرات.

تحديد نطاقات البيانات وأذونات الكتابة

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

نطاقات البيانات

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

يمكن أن تكون تعبيرات تمييز النطاق عبارة عن قيم سلسلة عادية أو عوامل تشغيل موصوفة في صفحة محرر استعلام مصدر البيانات.

أمثلة على التعبيرات:

أذونات الكتابة

بشكل عام، تنطبق القواعد التالية على أدوار مستخدمي SKOOR:

• يمكن للمستخدمين الذين لديهم دور المحرر قراءة جميع البيانات من جميع الجداول

• لا يمكن للمستخدمين الذين لديهم دور المشغل رؤية أي بيانات على الإطلاق

تحديد أذونات الكتابة لـ

• السماح للمستخدمين الذين لديهم دور المحرر بتحرير البيانات في جداول محددة

• السماح للمستخدمين الذين لديهم دور المشغل بقراءة البيانات وتحريرها في جداول محددة

معاينة مصدر البيانات

في علامة تبويب البيانات، تظهر جميع الجداول وطرق العرض وما إلى ذلك من مصدر البيانات المحدد. سيرى مستخدمو المشغِّل الجداول فقط كما هو محدد بأذونات الكتابة.

حدد عنصرًا من المجموعات الموجودة على اليسار (مثل الجداول) لعرض بياناته. انقر فوق اسم عمود لفرزه أو استخدم زر تبديل الفلاتر في الجانب الأيمن للبحث عن سجلات محددة.

تحرير مصدر بيانات

إنشاء/استيراد جدول

يمكن إنشاء جداول جديدة يدويًا أو مع استيراد البيانات.

انقر فوق الرمز + الموجود بجوار مجموعة الجداول لفتح مربع الحوار إضافة جدول :

لتعريف جدول يدويًا، انقر فوق الزر "إضافة " المعني لإضافة الأعمدة والمؤشرات وتحديد الأسماء وأنواع البيانات ... إلخ.

لمزيد من المعلومات، راجع القسم التالي، تحرير المخطط

لإضافة جدول مع استيراد البيانات، قم بتبديل زر اختيار الأعمدة إلى استيراد:

انقر فوق استيراد من ملف وافتح ملف Excel (XLSX) أو CSV المطلوب. سيقوم برنامج SKOOR الآن بتقييم الأعمدة وأنواع البيانات:

لضمان إمكانية استيراد نفس الملف مرة أخرى مع تحميل البيانات في المستقبل، لا يمكن تغيير أسماء الأعمدة. حدد اسم الجدول (بشكل افتراضي، يأخذ البرنامج اسم الملف) بالإضافة إلى المفتاح الأساسي والمؤشرات ونوع البيانات وما إلى ذلك، ثم انقر فوق إنشاء واستيراد لبدء إنشاء الجدول الفعلي واستيراد البيانات.

تحرير جدول موجود

تحرير المخطط

انقر على أيقونة الخيارات على عنصر جدول لتحرير مخططه:

استخدم مربع حوار تحرير الجدول لتغيير اسم الجدول، أو المفتاح الأساسي، أو المؤشرات أو الأعمدة في قاعدة البيانات:

تحرير البيانات

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

بالإضافة إلى ذلك، يتوفر لحقل النص ومساحة النص خيار تعيين قيمته إلى NULL، ويمكن القيام بذلك عن طريق النقر على أيقونة X التي تظهر عند التمرير فوق هذا الحقل.

انقر فوق حفظ التغييرات لاستمرار البيانات.

حذف الجدول

انقر على أيقونة الخيارات على أحد عناصر الجدول وحدد حذف لحذفه.

التصدير/الاستيراد في مصادر البيانات

تصدير البيانات

يمكن تصدير البيانات إلى ملف CSV بالنقر على زر تصدير . سيحتوي الملف الناتج على البيانات فقط كما هي معروضة في المعاينة، مما يعني تطبيق النطاقات المحددة.

استيراد البيانات

يمكن استيراد ملفات Excel (بتنسيق XLSX فقط) والملفات المفصولة بفواصل (CSV) لاستبدال جدول أو تحديثه. انقر على زر استيراد لفتح مربع الحوار:

أولاً، انقر فوق استيراد من ملف لفتح ملف. بعد ذلك، حدد أحد أوضاع الاستيراد التالية:

• INSERT: إدراج جميع السجلات من الملف. يتم إدراج التكرارات إذا كان تعريف الجدول يسمح بذلك

• UPSERT: إدراج جميع السجلات من الملف. إذا كان هناك سجل موجود بالفعل، فسيتم تحديثه. يجب تعريف مفتاح أساسي في الجدول لهذه الحالة.

• الاستبدال: سيتم اقتطاع البيانات الموجودة قبل تحميل البيانات من الملف.

إنشاء مصدر بيانات نصي (مهمل)

إذا تم تغيير نوع مصدر البيانات إلى SCRIPT، تتغير معلمات التكوين. الآن، يمكن تكوين برنامج نصي مع أي معلمات مطلوبة لإنشاء مخرجات مناسبة للوحات معلومات SKOOR.

المعلمة	الوصف
الاسم	اسم مصدر البيانات. سيكون هذا الاسم متاحًا في إعدادات الأداة عندما يتم تعيين نوع البحث على dataSource. سيتم دائماً تعيين الجدول إلى STDOUT:
جلب قابل للتنفيذ	المسار المؤهل بالكامل إلى البرنامج أو البرنامج النصي الذي يقوم بإنشاء البيانات. يجب أن يكون هذا البرنامج متاحًا على النظام الذي تم تثبيت خدمة الويب SKOOR عليه
وسيطات الإحضار	وسيطات سطر الأوامر للبرنامج، وسيطة واحدة لكل سطر. يمكن تمرير أي معلمات تم تعيينها في الأداة الهدف إلى البرنامج النصي بالإضافة إلى الوسيطات التي تم تعيينها مباشرة في هذا الحقل. مثال: تم تكوين عرض معلمة عنوان URL كاستعلام بحث في أداة جدول: يمكن الآن تمرير نفس المعلمة إلى البرنامج النصي لمصدر البيانات بالإضافة إلى الوسيطات الأخرى، على سبيل المثال القيمة "123":
جلب مؤشر النتيجة	إذا كانت هناك حاجة إلى مجموعة فرعية فقط من نتيجة سلسلة JSON الخاصة بالبرنامج في لوحات المعلومات، فيجب تعيين مؤشر JSON. يتم إنشاء المثال التالي لسلسلة JSON بواسطة برنامج (تم تشكيلها لسهولة القراءة): { "host": "myhost", "filesystems": [ { "size": "51G", "used": "22G", "available": "27G", "usedp": "46%", "mountpoint": "/" }, { "size": "17G", "used": "45M", "available": "16G", "usedp": "1%", "mountpoint": "/home" } ] } سيتم عرض مصفوفة أنظمة الملفات فقط على لوحة المعلومات. لذا يجب تعيين مؤشر JSON /filesystems كمؤشر نتيجة جلب: إذا كان يجب عرض جميع كائنات سلسلة JSON، قم بتعيين مؤشر نتيجة الجلب إلى"/".
قابل للتنفيذ المميز	إذا كان سيتم استخدام مصدر بيانات البرنامج النصي لأداة مصفوفة التصفية، فستكون هناك حاجة إلى مصفوفة JSON بقيم فريدة. يجب على البرنامج النصي أو البرنامج الذي تم تكوينه هنا إرجاع مثل هذه المصفوفة
وسيطات مميزة	انظر وسيطات الإحضار
مؤشر نتيجة مميزة	انظر مؤشر نتيجة الجلب
الأعمدة	يجب تكوين حقول JSON الخاصة بمخرجات البرنامج النصي كأعمدة لتكون متاحة على هذا النحو في أدوات لوحة المعلومات