توضيح دوال DAX المعرّفة من المستخدم: الفرق بين VAL وEXPR

By Mirko Peters · 2026-08-28

مرحبًا بعودتكم إلى المدونة المرافقة للبودكاست! في حلقتنا الأخيرة تعمّقنا في عالم دوال DAX المعرّفة من المستخدم (UDF) القوي. إذا كنتم تجرّبون دوال UDF في Power BI أو Analysis Services، فمن المرجّح أنكم تدركون أنها تغيّر قواعد اللعبة فعلًا في التخلص من تكرار الشيفرة ومركزة منطق الأعمال. غير أن الانتقال إلى النمذجة المتقدمة دون فهم دقيق لأوضاع المعاملات وصفةٌ مضمونة لأخطاء صامتة ونتائج إجمالية غير مت

Automatically translated with AI from the original post. Read the English original

مرحبًا بعودتكم إلى المدونة المرافقة للبودكاست! في حلقتنا الأخيرة تعمّقنا في عالم دوال DAX المعرّفة من المستخدم (UDF) القوي. إذا كنتم تجرّبون دوال UDF في Power BI أو Analysis Services، فمن المرجّح أنكم تدركون أنها تغيّر قواعد اللعبة فعلًا في التخلص من تكرار الشيفرة ومركزة منطق الأعمال. غير أن الانتقال إلى النمذجة المتقدمة دون فهم دقيق لأوضاع المعاملات وصفةٌ مضمونة لأخطاء صامتة ونتائج إجمالية غير متوقعة وانتهاءات مهلة مرهقة للاستعلامات. وللاطلاع على الشرح الصوتي الكامل والاستماع إلى أمثلة واقعية لهذه المفاهيم أثناء التطبيق، تأكدوا من الاستماع إلى الحلقة المرافقة على DAX UDF VAL vs EXPR: Prevent Timeouts and Wrong Totals.

في هذه المقالة سنتوسّع في الفروق الجوهرية بين وضعي المعاملات VAL وEXPR. وبحلول نهاية القراءة ستعرفون بدقة متى تلتقطون قيمة ثابتة، ومتى تستخدمون تعبيرًا ديناميكيًا يراعي السياق، وذلك للحفاظ على سرعة النماذج الدلالية ودقتها.

نظرة عامة على دوال DAX UDF

ما هي دوال DAX المعرّفة من المستخدم؟

تتيح لكم دوال DAX المعرّفة من المستخدم (UDFs) إنشاء عمليات حسابية مخصصة يمكن إعادة استخدامها عبر نماذج البيانات. فبدلًا من كتابة الصيغة نفسها عدة مرات، تعرّفونها مرة واحدة كدالة، ثم تستدعونها حيثما احتجتم إليها. يساعد هذا النهج على تنظيم عملكم والحفاظ على اتساقه.

فكّروا في دوال DAX UDF كلبنات بناء لتقاريركم. فهي تحتوي على المنطق، لذلك لا تحتاجون إلى تكرار أنفسكم. وهذا يوفّر الوقت ويقلّل الأخطاء. كما يمكنكم مشاركة هذه الدوال مع فريقكم، ما يجعل التعاون أسهل.

إليكم نظرة سريعة على ما يميّز دوال DAX UDF مقارنةً بالدوال المعرّفة من المستخدم الأخرى في تحليل البيانات:

أهمية دوال DAX UDF

يحسّن استخدام دوال DAX المعرّفة من المستخدم تطوير تقاريركم بطرق عديدة. أولًا، تجعل نماذجكم أنظف وأسهل في الصيانة. فعند تحديث دالة ما، تُحدَّث تلقائيًا جميع المقاييس التي تستخدمها. وهذا يقلّل احتمال الأخطاء ويحافظ على اتساق تقاريركم.

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

إليكم بعض الفوائد الرئيسية التي تكسبونها من استخدام دوال DAX UDF:

• تقلّل تكرار المنطق، ما يخفّض الأخطاء ويوفّر الوقت.
• تتيح لكم تحديث قواعد الأعمال في مكان واحد، لتنعكس التغييرات في كل مكان.
• تحسّن التعاون عبر توفير مكتبة مشتركة من الدوال لفريقكم.
• تُبسّط تطوير التقارير وتقلّص الوقت اللازم لذلك بنسبة تصل إلى 70-80%.

مقارنةً بصيغ DAX التقليدية، يمكن لدوال DAX UDF أيضًا أن تحسّن الأداء بشكل ملحوظ. فعلى سبيل المثال، تُظهر بعض الاختبارات أن دوال UDF خفّضت زمن الحساب من أكثر من 6000 ميلي ثانية إلى ما يزيد قليلًا على 160 ميلي ثانية، أي بتحسّن نسبته 97%.

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

توقفوا عن استخدام دوال DAX UDF بشكل خاطئ: الأخطاء الشائعة

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

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

إليكم بعض المزالق الشائعة المتعلقة بأنواع البيانات:

• يخلط المستخدمون كثيراً بين التنسيقات الرقمية والنصية.
• قد لا يدركون أن DAX يتعامل مع التواريخ كأرقام، وهو ما قد يعقّد الحسابات.
• يمكن أن يؤدي سوء استخدام أنواع البيانات إلى تراجع أداء النموذج، ما يبطئ التقارير.

استخدام بناء الجملة بشكل غير صحيح

تُعد أخطاء بناء الجملة مشكلة شائعة أخرى عند العمل مع دوال DAX المعرّفة من المستخدم (UDFs). قد يؤدي خطأ بسيط في الشيفرة إلى توقف تنفيذ العمليات الحسابية. عند ارتكاب خطأ في بناء الجملة، يعرض DAX رمز تحذير أصفر في محرر التعبيرات. يشير هذا الرمز إلى وجود خلل ما، لكنه لا يوضح دائماً طبيعة المشكلة بدقة.

فيما يلي بعض أخطاء بناء الجملة الشائعة التي ينبغي تجنبها:

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

قد تؤدي هذه الأخطاء إلى الإحباط وإهدار الوقت. تحقّق دائماً من بناء الجملة قبل تنفيذ تعبيرات DAX.

تجاهل معالجة الأخطاء

تُعد معالجة الأخطاء أمراً بالغ الأهمية للحفاظ على موثوقية دوال DAX المعرّفة من المستخدم. يغفل كثير من المستخدمين هذا الجانب، ما قد يؤدي إلى فشل الحسابات. على سبيل المثال، إذا تلقّت دالة نوع إدخال غير متوقع، فقد تعيد خطأً بدلاً من نتيجة مفيدة.

للحد من هذه المشكلات، فكّر في تطبيق الاستراتيجيات التالية:

• استخدم الدالة IFERROR() لتوفير قيمة بديلة. يمنع ذلك الأخطاء من تعطيل مرئياتك.
• استخدم ISBLANK() للتحقق من القيم الفارغة فعلياً، والتمييز بينها وبين الصفر أو السلاسل النصية الفارغة.
• طبّق COALESCE() لإرجاع أول قيمة غير فارغة من قائمة تعبيرات.

يمكنك أيضاً تعريف دوال تتحقق من أنواع المدخلات. على سبيل المثال، استخدم ISSTRING() للتأكد من أن المدخل نص. إذا لم يكن كذلك، فأرجِع BLANK(). يضمن هذا الأسلوب أن تظل حساباتك متينة وموثوقة.

بتجنب هذه الأخطاء الشائعة، يمكنك تحسين دوال DAX المعرّفة من المستخدم ورفع أداء نموذج البيانات بشكل عام. تذكّر أن فهم كيفية استخدام VAL وEXPR بشكل صحيح هو مفتاح الاستفادة الكاملة من دوال DAX المعرّفة من المستخدم.

فهم دالة VAL في DAX

الغرض من VAL

تؤدي دالة VAL في DAX غرضاً محدداً، إذ تحوّل تمثيلاً نصياً لرقم إلى قيمة رقمية فعلية. تُعد هذه الدالة ضرورية عند العمل مع بيانات قد تأتي بتنسيقات مختلفة. فعلى سبيل المثال، إذا تلقّيت رقماً كنص من مصدر بيانات، يمكنك استخدام VAL لتحويله إلى تنسيق رقمي قابل للاستخدام. يتيح هذا التحويل تنفيذ العمليات الحسابية بدقة.

ينبغي استخدام VAL في الحالات التالية:

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

بناء جملة VAL

بناء جملة الدالة VAL بسيط ومباشر:

VAL(<text>)

• <text>: يمثل هذا الوسيط سلسلة النص المراد تحويلها إلى رقم. يمكن أن يكون إدخالاً نصياً مباشراً أو مرجعاً إلى عمود يحتوي على قيم نصية.

إليك مثالاً بسيطاً على كيفية استخدام الدالة VAL:

SalesAmount = VAL('Sales'[SalesText])

في هذا المثال، تحوّل الدالة النص الموجود في العمود 'SalesText' إلى قيمة رقمية، ما يتيح إجراء العمليات الحسابية عليها.

أمثلة على استخدام الدالة VAL

لنستعرض بعض الأمثلة العملية على استخدام الدالة VAL في DAX.

1. التحويل الأساسي: لنفترض أن لديك عموداً باسم 'RevenueText' يحتوي على أرقام الإيرادات كنص. يمكنك إنشاء مقياس لتحويل هذه القيم إلى أرقام:

   TotalRevenue = SUMX('Sales', VAL('Sales'[RevenueText]))

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

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

   SalesTarget = VAL(UserInput[TargetText])

   يضمن هذا أن تكون الحسابات المبنية على هدف المبيعات صحيحة.

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

   AdjustedSales = IF(ISERROR(VAL('Sales'[SalesText])), 0, VAL('Sales'[SalesText]))

   في هذا المثال، إذا فشل التحويل، يعيد المقياس القيمة 0 بدلاً من التسبب في حدوث خطأ.

بفهم الغرض من الدالة VAL والاستخدام الصحيح لها، يمكنك تحسين دوال DAX المعرّفة من المستخدم. تتيح لك هذه المعرفة التعامل مع البيانات بفعالية أكبر، وتضمن أن تحقق حساباتك نتائج دقيقة.

فهم دالة EXPR في DAX

الغرض من EXPR

يلعب نمط المعامل EXPR في DAX دورًا محوريًا عندما تريد أن تستجيب دوالك المعرّفة من قِبل المستخدم ديناميكيًا للتغييرات في نموذج البيانات. على عكس VAL، الذي يلتقط قيمة ثابتة وقت استدعاء الدالة، يتيح لك EXPR تمرير تعبير يُحتسب في كل مرة تعمل فيها الدالة. وهذا يعني أن حساباتك يمكن أن تتكيف تلقائيًا مع سياقات التصفية أو سياقات الصفوف المختلفة.

ينبغي عليك استخدام EXPR عندما تحتاج دالتك إلى الاستجابة لظروف بيانات متغيرة. فعلى سبيل المثال، إذا أردت احتساب مقياس يعتمد على التصفية الحالية أو اختيار أداة التقطيع، يتيح لك EXPR تمرير هذا المنطق كتعبير. هذه المرونة تجعل دوالك المعرّفة من قِبل المستخدم أكثر قوة وإدراكًا للسياق.

نصيحة: استخدم EXPR لإنشاء حسابات ديناميكية تُحدَّث بناءً على تفاعلات المستخدمين أو مرشحات البيانات. يساعدك ذلك على بناء تقارير تعكس رؤى فورية.

بناء جملة EXPR

يتطلب بناء جملة استخدام EXPR في دوال DAX المعرّفة من قِبل المستخدم أن تُعلن المعامل كتعبير. هذا هو الشكل العام:

DEFINE FUNCTION MyFunction(EXPR paramName AS EXPRESSION)
RETURNS <return_type>
AS
BEGIN
    RETURN <calculation_using paramName>
END

• paramName: اسم المعامل الذي سيستقبل التعبير.
• EXPRESSION: يحدد أن المعامل يتوقع تعبيرًا بدلًا من قيمة ثابتة.

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

أمثلة على استخدام EXPR

لنلقِ نظرة على بعض الأمثلة العملية لفهم كيفية عمل EXPR في دوال DAX المعرّفة من قِبل المستخدم.

1. مثال على التصفية الديناميكية

لنفترض أنك تريد إنشاء دالة تحسب إجمالي المبيعات، مع السماح بتمرير تعبير تصفية بشكل ديناميكي:

DEFINE FUNCTION TotalSalesWithFilter(EXPR FilterExpression AS EXPRESSION)
RETURNS DECIMAL
AS
BEGIN
    RETURN CALCULATE(SUM(Sales[Amount]), FilterExpression)
END

عند استدعاء هذه الدالة، يمكنك تمرير تعبيرات تصفية مختلفة:

TotalSalesWithFilter(FILTER(Sales, Sales[Region] = "West"))

يحسب هذا الاستدعاء إجمالي المبيعات لمنطقة الغرب فقط. تُحتسب دالة التصفية في كل مرة، متكيفةً مع السياق الذي تقدمه.

1. حساب حساس للسياق

يمكنك أيضًا استخدام EXPR لتمرير مقياس أو حساب يعتمد على سياق الصف أو السياق الحالي للتصفية:

DEFINE FUNCTION CalculateMargin(EXPR SalesExpr AS EXPRESSION, EXPR CostExpr AS EXPRESSION)
RETURNS DECIMAL
AS
BEGIN
    RETURN SalesExpr - CostExpr
END

استدعاء هذه الدالة بتعبيرات مثل SUM(Sales[Amount]) وSUM(Sales[Cost]) يتيح لك احتساب الهامش ديناميكيًا بناءً على عوامل التصفية الحالية.

1. استخدام EXPR مع CALCULATE

غلّف دائمًا معاملات EXPR داخل CALCULATE عندما تريد فرض انتقالات السياق. هذا يضمن احتساب التعبير بشكل صحيح في سياق التصفية المطلوب.

ملاحظة: إساءة استخدام EXPR عبر تمرير قيم ثابتة أو عدم تغليف التعبيرات داخل CALCULATE قد يؤدي إلى نتائج غير متوقعة.

بإتقانك لاستخدام EXPR في دوال DAX المعرّفة من قِبل المستخدم، تكتسب القدرة على كتابة حسابات مرنة وواعية بالسياق. تساعدك هذه المهارة على بناء تقارير تستجيب بدقة لاختيارات المستخدمين وتغيرات البيانات.

أفضل الممارسات لدوال DAX المعرّفة من قِبل المستخدم

نصائح للاستخدام الفعّال

لتحسين دوال DAX المعرّفة من قِبل المستخدم، اتبع أفضل الممارسات التالية:

• كن حذرًا من مشكلات انتقال السياق عند استخدام معاملات EXPR. قد تؤدي انتقالات السياق إلى نتائج غير متوقعة إذا لم تُدَر بشكل صحيح.
• استخدم CALCULATE للسيناريوهات المعقدة. تساعد هذه الدالة على إدارة سياقات الجداول بفعالية، مما يضمن أن تعكس حساباتك المنطق المقصود.
• ركّز على التطوير المعياري. قسّم المنطق المعقد إلى أجزاء قابلة للإدارة. يبسّط هذا النهج الصيانة ويحسّن الأداء.
• وحّد منطق العمل عبر الفرق. يعزز الاتساق في طريقة تعريفك للدوال واستخدامها التعاون ويقلل التكرار.
• احسب المنطق في مكان واحد. تتيح لك هذه الممارسة تحسين الأداء وقابلية الصيانة من خلال تحديث المنطق دون بحث مطوّل في كل مكان.

سيناريوهات شائعة وحلول

فهم متى تستخدم VAL وEXPR يمكن أن يعزز بشكل كبير دوال DAX المعرّفة من قِبل المستخدم. إليك بعض السيناريوهات الشائعة:

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

إليك أمثلة محددة توضح هذه النقاط:

1. في دالة BestCustomers، يتيح استخدام معاملات EXPR تقييم المقياس لكل عميل، مما يُنتج نتائج دقيقة.
2. عند استخدام معاملات VAL، تحسب الدالة المقياس مرة واحدة فقط. قد يؤدي ذلك إلى نتائج غير صحيحة أو فارغة إذا تغيّر سياق التقييم.
3. تُعد الحاجة إلى تحويلات السياق أمرًا بالغ الأهمية. يمكن التحكم في معاملات EXPR صراحةً باستخدام CALCULATE لضمان التقييم الصحيح.

بتطبيق أفضل هذه الممارسات، يمكنك تبسيط الصيانة وتحسين الأداء في دوال DAX المعرّفة من قِبل المستخدم. لا يعزز هذا النهج حساباتك فحسب، بل يسهم أيضًا في الكفاءة طويلة الأمد لنماذج البيانات لديك.

في هذه المدونة، تعرّفت على أهمية VAL وEXPR في دوال DAX المعرّفة من قِبل المستخدم. يساعدك فهم هذين المفهومين على تجنب الأخطاء الshائعة وتعزيز نماذج البيانات لديك.

• VAL يلتقط القيم الثابتة، بينما يتيح EXPR إجراء حسابات ديناميكية.
• يؤدي الاستخدام السليم لهذه الدوال إلى تحسين الدقة والأداء.

بتطبيق هذه المعرفة، يمكنك إنشاء دوال DAX UDF أكثر فاعلية. ابدأ بتطبيق هذه الممارسات اليوم لرفع مستوى مهاراتك في تحليل البيانات! 🚀 لا تنسَ الاطلاع على الحلقة ذات الصلة للحصول على شرح صوتي كامل ونقاش حول DAX UDF VAL vs EXPR: Prevent Timeouts and Wrong Totals.

الأسئلة المتداولة

ما الفرق بين VAL وEXPR في DAX؟

تلتقط VAL قيمة ثابتة وقت استدعاء الدالة، بينما تُقيّم EXPR تعبيرًا بشكل ديناميكي، فتتكيف مع التغييرات في عامل التصفية أو سياق الصف.

متى ينبغي أن أستخدم VAL؟

استخدم VAL عندما تحتاج إلى قيمة رقمية ثابتة. وهي مثالية للسيناريوهات التي لا يتغير فيها الإدخال تبعًا للسياق، مثل العتبات.

متى يكون EXPR الخيار الأفضل؟

اختر EXPR عندما تحتاج حساباتك إلى الاستجابة لتغيّر ظروف البيانات. فهو يتيح تقييمات ديناميكية بناءً على تفاعلات المستخدم أو عوامل التصفية.

هل يمكنني الجمع بين VAL وEXPR في الدالة نفسها؟

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

كيف يمكنني تحسين أداء DAX UDF الخاص بي؟

لتحسين الأداء، قلّل الحسابات المعقدة داخل الدوال. استخدم VAL للقيم الثابتة، ولفّ تقييمات EXPR داخل CALCULATE لإدارة تحويلات السياق بفعالية.

ما الأخطاء الشائعة التي ينبغي أن أتجنبها مع DAX UDF؟

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

هل توجد طريقة لاختبار DAX UDF الخاصة بي؟

نعم، يمكنك اختبار دوال DAX UDF عبر إنشاء تقارير نموذجية أو باستخدام DAX Studio. يتيح لك ذلك تقييم الأداء والتأكد من دقة الحسابات.

أين يمكنني العثور على مزيد من المصادر حول DAX UDF؟

يمكنك العثور على مصادر إضافية حول DAX UDF في الوثائق الرسمية من Microsoft، والدورات التدريبية عبر الإنترنت، ومنتديات المجتمع. توفر هذه المنصات رؤى وأمثلة قيّمة.