Základní principy „M“ (jazyka pro práci s Power Query)

Tento článek popisuje nejzákladnější pravidla pro práci s jazykem M, který slouží k tvorbě dotazů v Power Query (Načíst a transformovat) v Excelu a stejně tak pro tvorbu dotazů v Power BI.

Jazyk M, upřímně řečeno, ani nemusíte znát pokud dotazy vytváříte – většinu věcí si naklikáte a do M kódu v pozadí si to Excel nebo Power BI přepíší sami. Tento článek je tedy spíše pro zvídavé nebo pro pokročilejší – kteří díky psaní kódu mohou zvládnout i něco, co naklikat nejde (příklady toho, co naklikat nejde viz tady).

Ještě než se pustím do konkrétních pravidel syntaxe, tak upozorňuji, že M rozlišuje mezi malými a velkými písmeny v názvech funkcí i proměnných – tedy když chcete napsat např. název funkce If, nesmíte napsat IF. To je trochu chyták, protože další jazyky, o kterých tady píšeme, takové fajnovky co se týká názvů funkcí nejsou. 

  • Běžné vzorce v Excelu můžete psát jakkoliv a Excel si názvy funkcí sám změní na všechna velká. Tedy např. „if“ se změní na „IF“.
  • DAX vás nechá napsat malá nebo velká písmena.
  • VBA si syntaxi samo upraví, ve funkcích obvykle na první velké písmena a ostatní malá.

Takže v Mku musíme dávat pozor na velikost písmenek. A dál?

Základ

Základní logika je vlastně jednoduchá. Zápis dotazu do dat má vždy dva bloky – „let“ a „in“. „Let“ je víceřádková definice proměnných, zatímco „in“ je výstup. Ano, „in“ je opravdu to, co jde ven – netvrdím, že to dává smysl…

Zápis tedy může vypadat třeba takto:

let
   my_variable = „hello world“
in
   my_variable

V našem příkladu bude výstupem „hello world“, tedy hodnota proměnné „my_variable“, která se objeví na výstupu. Pokud toto zapíšete nebo zkopírujete do rozšířeného editoru v Power Query nebo v Power BI, opravdu uvidíte na výstupu opravdu „hello wordl“.

Jenomže dotazy většinou nepíšeme proto, abychom zobrazovali „Hello world“. Takto tedy vypadá dotaz, který v původním zdroji vezme sloupec „Revenue“ a vydělí ho tisícovkou.

let
   Source = my_source,
   #“Divided Column“ = Table.TransformColumns(Source, {{„Revenue“, each _ / 1000, type number}})
in
   #“Divided Column“

Proměnné

Zjednodušeně lze říci, že každý řádek se nějak odvozuje z toho předchozího. Tedy poslední řádek (in) se jmenuje „Divided Column“ a počítá se ze Source pomocí funkce Table.TransformColumns. Source se počítá z „my_source“ a tak až na začátek, třeba i pro velké množství řádků.

Názvy kroků (nebo, chcete-li, proměnných), mohou být libovolné – pokud byste místo „Source“ psali „xy“, bude to fungovat také – jen to musíte použít jak v řádku, kde tato proměnná vzniká, tak v tom, kde je použitá. 

Pokud má proměnná více slov, pak je třeba dát jí do uvozovek a před ní psát křížek – tedy např.

  • xy

ale

  • #“x y“

Funkce

Funkce se volají tak, že se napíše jejich název, a jejich vstupy – např. takto:

  • Text.Start(„abcd“, 2)

vytáhneme z textu první dva znaky (obdoba funkce ZLEVA v Excelu).

Komentáře

Komentář, tedy část kódu, která nemá vliv na funkci, napíšete buď pro jeden řádek s dvojitým lomítkem:

  • // tady je můj komentář

nebo pro více řádků 

  • */ tady je můj
    komentář */

Tak asi tak… v kostce…