دليل استكشاف البيانات - الجزء 1 - كتابة أول استعلام لك

[SaraDev (Sara Devlaeminck)]

هل ترغب في استخراج بعض البيانات من موقع Discourse الخاص بك ولكنك لست متأكدًا من أين تبدأ؟ لقد وصلت إلى المكان الصحيح! هذا دليل tutorial للمبتدئين الذين لم يتعاملوا مع مستكشف البيانات. إذا كنت على دراية بالفعل بـ SQL وكيفية استخدام مستكشف البيانات، فمن المحتمل أنك لن تحتاج إلى قراءة هذه المواضيع، وقد ترغب في التحقق من فئة Data & reporting الخاصة بنا بدلاً من ذلك.
الهدف من هذا الدليل هو مساعدتك في الحصول على فهم أساسي لكيفية استخدام مستكشف البيانات لإنشاء تقارير حول موقع Discourse الخاص بك، وهو الجزء الأول من سلسلة دروس مستكشف البيانات الخاصة بنا.

ما هو مستكشف البيانات؟

مستكشف البيانات هو مكون إضافي لـ Discourse يسمح لك بتشغيل استعلامات SQL على قاعدة بياناتك وتصدير النتائج. إنها أداة قوية لاستخراج وتحليل البيانات من موقع Discourse الخاص بك.

قبل أن تتمكن من استخدام مستكشف البيانات، ستحتاج إلى تثبيته على موقعك. راجع Install plugins on a self-hosted site إذا كنت بحاجة إلى أي مساعدة في هذا الشأن.

تم تثبيت مستكشف البيانات مسبقًا في خطط Business و Enterprise المستضافة من Discourse.

بمجرد تثبيت مستكشف البيانات، يمكنك البدء في استخدامه لتشغيل استعلامات SQL.

إنشاء أول استعلام SQL لدينا

أفضل طريقة للتعرف على مستكشف البيانات هي الحصول على بعض الخبرة العملية!

لنبدأ بإنشاء استعلامنا الأول:

1. انتقل إلى المسؤول على موقعك وانقر فوق علامة التبويب Plugins.
2. ابحث عن المكون الإضافي Data Explorer وانقر عليه.
3. انقر فوق الزر + لعرض مربع نص وزر لإنشاء استعلام SQL جديد.
4. اكتب اسم الاستعلام الخاص بك.
5. انقر فوق Create New لإنشاء الاستعلام.

من هنا يمكننا البدء في بناء استعلامنا الأول.

صفحة الاستعلام الجديد الافتراضية:

مرحبًا بالعالم

لأول استعلام لنا، لنقم بإنشاء تقرير يعرض لنا: المواضيع الأكثر مشاهدة على الموقع
بالتفكير في كيفية الحاجة إلى إنشائه، لنبدأ بتحديد حقلي title و views من جدول topics:

SELECT
    title, views
FROM 
    topics

والذي سيعرض لنا قائمة بجميع المواضيع على الموقع وعدد المشاهدات التي حصلت عليها. انقر فوق Run لرؤية هذا أثناء العمل:

فرز النتائج

بالنظر إلى هذه النتائج، ستلاحظ أنها غير مرتبة - هذا لأننا بحاجة إلى استخدام عبارة ORDER BY بشكل صريح لفرز نتائجنا كما هو مرغوب. لنضف هذا الآن:

SELECT
    title, views
FROM 
    topics
ORDER BY views DESC

لننقر فوق Run مرة أخرى لنرى ما تغير:

ها نحن ذا - تم فرز نتائجنا الآن بترتيب تنازلي حسب المشاهدات!

تنسيق النتائج

مع هذا الاستعلام، ألن يكون من الجيد لو تمكنا من النقر مباشرة على اسم الموضوع والانتقال إليه؟ من الجيد أننا نستطيع فعل ذلك باستخدام نتائج الجدول المنسقة!

لنغير قسم title في استعلامنا إلى id as topic_id لرؤية هذا أثناء العمل:

SELECT
    id as topic_id,
    views
FROM 
    topics
ORDER BY views DESC

الآن تم عرض عناوين المواضيع كروابط تشعبية!

الأرقام التي تراها بجوار الموضوع هي عدد الردود التي حصل عليها الموضوع.

إضافة المعلمات وبيانات WHERE

لإضافتنا النهائية إلى الاستعلام، لنعدل الاستعلام بحيث نعرض فقط المواضيع التي تحتوي على أكثر من X عدد من المشاهدات. للقيام بذلك، سنحتاج إلى إضافة معلمة وبيان WHERE. لمعلمتنا، سنستخدم int (عدد صحيح)، وسيتم استخدام بيان WHERE لتصفية النتائج بحيث يتم عرض المواضيع التي تحتوي على أكثر من الحد الأدنى لعدد المشاهدات فقط.

-- [params]
-- int :min_views= 10

SELECT
    id as topic_id,
    views
FROM 
    topics
WHERE views > :min_views
ORDER BY views DESC

عند تشغيل هذا الاستعلام، سترى الآن أن هناك معلمة min_views يمكنك استخدامها لتغيير الحد الأدنى لعدد المشاهدات التي تتطلبها المواضيع ليتم عرضها في النتائج.

خاتمة

نأمل أن تبدأ في الحصول على فكرة عن كيفية بناء استعلامات مستكشف البيانات بعد المرور بهذه الخطوات، ومع ذلك، بالكاد لمسنا السطح في هذا الموضوع!

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

مواضيع أخرى في هذه السلسلة

• هذا الموضوع
• برنامج تعليمي لمستكشف البيانات - الجزء 2 - أساسيات Discourse SQL
• استخدام المعلمات في استعلامات مستكشف البيانات
• تنسيق نتائج جدول مستكشف البيانات