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

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

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

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

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

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

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

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

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

image-20240808-084010.png

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

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

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

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

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

image-20250213-212229.png

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

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

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

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

التعبير

الوصف

1234

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

NOT(NULL())

يطابق جميع الصفوف التي تكون فيها قيمة العمود غير NULL.

GE(0)

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

foo%

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

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

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

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

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

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

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

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

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

في علامة التبويب Data ، تكون جميع الجداول والعروض وما إلى ذلك الخاصة بمصدر البيانات المحدد مرئية. سيرى مستخدمو المشغّل (operator) الجداول المحددة بواسطة أذونات الكتابة فقط.

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

image-20250213-212333.png

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

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

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

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

انقر على أيقونة + بجوار مجموعة Tables لفتح مربع حوار Add table :

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

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

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

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

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

تعديل جدول موجود

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

تعديل المخطط

يمكن للمستخدمين المسؤولين فقط تعديل مخطط الجدول

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

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

الإعداد

الوصف

Table name

اسم الجدول

Primary key

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

Indices

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

Columns

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

تعديل البيانات

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

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

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

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

انقر على Save changes لحفظ البيانات بشكل دائم.

حذف جدول

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


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

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

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

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

image-20240808-095215.png

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

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

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

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

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

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

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

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

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

تُعد مصادر البيانات النصية البرمجية (Script DataSources) مهملة ويُنصح المستخدمون بعدم استخدامها

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

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

image-20240717-150657.png

المعامل

الوصف

Name

اسم مصدر البيانات. سيكون هذا الاسم متاحًا في إعدادات الأداة عندما يكون Search type مضبوطًا على dataSource. سيتم دائمًا تعيين Table على STDOUT:

Fetch executable

المسار المؤهل بالكامل للبرنامج أو النص البرمجي الذي ينشئ البيانات. يجب أن يكون هذا البرنامج متاحًا على النظام المثبت عليه خدمة ويب SKOOR

Fetch arguments

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

مثال: تمت تهيئة معامل عنوان URL display كـ Search query في أداة جدول:

يمكن الآن تمرير المعامل نفسه إلى النص البرمجي لمصدر البيانات بالإضافة إلى وسيطات أخرى، على سبيل المثال القيمة "123":

Fetch result pointer

إذا كانت هناك حاجة إلى مجموعة فرعية فقط من نتيجة سلسلة 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"
    }
  ]
}

سيتم عرض مصفوفة filesystems فقط على لوحة المعلومات. لذلك يجب تعيين مؤشر JSON /filesystems كـ fetch result pointer:

إذا كان يجب عرض جميع كائنات سلسلة JSON، فقم بتعيين مؤشر نتيجة الجلب (fetch result pointer) إلى "/".

Distinct executable

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

Distinct arguments

راجع fetch arguments

Distinct result pointer

راجع fetch result pointer

Columns

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