العمل مع معلمات لوحة المعلومات

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

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

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

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

إضافة معلمة إلى استعلام

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

لإضافة معلمة إلى استعلام:

1. ضع المؤشر في المكان الذي تريد وضع المعلمة فيه في الاستعلام.

2. انقر فوق إضافة معلمة لإدراج معلمة جديدة.

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

تحرير معلمة استعلام

لتحرير معلمة:

1. انقر إلى جانب اسم المعلمة. يظهر مربع حوار تفاصيل المعلمة ويتضمن خيارات التكوين التالية:

   • الكلمة الأساسية: الكلمة الأساسية التي تمثل المعلمة في الاستعلام. يمكن تغيير هذا فقط عن طريق تحديث النص مباشرة في الاستعلام.

   • اسم العرض: الاسم في محرر عامل التصفية. بشكل افتراضي، يكون العنوان هو نفس الكلمة الأساسية.

   • النوع: تتضمن الأنواع المدعومة السلسلة والتاريخ والتاريخ والوقت والرقم.

     • النوع الافتراضي هو String.
     • يسمح لك نوع البيانات الرقمي بتحديد بين عشري وأعداد صحيحة. النوع الرقمي الافتراضي هو عشري.

   • السماح بتحديدات متعددة: حدد خانة الاختيار للسماح للمستخدمين باختيار معلمات متعددة في وقت التشغيل.

     إشعار

     قد يتطلب هذا التحديد تغييرا إضافيا في الاستعلام. راجع السماح بتحديدات متعددة.

2. انقر فوق جزء آخر من واجهة المستخدم لإغلاق مربع الحوار.

تعيين قيمة معلمة افتراضية

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

السماح بتحديدات متعددة

يجب أن تتضمن الاستعلامات التي تسمح بتحديدات متعددة دالة ARRAY_CONTAINS في الاستعلام.

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

SELECT
  *
FROM
  samples.tpch.lineitem
WHERE array_contains(:parameter, l_quantity)

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

تطبيق معلمات نطاق التاريخ

يمكنك استخدام المعلمات لتعريف نطاق وإرجاع النتائج فقط داخل هذا النطاق. عند اختيار أحد أنواع المعلمات التالية، يمكنك إنشاء معلمتين تم تعيينهما بواسطة .min ولاحقات .max :

• نطاق التواريخ
• النطاق الزمني والتاريخ

يوضح المثال التالي استعلام SQL الذي ينشئ معلمة نطاق تاريخ تسمى date_param.

SELECT * FROM samples.tpch.lineitem
WHERE l_shipdate BETWEEN :date_param.min and :date_param.max

لإنشاء معلمة نطاق تاريخ:

1. انقر فوق إضافة معلمة.

2. انقر إلى جانب اسم المعلمة. أدخل الكلمة الأساسية واسم العرض. لا تقم بتضمين .min أو .max لاحقات.

3. اختر نطاق التاريخ أو التاريخ والنطاق الزمني كنوع.

4. إدراج عبارة WHERE تحدد النطاق في الاستعلام الخاص بك. لتعريف النطاق، استخدم عبارة BETWEEN مع .min .max وقيم. على سبيل المثال:

    WHERE date_col BETWEEN :date_param.min AND :date_param.max
   

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

المعلمات المستندة إلى الاستعلام

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

لإنشاء معلمة مستندة إلى الاستعلام، يقوم كاتب لوحة المعلومات بتنفيذ الخطوات التالية:

1. إنشاء مجموعة بيانات تقتصر مجموعة نتائجها على قائمة بقيم المعلمات المحتملة.
2. إنشاء استعلام مجموعة بيانات يستخدم معلمة.
3. تكوين عنصر واجهة مستخدم عامل تصفية على اللوحة التي تقوم بالتصفية على حقل وتستخدم معلمة.
   • يجب تعيين تكوينات الحقول لاستخدام الحقل مع القائمة المطلوبة لقيم المعلمات المؤهلة.
   • يجب تعيين تكوين المعلمات لتحديد قيمة معلمة.

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

إنشاء قائمة معلمات ديناميكية

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

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

إنشاء قائمة معلمات ثابتة

يمكنك إنشاء مجموعة بيانات ثابتة تتضمن فقط القيم التي تقوم بترميزها الثابت في مجموعة البيانات الخاصة بك. مثال على الاستعلام هو كما يلي:

SELECT
  *
FROM
  (
    VALUES
      ('MACHINERY'),
      ('BUILDING'),
      ('FURNITURE'),
      ('HOUSEHOLD'),
      ('AUTOMOBILE')
  ) AS data(available_choices)

إزالة معلمة استعلام

لإزالة معلمة، احذفها من الاستعلام.

معلمات عنصر واجهة المستخدم الثابتة

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

يستند المثال في هذا القسم إلى مجموعة بيانات تقوم بالاستعلامات عن samples.nyctaxi.trips الجدول. يرجع الاستعلام المتوفر مسافة كل رحلة ويصنف يوم الاستلام إما Weekday أو Weekend. تقوم معلمة الاستعلام بتصفية النتائج استنادا إلى ما إذا كان الاستلام قد حدث في يوم من أيام الأسبوع أو عطلة نهاية الأسبوع.

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

  WITH DayType AS (
    SELECT
      CASE
        WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
        ELSE 'Weekday'
      END AS day_type,
      trip_distance
    FROM samples.nyctaxi.trips
  )
  SELECT day_type, trip_distance
  FROM DayType
  WHERE day_type = :day_type_param

لإضافة معلمة عنصر واجهة مستخدم ثابتة إلى مرئيات:

1. إضافة عنصر واجهة مستخدم مرئية إلى لوحة معلومات المسودة.

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

3. انقر فوق إظهار عوامل التصفية. بالنسبة لمجموعات البيانات التي تتضمن معلمات، يظهر قسم Parameters في لوحة التكوين.

   

4. انقر فوق علامة الجمع إلى يمين عنوان المعلمات واختر معلمة من القائمة المنسدلة.

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

6. راجع لوحة المعلومات الخاصة بك.

   تظهر الصورة التالية عنصري واجهة مستخدم للتصور. يتم تكوين كل منها كم مدرج تكراري مع معلمة عنصر واجهة مستخدم ثابتة. يعرض المخطط على اليسار توزيع مسافات الرحلات للرحلات التي تبدأ في أيام الأسبوع، بينما يعرض المخطط على اليمين البيانات نفسها لعطلات نهاية الأسبوع. تستند كل من المرئيات إلى نفس مجموعة البيانات.

   

مقارنة البيانات باستخدام شرط عامل تصفية

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

يوسع المثال التالي الاستعلام السابق ليشمل شرط عامل تصفية حيث تكون قيمة المعلمة المحددة هي All، والتي لا تظهر في البيانات. يعمل الجزء الأول من شرط التصفية بنفس الطريقة كما في المثال السابق، التصفية للنتائج حيث day_type يكون إما Weekday أو Weekend. يتحقق الجزء الثاني من شرط عامل التصفية مما إذا تم تعيين المعلمة نفسها إلى قيمة معينة، في هذه الحالة All، التي لا تظهر في البيانات. عند تعيين القيمة الافتراضية لتلك المعلمة في محرر مجموعة البيانات، فإنك تتجاوز عامل التصفية بشكل فعال عندما لا Weekday يتم تمرير ولا Weekend كقيم.

WITH DayType AS (
  SELECT
    CASE
      WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
      ELSE 'Weekday'
    END AS day_type,
    trip_distance
  FROM
    samples.nyctaxi.trips
)
SELECT
  day_type,
  trip_distance
FROM
  DayType
WHERE
  day_type = :day_type_param
  OR :day_type_param = 'All'

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

يوضح GIF التالي كيف يمكنك إنشاء ثلاثة مخططات بسرعة من مجموعة البيانات التي تم إنشاؤها باستخدام هذا الاستعلام.

1. تم تكوين المخطط الأول لإظهار مجموعة بيانات Trip Distances by Day Type مع تعيين قيمة معلمة إلى Weekday.
2. استنساخ المخطط للحفاظ على كافة التكوينات المطبقة.
3. لإظهار بيانات الرحلات المأخوذة في عطلة نهاية الأسبوع، اضبط المعلمة الثابتة إلى نهاية الأسبوع.
4. استنساخ المخطط الجديد للحفاظ على كافة التكوينات المطبقة مسبقا.
5. قم بتعيين المعلمة في المخطط الجديد إلى الكل لإظهار إجمالي عدد الرحلات حسب المسافة لرحلات نهاية الأسبوع وأسبوع الأسبوع.

إظهار المعلمات على لوحة المعلومات

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

لإضافة معلمة إلى لوحة المعلومات:

1. انقر فوق إضافة عامل تصفية (حقل/معلمة).
2. انقر بجوار Parameters في لوحة التكوين.
3. انقر فوق اسم المعلمة الذي تريد أن يستخدمه العارض مع عنصر واجهة المستخدم هذا.

العمل مع عناصر واجهة مستخدم التصفية والمعلمات الثابتة

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

يمكنك استخدام نمط مثل النمط في المثال التالي لتعيين القيم الاحتياطية لمعلمات مختلفة في نفس الاستعلام.

CASE WHEN :static_param != 'All' THEN :static_param ELSE :dash_param END

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

تضمين المعلمات في عنوان URL

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

معلمات لوحة المعلومات مقابل معلمات استعلام Mustache

تستخدم معلمات لوحة المعلومات نفس بناء الجملة مثل علامات المعلمات المسماة. راجع علامات المعلمات المسماة. لا تدعم لوحات المعلومات معلمات نمط الشارب.

أمثلة على بناء الجملة

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