التوثيق

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

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

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

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

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

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

يمكن للمستخدمين ذوي صلاحيات المسؤول فقط إنشاء مصادر البيانات

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

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

image-20240808-084010.png

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

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

يمكن للمستخدمين ذوي الصلاحيات الإدارية فقط تحديد نطاقات البيانات وأذونات الكتابة

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

يُسمح للمستخدمين ذوي الصلاحيات الإدارية بقراءة وتعديل جميع البيانات من جميع الجداول

image-20250213-212229.png

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

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

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

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

التعبير

الوصف

1234

يتطابق مع جميع الصفوف التي تحتوي على قيمة عمود تساوي 1234.

NOT(NULL())

تطابق جميع الصفوف التي تحتوي على قيمة عمود غير NULL.

GE(0)

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

foo%

تطابق جميع الصفوف التي تحتوي على قيمة عمود تبدأ بـ "foo"

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

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

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

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

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

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

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

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

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

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

image-20250213-212333.png

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

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

يمكن للمستخدمين ذوي صلاحيات المسؤول فقط إنشاء جداول جديدة

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

انقر على أيقونة + بجوار مجموعة الجداول لفتح مربع حوار "إضافة جدول":

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

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

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

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

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

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

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

تحرير المخطط

يمكن للمستخدمين ذوي الصلاحيات الإدارية فقط تحرير مخطط الجدول

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

استخدم مربع الحوار «تحرير الجدول» لتغيير اسم الجدول أو المفتاح الأساسي أو الفهارس أو الأعمدة في قاعدة البيانات:

الإعداد

الوصف

اسم الجدول

اسم الجدول

المفتاح الأساسي

تحديد مفتاح أساسي من عمود واحد أو عدة أعمدة

الفهارس

تحديد فهارس أحادية أو متعددة الأعمدة للجدول الحالي

الأعمدة

تحديد اسم العمود ونوع البيانات والقيمة الافتراضية. تشغيل أو إيقاف الزيادة التلقائية وتحديد ما إذا كان العمود قابلاً للقيمة الفارغة أم لا

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

يمكن تحرير بيانات الجدول، بينما تكون طرق العرض وطرق العرض المادية وما إلى ذلك للقراءة فقط.

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

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

image-20240808-093526.pngimage-20240808-093610.png

انقر على «حفظ التغييرات» لتثبيت البيانات.

حذف الجدول

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

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

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

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

سيتم تصدير البيانات بترميز UTF-8

image-20240808-095215.png

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

يقتصر حجم الملف على 100 ميجابايت لملفات CSV و2 ميجابايت لملفات XLSX

يمكن إنشاء الجداول مباشرةً أثناء استيراد البيانات. تفضل بزيارة قسم "إنشاء/استيراد جدول" للحصول على التفاصيل

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

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

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

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

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

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

مصادر بيانات البرامج النصية مهملة ولا يُنصح المستخدمون باستخدامها

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

يجب تنسيق مخرجات البرنامج النصي بتنسيق JSON

image-20240717-150657.png

المعلمة

الوصف

الاسم

اسم مصدر البيانات. سيكون هذا الاسم متاحًا في إعدادات عنصر واجهة المستخدم عندما يتم تعيين نوع البحث على 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 الخاصة بمخرجات البرنامج النصي كأعمدة حتى تكون متاحة على هذا النحو في عناصر واجهة لوحة المعلومات

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