مستكشف بيانات ديستورس

[Discourse]

	الملخص	يسمح لك مستكشف بيانات Discourse بإجراء استعلامات SQL على قاعدة البيانات المباشرة، مما يتيح لك تقارير إحصائية محدّثة لحظيًا.
	دليل التثبيت	هذا المكوّن الإضافي مُضمّن في نواة Discourse. لا حاجة لتثبيت المكوّن الإضافي بشكل منفصل.

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

الدعم خطأ تجربة المستخدم ميزة

إذا كنت تبحث عن أمثلة أو دعم لأي استعلامات مخصصة، يمكنك العثور على العديد من المواضيع في فئة #تقارير-البيانات تحت وسم #استعلام-sql. إذا لم تجد موضوعًا يناسب احتياجاتك الخاصة، فلا تتردد في إنشاء موضوع جديد لطلب المساعدة من المجتمع. مساعدة الاستعلام

مستضاف من قبلنا؟ هذا المكوّن الإضافي متاح في خطط الأعمال والمؤسسات لدينا. Data Explorer | Discourse - Civilized Discussion

بعد تثبيت المكوّن الإضافي، انتقل إلى /admin/plugins.

انقر على زر “الإعدادات”، وقم بتفعيل data explorer enabled (مستكشف البيانات مفعّل)، ثم أعد التحميل. يجب أن يظهر الآن علامة تبويب في شريط التنقل المتراكم باسم “مستكشف البيانات”. اختره أو انتقل إلى /admin/plugins/discourse-data-explorer، ثم استخدم أزرار +، أو استيراد، أو تشغيل للبدء.

الاستعلامات الافتراضية

في التثبيت الجديد، يأتي مستكشف البيانات مع عدة استعلامات يمكن أن تساعدك على استخلاص رؤى من نشاط المنتدى الخاص بك. افتح أي استعلام وانقر على تشغيل لتجربته.

إليك كيف تبدو الاستعلامات الافتراضية.

ملاحظة: يتم جلب الاستعلامات الافتراضية من هذا الملف: discourse-data-explorer/lib/discourse_data_explorer/queries.rb at main · discourse/discourse-data-explorer · GitHub

إذا كان لديك استعلام رائع تريد أن يتوفر للجميع، قم بإنشاء طلب دمج (PR) مثل هذا الطلب.

لا يمكن تعديل الاستعلامات الافتراضية، يمكنك نسخ كود SQL ولصقه في استعلام جديد إذا رغبت في تعديله.

كتابة الاستعلامات

عند النقر على أي من أزرار تعديل في عرض الاستعلام، أو بدء استعلام مستكشف جديد، ستظهر لك شاشة تشبه الشاشة أدناه:

الصندوقان العلويان هما اسم الاستعلام ووصفه. الاسم هو ما تختاره من مربع القائمة المنسدلة، ويجب استخدام الوصف لأغراض مثل شرح ما يجب إدخاله في معاملات الاستعلام أو لوصف البيانات التي يتم استعلامها.

اللوحة اليسرى هي المكان الذي تكتب فيه استعلام SQL. يتم توفير تمييز صياغة بسيط وفحص للأخطاء.

يقع مستكشف المخطط (schema explorer) على الجانب الأيمن من لوحة الكتابة. لاحظ أسماء الأعمدة الحمراء التي تحتوي على رمز تحذير، مثل email، password_hash، salt - هذه أعمدة “حساسة”. حاول تجنب استعلامها إذا أمكن، وأعد النظر في استعلامها إذا كنت في مكان عام، ولا تنشر بالتأكيد لقطات شاشة للاستعلامات التي تتحقق من هذه الأعمدة دون التفكير في ما تفعله أولاً.

تشغيل الاستعلامات تلقائيًا

بينما يمكنك دائمًا تشغيل استعلام بالنقر على زر تشغيل، يمكنك توفير الوقت عند تحميل استعلام عن طريق إضافة المعلمة run إلى عنوان URL.

على سبيل المثال: /admin/plugins/discourse-data-explorer/queries/123?run

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

استيراد الاستعلامات

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

most-common-likers.dcquery (1).json (442 Bytes)

يبدو أن جميع مطوري Discourse يحبون بعضهم كثيرًا

البحث عن الاستعلامات

إذا قمت بتجميع الكثير من الاستعلامات الرائعة، فلا مشكلة! يمكن لشريط البحث مساعدتك في تصفية النتائج بناءً على العناوين والوصوف.

السماح لمجموعات غير الموظفين بتشغيل الاستعلامات

يمكنك إضافة مجموعات محددة (بما في ذلك المشرفون) إلى استعلام لمنحهم الوصول إليه:

بعد الحفظ، يمكنك العثور عليه من صفحة المجموعات لتلك المجموعة المحددة في علامة التبويب التقارير:

انقر على أي استعلام لفتحه، ثم انقر على زر تشغيل لرؤية النتائج. يمكنك أيضًا حفظ تقارير المجموعة بالنقر على زر إشارة مرجعية.

مشاركة الاستعلامات بمعاملات محددة مسبقًا

إذا قمت بتضمين معاملات محددة من المستخدم في استعلامك، يمكنك مشاركة رابط للاستعلام وتضمين المعاملات في عنوان URL بحيث يتم تعبئتها مسبقًا عند تحميل الصفحة.

يجب أن تتضمن المعاملات في عنوان URL بالتنسيق التالي params={"parameter_name":"value"}. افصل بين المعاملات المتعددة بفواصل. على سبيل المثال:

discourse.example.com/g/my-group/reports/6?params={"param1":"value1","param2":"value2"}

بالاقتران مع معلمة run المذكورة أعلاه، يمكنك مشاركة تقرير بمعاملات محددة مسبقًا يعمل تلقائيًا عند التحميل.

حدود النتائج وتصدير الاستعلامات

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

إذا كنت تريد تجاوز هذا الحد، لديك بعض الخيارات:

1. التصفح (Pagination): يمكنك تصفية نتائجك. بدلاً من محاولة إرجاع جميع النتائج دفعة واحدة، يمكنك كتابة استعلامك لإرجاع نطاق محدد من النتائج. يمكنك بعد ذلك تعديل هذا النطاق لعرض أقسام مختلفة من بياناتك. لن يزيد هذا من الحد، لكنه سيسمح لك بعرض جميع بياناتك على أقسام.
2. زيادة الحد: إذا كان لديك وصول إلى خادم Discourse ومريح من إجراء تغييرات على إعدادات Discourse، يمكنك زيادة الحد. ومع ذلك، يجب القيام بذلك بحذر. يمكن أن يزيد الحد من الحمل على خادمك إذا لم تكن حذرًا، خاصة إذا كان مستخدمون متعددون يشغلون استعلامات كبيرة في نفس الوقت.
3. تنزيل النتائج: لديك أيضًا خيار تنزيل نتائج الاستعلام بدلاً من عرضها مباشرة في Discourse عن طريق النقر على زر JSON أو CSV بعد تشغيل الاستعلام. ستحتوي البيانات التي تم تنزيلها من استعلام بتنسيق JSON أو CSV على حد نتائج أعلى بكثير وهو 10,000 صف. للأغراض البرمجية، تريد اختيار تنسيق Json، أو إذا كنت ترغب في العمل على البيانات في تطبيق جدول بيانات، فقد يكون تنسيق CSV أكثر ملاءمة.

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

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

خطة الاستعلام

يمكن استخدام مربع الاختيار “تضمين خطة الاستعلام” لفهم استعلامات SQL وتحسينها بشكل أفضل.

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

سلسلة دروس مستكشف البيانات

لدينا أيضًا سلسلة مخصصة sql-tutorial حول مستكشف البيانات! إذا كنت مهتمًا بمعرفة المزيد حول كتابة استعلامات SQL في Discourse، نوصي بشدة بقراءة المواضيع في هذه السلسلة:

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

[HamMan2118]

مرحباً!

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

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

شكراً مقدماً!

[Arkshine]

مرحباً بريستون!

تسمح لك إضافة مستكشف البيانات بإنشاء استعلامات SQL.

تريد إنشاء استعلام جديد يسرد الموضوعات التي تبحث عنها.

بعد ذلك، عند تشغيل الاستعلام، سترى زر CSV لتصدير النتيجة إلى ملف CSV.

آمل أن يساعدك هذا!

أخبرنا إذا كنت بحاجة إلى مساعدة إضافية في إنشاء الاستعلام!

[HamMan2118]

شكرا لك! سأمرر ذلك :عناق:

[gormus (Osman Görmüş)]

مرحباً، لدي طلب ميزة لهذا المكون الإضافي الرائع.

ستكون بعض التقارير التي أنشئها باستخدام مستكشف البيانات مفيدة جدًا لفريقي إذا كان بإمكاني إدراجها في صفحة تقارير لوحة المعلومات (/admin/reports).

هل سيكون من الممكن إضافة خيار لكل استعلام في مستكشف البيانات ليتم إدراجه في صفحة التقارير؟ شكراً.

على سبيل المثال:

• إدراج هذا الاستعلام المخصص في صفحة التقارير

[kOS (KilianS)]

شكراً على هذه الميزة!

أنا أستكشف كيف يمكننا كتابة مقاييس مخصصة. نحن نستخدم Discourse جنبًا إلى جنب مع Workadvent.re (أداة تعاون ثنائية الأبعاد قائمة على الصور الرمزية).
أقوم بتشغيل نص برمجي مخصص هناك لكتابة الأنشطة في ورقة Google عبر خطاف ويب. للحصول على كل الأشياء مركزية في أداتنا الأساسية (Discourse)، سيكون من الرائع طباعة هذه البيانات في Discourse…
أي نصائح؟!

[davidgs (David G. Simmons)]

كنت آمل حقًا أن يكون هناك مُنشئ استعلامات يساعد في كتابة SQL. لغة SQL لدي قديمة وصدئة، وكتابتها يدويًا عرضة للأخطاء وتستغرق وقتًا طويلاً. سيكون من الرائع لو كانت هناك طريقة أسهل!

[Tris20 (Tristan)]

مرحباً @davidgs، أهلاً بك في Meta

@davidgs

كنت آمل حقًا أن يكون هناك مُنشئ استعلامات يساعد في كتابة SQL.

هل جربت استخدام LLM مثل ChatGPT؟ لديه فهم معقول لـ Discourse وكان موثوقًا به إلى حد معقول عندما احتجت أيضًا إلى إجراء استعلامات مستكشف البيانات.

غالبًا ما أكتب مطالباتي مثل “اكتب استعلام مستكشف بيانات Discourse يُرجع x، y، z من a، b، c حيث …” وينتهي بي الأمر بشيء معقول جدًا.

في الجزء العلوي الأيمن من هذه الصفحة، قد ترى أيضًا أيقونة روبوت صغيرة مثل أدناه.

إذا كان الأمر كذلك، يمكنك أيضًا تجربة مساعد الذكاء الاصطناعي المدمج في Meta.

[Jagster (Jakke Flemming)]

@Tris20

في الجزء العلوي الأيمن من هذه الصفحة قد ترى أيضًا أيقونة روبوت صغيرة مثل أدناه

معظمنا لا يراها. ولكن هناك دائمًا ask.discourse.com

[Tris20 (Tristan)]

@Jagster

معظمنا لا يراها. ولكن هناك دائمًا ask.discourse.com

نعم، لم أكن متأكدًا مما إذا كان هذا لا يزال مجرد شيء خاص بمستوى الثقة 3 أم لا. استدعاء جيد لموقع ask.discourse.com.

كمثال مرجعي، قمت بإدخال اكتب استعلام مستكشف بيانات Discourse يُرجع قائمة بجميع المستخدمين الذين قالوا كلمة "software" في شريط إدخال النص في ask.discourse.com وحصلت على الاستعلام التالي:

SELECT 
    p.user_id, 
    u.username,
    COUNT(p.id) AS post_count
FROM 
    posts p
JOIN 
    users u ON u.id = p.user_id
WHERE 
    p.raw ILIKE '%software%'
GROUP BY 
    p.user_id, u.username
ORDER BY 
    post_count DESC;

معقول جدًا. يمكنني أيضًا أن أشهد على أنه يقوم باستعلامات أكثر تعقيدًا بكثير من هذا.

[GuidoD (Guido Drehsen)]

يبدو أن تصدير البيانات من مستكشف البيانات لم يعد يعمل مع آخر تحديثات Discourse ومستكشف البيانات التي قمت بتثبيتها قبل حوالي ساعتين. يتم إنشاء البيانات بشكل جيد ولكن لم يعد من الممكن تصديرها.

النقر على أزرار JSON أو CSV يؤدي فقط إلى وميض قصير ولا يحدث شيء آخر. لقد عمل بشكل جيد قبل أسبوعين تقريبًا.

في وحدة تحكم متصفح الويب، أرى الخطأ التالي:
CSV:

Uncaught TypeError: this.args.query is undefined
    _downloadResult query-result.js:310
    downloadResultCsv query-result.js:287
    _triggerAction d-button.gjs:160
    Ember 12
    _triggerAction d-button.gjs:157
    click d-button.gjs:106

JSON:

Uncaught TypeError: this.args.query is undefined
    _downloadResult query-result.js:310
    downloadResultJson query-result.js:283
    _triggerAction d-button.gjs:160
    Ember 12
    _triggerAction d-button.gjs:157
    click d-button.gjs:106

[pento (Gary)]

شكراً على تقرير الخطأ، @GuidoD!

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

FIX: Query downloads were being passed an incorrect query object.

[GuidoD (Guido Drehsen)]

@pento

يرجى محاولة التحديث وتأكيد أنه يعمل لديك.

شكراً على الإصلاح السريع.
أؤكد أنه يعمل بشكل جيد مرة أخرى.

[GuidoD (Guido Drehsen)]

بالنسبة لكمية صغيرة من البيانات، يعمل كل من التصدير إلى JSON و CSV بشكل جيد. ولكن بالنسبة لكمية أكبر من البيانات، يعمل تصدير CSV بشكل جيد ولكن تصدير JSON يؤدي إلى خطأ 502 Bad Gateway في nginx (ربما بسبب انتهاء المهلة بعد 30 ثانية حيث يستغرق إنشاء ملف JSON وقتًا أطول من 30 ثانية).
هل هناك طريقة سهلة لزيادة قيمة انتهاء مهلة nginx؟

إذا قمت بتقليل الإطار الزمني للاستعلام، فإن ملف csv يبلغ حجمه 12.9 ميجابايت وملف json يبلغ حجمه 645 ميجابايت. يبلغ حجم ملف csv الإجمالي 13.5 ميجابايت، وهو أكبر قليلاً فقط، ولكن ملف json لا يتم إنشاؤه بسبب خطأ nginx.

أو ربما يفشل إنشاء ملف JSON بسبب بعض البيانات الغريبة. هل يقوم إنشاء ملف JSON بإنشاء ملف سجل؟

[riking (Kane York)]

تُشغَّل استعلامات JSON بحدٍّ خارجي أعلى بشكل افتراضي مقارنةً باستعلامات CSV. أضف ترقيم صفحات مخصصًا داخل الاستعلام لضمان اكتماله في الوقت المناسب.

[GregorSondermeier]

هل من الممكن تنفيذ عبارات UPDATE من مستكشف البيانات؟

أحاول إجراء تحديث جماعي لجدول معين، لكنني أحصل على هذا الخطأ:

PG::FeatureNotSupported: ERROR:  WITH query "query" does not have a RETURNING clause
LINE 29:   ) SELECT * FROM query

[riking (Kane York)]

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

إذا كنت تستضيف بنفسك، فاستخدم أحد أدلة “launcher enter”، مثل

Edit a user preference for everyone or a subset of users

This guide explains how to edit a user preference for everyone or a subset of users in Discourse. Required user level: System Administrator Console access is required. If you need to update the user preference for all of your users or a large subset of users, you can do so via the rails console. Summary In this guide, you’ll learn: How to access the Rails console for making bulk changes Examples of modifying user preferences How to identify se…

إذا كان لديك بالفعل تحديثك مصممًا، فيمكنك استخدام psql discourse بدلاً من rails c.

إذا كنت تستخدم خدمة مستضافة، فاتصل بالدعم ليقوموا بتنفيذ التغيير.

[GregorSondermeier]

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

[Naman_Gala]

إذا شاركت استعلام SQL مع مجموعة المشرفين، فكيف يمكن للمستخدمين في مجموعة المشرفين تشغيل الاستعلام من حساباتهم؟ لا يمكنهم رؤية المكون الإضافي لمستكشف البيانات.