برنامج تعليمي لإتقان وإتقان Power Query M

سيناقش هذا البرنامج التعليمي كيفية تنفيذ جزء من التعليمات البرمجية M بنجاح وحل الأخطاء الشائعة داخل محرر Power Query . ستتعلم أيضًا كيفية التدرب على لغة M وإتقانها بشكل فعال في Power Query .

جدول المحتويات

• تطبيق لغة Power Query M
  • معلمة موقع الملف في Power Query M Language
• الأخطاء الشائعة في Power Query M Language
  • 1. مرجع دوري
  • 2. اسم غير معروف
  • 3. سلسلة نصية
  • 4. اكتب خطأ عدم التطابق
  • 5. الاسم غير موجود
  • 6. رمز فاصلة
  • 7. معرّف الرمز المميز
  • أخطاء أخرى في Power Query M Language
• إتقان اللغة M في Power Query
• أفضل ممارسات لغة Power Query M
  • 1. شريط الصيغة
  • 2. مكتبة قياسية
  • 3. الممارسة والمراجعة
• خاتمة

تطبيق لغة Power Query M

يعتمد نجاح تنفيذ جزء من كود M على مدى قدرتك على حل أي مشكلة تواجهها. في هذا البرنامج التعليمي ، ستتعرف على أكثر الأخطاء شيوعًا عند محاولة نقل رمز M من ملف PBIX آخر أو عند محاولة تنفيذ جزء من رمز M وجدته في المنتدى.

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

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

معلمة موقع الملف في Power Query M Language

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

أولاً ، انتقل إلى مستكشف Windows وانسخ مسار الملف.

ثانيًا ، ارجع إلى محرر Power Query وحدد إدارة المعلمة. بعد ذلك ، حدد معلمة جديدة وأدخل اسمًا للمعلمة.

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

أخيرًا ، افتح نافذة Advanced Editor واستبدل مسار الملف ذي الترميز الثابت باسم المعلمة الخاصة بك.

الأخطاء الشائعة في Power Query M Language

1. مرجع دوري

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

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

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

2. اسم غير معروف

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

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

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

3. سلسلة نصية

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

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

4. اكتب خطأ عدم التطابق

خطأ آخر شائع في التعبير هو خطأ عدم تطابق النوع.

تميل هذه الأنواع من الأخطاء إلى الظهور عند بدء إجراء تعديلات على رمز M. في رسالة الخطأ أعلاه ، تم تمرير قيمة التاريخ والوقت إلى دالة تتطلب نوع بيانات التاريخ.

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

هناك العديد من أنواع أخطاء عدم التطابق. مهما كانت الحالة ، سيحدد النظام دائمًا نوع البيانات المطلوب.

5. الاسم غير موجود

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

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

6. رمز فاصلة

هذا خطأ في بناء جملة تعبير حول الرمز المميز فاصلة.

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

7. معرّف الرمز المميز

عادةً ما يحدث الخطأ المتوقع لمعرف الرمز المميز عندما يتم نسخ رمز M لأن علامات الاقتباس تتلاشى.

لإصلاح الخطأ ، عليك البحث عن جميع علامات الاقتباس واستبدالها. يمكنك أيضًا استخدام تطبيق يسمى Visual Studio Code والذي يمكنك تنزيله مجانًا من code.visualstudio.com .

أخطاء أخرى في Power Query M Language

فيما يلي الأخطاء الأخرى التي من المحتمل أن تواجهها عند تنفيذ كود M من المنتدى.

• توقع Token Literal - هذا يعني أنه من المتوقع أن يكون الشيء التالي في الصيغة قيمة أو عمودًا أو دالة.
• توقع Token RightParen - هذا يعني أنه من المتوقع أن يغلق قوس الإغلاق أو الأقواس الصيغة
• لا يمكن أن تسبق الفاصلة A RightParen - وهذا يعني أنه لا يمكن للفاصلة أن تكون مباشرة أمام قوس إغلاق أو قوس إغلاق.
• حرفي غير صالح - يحدث غالبًا عندما لا يتم إغلاق سلسلة نصية بعلامة اقتباس مزدوجة.
• توقع رمز EoF المميز - يحدث عند استخدام كلمة رئيسية أو اسم وظيفة غير صالح.

إتقان اللغة M في Power Query

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

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

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

أفضل ممارسات لغة Power Query M

1. شريط الصيغة

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

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

2. مكتبة قياسية

أفضل ممارسة أخرى هي استكشاف المكتبة القياسية باستخدام الكلمة الأساسية #shared نظرًا لوجود اختلافات مقارنة بمرجع الصيغة عبر الإنترنت. يمكنك أيضًا إجراء بحث على الويب عن محتوى آخر مثل الأمثلة العملية أو المشكلات التي واجهها الآخرون.

يُشار إلى ذلك غالبًا باسم Learn by Googling. يمكنك البحث عن اسم الوظيفة أو نوع العملية أو التحويل ، لكن النتائج ستعتمد بشكل كبير على مدى جودة تعريفك لمعايير البحث ومدى وصف الآخرين لحالتهم.

3. الممارسة والمراجعة

أهم شيء هو التدرب وقضاء المزيد من الوقت عن عمد داخل محرر الاستعلام. يمكنك أيضًا العثور على توازن أفضل بين مقدار الوقت الذي تقضيه في تعلم DAX وتصورات البيانات ورمز M.

يمكنك أيضًا مراجعة عملك السابق ودمج أفضل الممارسات هذه. شارك في أنشطة مثل LuckyTemplates's و . قم بالبناء على ذلك من خلال الإجابة على الأسئلة في المنتدى لتعميق فهمك وترسيخ معرفتك.

سيكون هناك دائمًا المزيد لتعلمه واكتشافه. لذا حدد هدفًا يمكنك تحقيقه مثل تخصيص 30 دقيقة يوميًا لدراستك.

أفضل الممارسات لتحويل البيانات في
أفضل ممارسات تحميل وتحويل البيانات في محرر الاستعلام

خاتمة

يتطلب تنفيذ M في التعليمات البرمجية الخاصة بك الممارسة والإتقان. قد تحدث أخطاء إذا تم استخدام متغير أو وظيفة أو أي كيان آخر بشكل غير صحيح. بمجرد استخدام M بشكل صحيح ، سيوفر تقرير البيانات الخاص بك نتائج قيّمة وثاقبة.

ميليسا