التوثيق

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

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

يمكن تكوين مصادر البيانات لجعل جداول أو عروض قاعدة البيانات متاحة في لوحات معلومات 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) لاستبدال جدول أو تحديثه. انقر فوق الزر "استيراد" لفتح مربع الحوار:

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

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

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

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