Підручник з мови Power Query M та майстерність

У цьому підручнику буде обговорено, як успішно реалізувати частину коду M і вирішити типові помилки всередині . Ви також дізнаєтесь, як ефективно практикувати та опанувати .

Зміст

• Реалізація мови Power Query M
  • Параметр розташування файлу на мові Power Query M
• Поширені помилки в мові Power Query M
  • 1. Циклічне посилання
  • 2. Нерозпізнане ім'я
  • 3. Текстовий рядок
  • 4. Помилка невідповідності типу
  • 5. Ім'я не існує
  • 6. Лексема Кома
  • 7. Ідентифікатор маркера
  • Інші помилки в мові Power Query M
• Володіння мовою Power Query M
• Рекомендації щодо мови Power Query M
  • 1. Рядок формул
  • 2. Стандартна бібліотека
  • 3. Практика та повторення
• Висновок

Реалізація мови Power Query M

Успіх впровадження частини коду M залежить від того, наскільки добре ви можете вирішити будь-яку проблему, з якою ви стикаєтеся. У цьому підручнику ви дізнаєтеся про найпоширеніші помилки під час спроби перенести M- код з іншого файлу PBIX або під час спроби реалізувати фрагмент M- коду, який ви знайшли на форумі.

Але спочатку, якщо у вас є запитання щодо Power Query, важливо надати дані разом із файлом PBIX, оскільки для вирішення проблеми може знадобитися змінити налаштування даних. Ненадання даних призведе до помилки джерела даних з боку того, хто намагається надати вам підтримку, оскільки вони не мають доступу до джерела.

Існує спосіб обійти надання окремого файлу, але він застосовний лише до зразків із 3000 значеннями або менше в обох стовпцях і рядках. Отже, якщо ваша таблиця не перевищує обмеження в 3000 комірок, ви можете скопіювати її цілком і вставити у вікні «Створити таблицю», використовуючи параметр «Ввести дані». Дані будуть переведені в двійковий формат і вбудовані у файл.

Параметр розташування файлу на мові Power Query M

Ще один спосіб допомогти особі, яка надає вам підтримку, — це включити параметр розташування файлу. Щоб при оновленні файлу всі запити в ньому були відновлені. Щоб продемонструвати це, виконайте ці чотири кроки.

Спочатку перейдіть до Windows Explorer і скопіюйте шлях до файлу.

По-друге, повернутися доі виберіть «Керувати параметрами». Далі виберіть «Новий параметр» і дайте параметру назву.

По-третє, використовуйте імена без пробілів або спеціальних символів, щоб уникнути використання лапок, коли ви посилаєтеся на свої параметри. Встановіть Тип на Текст і Пропоновані значення на Список значень . Коли ви пропускаєте файл через форум, ви можете вибрати своє розташування зі списку файлів.

Нарешті, відкрийте вікно розширеного редактора та замініть жорстко закодований шлях до файлу назвою параметра.

Поширені помилки в мові Power Query M

1. Циклічне посилання

Наведений нижче вираз помилки виникає, коли вихідні дані вибраного запиту передаються в аргумент функції кроку в запиті. У цьому прикладі ви бачите, що ім’я запиту передається у функцію Table.AddColumn на одному з її кроків.

Для першого аргументу потрібен тип таблиці. У більшості випадків ви побачите, що він посилається на попередній крок у вашому коді. Попередній крок можна знайти на панелі «Застосовані кроки», розташованій праворуч на панелі попереднього перегляду.

Посилатися на попередній крок не потрібно; ви можете просто передати інше табличне посилання на цю функцію. Отже, у вихідному файлі знайдіть назву кроку на панелі «Застосовані кроки», щоб побачити форму таблиці, яка була передана функції. Це може допомогти вам перекласти крок у ваш власний файл.

2. Нерозпізнане ім'я

Ця помилка виразу виникає, коли ім’я аргументу таблиці, яке передано функції, не існує або було написане з помилкою.

Майте на увазі, що враховується регістр. У більшості випадків він посилається на попередній крок, який можна знайти на панелі «Застосовані кроки». Але знову ж таки, це не обов’язково.

Під час усунення несправностей цього типу помилок подивіться на форму таблиці, передану функції у вихідному файлі, і порівняйте її зі своїм власним файлом. Також переконайтеся, що кроки не перейменовано.

3. Текстовий рядок

Ця помилка виразу є прикладом того, що аргумент таблиці, переданий у функцію, насправді передається як текстовий рядок.

Назви кроків, які включають пробіли або спеціальні символи, повинні містити в лапках решетку або знак фунта. Імена повинні бути взяті в подвійні лапки. Під час копіювання та вставлення імен кроків завжди вибирайте повну назву.

4. Помилка невідповідності типу

Іншою поширеною помилкою виразу є помилка невідповідності типу.

Ці типи помилок зазвичай з’являються, коли ви починаєте вносити зміни в код M. У наведеному вище повідомленні про помилку значення дати й часу було передано функції, яка потребувала типу даних дати.

Рішенням цієї помилки є перетворення типу даних значення перед передачею його як аргументу іншій функції. У цьому випадку ви можете використовувати функцію Date.From , щоб перетворити значення datetime на значення дати.

Існує багато типів помилок невідповідності. У будь-якому випадку система завжди вкаже необхідний тип даних.

5. Ім'я не існує

Ще одна поширена помилка виразу – це коли ім’я посилання на стовпець, передане як аргумент функції, не існує або написане з помилкою.

Переконайтеся, що назви стовпців збігаються. Ви також можете спробувати змінити посилання на стовпець. Якщо назви стовпців збігаються, але помилка все одно з’являється, перевірте, чи є в імені пробіли або спеціальні символи.

6. Лексема Кома

Це синтаксична помилка виразу щодо Token Comma.

Подібно до того, як кожна функція отримує розділений комами список аргументів функції, вираз let приймає розділений комами список імен і значень змінних. Щоб усунути помилку такого типу, переконайтеся, що в кінці кожного кроку, окрім останнього, стоїть кома. Цю помилку також може спричинити відсутність закриваючих дужок або квадратних дужок у кінці функції.

7. Ідентифікатор маркера

Помилка «Очікуваний ідентифікатор маркера» зазвичай виникає, коли копіюється код M , оскільки знаки лапок збиваються.

Щоб виправити помилку, необхідно знайти та замінити всі знаки лапок. Ви також можете скористатися програмою Visual Studio Code, яку можна безкоштовно завантажити на code.visualstudio.com .

Інші помилки в мові Power Query M

Ось інші помилки, з якими ви можете зіткнутися під час впровадження коду M з форуму.

• Очікуваний літерал маркера – це означає, що наступним у формулі має бути значення, стовпець або функція.
• Очікується лексема RightParen Expected – це означає, що закриваюча дужка або кругла дужка повинні закрити формулу
• Кома не може передувати RightParen – це означає, що кома не може бути безпосередньо перед дужкою, що закривається, або дужкою.
• Недійсний літерал – часто трапляється, коли текстовий рядок не було закрито знаком подвійних лапок.
• Очікується маркер EoF – виникає, коли використовується недійсне ключове слово або назва функції.

Володіння мовою Power Query M

Майстерність вимагає довгострокових зобов’язань та інвестицій. Це все про те, щоб робити, надихатися, практикуватися та повторювати. Але навіть без майстерності ви можете досягти дивовижних поліпшень за відносно короткий період часу.

Якщо ви розумієте та можете застосувати концепції, розглянуті в цих публікаціях, на практиці, ви знатимете, як виправляти помилки, коли вони виникають. Ви також зможете пограти з параметрами функції, як-от заміна жорстко закодованих значень динамічними значеннями або написання власних М- функцій.

Все, що вам потрібно зробити, це почати досліджувати самостійно. Ви навчитеся найбільше, дозволяючи собі робити помилки, а потім знаходити кілька способів їх вирішення. Це може зайняти багато часу, але це також дуже корисно. Як тільки ви зможете це зробити, ви зможете відточити свою майстерність.

Рекомендації щодо мови Power Query M

1. Рядок формул

Одна із загальних найкращих практик щодо того, як ви можете розширити свої знання про Power Query, полягає в тому, щоб рядок формул завжди був видимим. Ви можете дослідити специфікацію мови формул, яка описує структуру мови, і повернутися до неї після певного часу практики.

Ви можете піти на полювання за сміттям, скориставшись онлайн-довідником формул, у якому перераховано всі функції та їхні характеристики. Ви можете прочитати їх, скопіювати приклади у вікно розширеного редактора та вивчити результати.

2. Стандартна бібліотека

Інша найкраща практика полягає в дослідженні стандартної бібліотеки за допомогою ключового слова #shared , оскільки існують відмінності порівняно з онлайн-посиланням на формули. Ви також можете шукати в Інтернеті інший вміст, наприклад практичні приклади чи проблеми, з якими стикалися інші.

Це часто називають навчанням за допомогою Google. Ви можете шукати назву функції або тип операції чи перетворення, але результати значною мірою залежатимуть від того, наскільки добре ви визначили критерії пошуку та наскільки добре інші описали свій випадок.

3. Практика та повторення

Найважливіше — потренуватися та свідомо проводити більше часу в редакторі запитів. Крім того, знайдіть кращий баланс між часом, який ви витрачаєте на вивчення DAX, візуалізації даних і коду M.

Ви також можете переглянути свою минулу роботу та застосувати ці найкращі практики. Беріть участь у таких заходах, як LuckyTemplates і . Розвивайте це, відповідаючи на запитання на форумі, щоб поглибити своє розуміння та закріпити знання.

Завжди буде ще чого вчитися та відкривати. Тож поставте перед собою мету, якої ви зможете досягти, наприклад приділяти 30 хвилин на день власному вивченню.

Висновок

Реалізація M у вашому коді вимагає практики та майстерності. Помилки можуть виникнути, якщо змінна, функція або будь-яка інша сутність використовується неправильно. Після правильного використання M ваш звіт із даними надасть цінні та змістовні результати.

Меліса