Die beste Power Query und M Dokumentation – PowerQuery.how

Eine gute Dokumentation ist unerlässlich, um in der IT effizient arbeiten zu können. Manchmal leistet ein Softwarehersteller gute Arbeit und manchmal gibt es Alternativen, die noch besser sind.

Schon lange gibt es mit dax.guide eine großartige alternative Dokumentation zu DAX, allerdings gab es bisher keine alternative Power Query Dokumentation – bis jetzt. Schon seit einigen Monaten gibt es eine wirklich gute Alternative zur offiziellen Power Query Dokumentation, sie heißt PowerQuery.how und um ganz ehrlich zu sein, bekommt sie nicht die Anerkennung, die sie verdient! Genau das versuche ich mit diesem Artikel zu ändern.

Aktueller Status der Power Query-Dokumentation

Vielleicht fragst du dich, was an der offiziellen M- bzw. Power Query-Dokumentation von Microsoft nicht stimmt. Und im Allgemeinen ist die Antwort: Nichts, die offizielle Dokumentation ist absolut in Ordnung. Sie zeigt alle Funktionen an und bietet eine umfassende Übersicht.

Allerdings macht es PowerQuery.how einfach besser! Im nächsten Kapitel werde ich darauf näher eingehen.

Was ist PowerQuery.how?

Wie bereits erwähnt, ist PowerQuery.how eine alternative Dokumentation neben der offiziellen Microsoft-Dokumentation. Sie wurde von unserem bekannten und geschätzten BI-Gorilla Rick de Groot entwickelt, einem absoluten Experten für Power Query!

Bessere Beispiele und Beschreibung der einzelnen Funktionen

Im Allgemeinen erklärt PowerQuery.how die Funktionen deutlich genauer und bietet viel ausführlichere Beispiele. Verwenden wir als Beispiel die Funktion Table.ReplaceValue aus dem Artikel “Ersetzung von bedingten Werte in einer Spalte in Power Query in einem Schritt“.

Table.ReplaceValue als Beispiel aus der Microsoft Dokumentation

Werfen wir zunächst einen Blick auf die Funktion in der offiziellen Microsoft-Dokumentation.

Die Syntax der Funktion und eine kurze Beschreibung finden wir im ersten Abschnitt. In der Beschreibung heißt es “Ersetzt oldValue durch newValue in den angegebenen Spalten der Tabelle”. Das ist eine kurze Zusammenfassung und die Syntax sagt uns, in welchem Format die Parameter sein müssen:

Table.ReplaceValue(table as table, oldValue as any, newValue as any, replacer as function, columnsToSearch as list) as table

Die ersten drei Parameter sind eigentlich selbsterklärend, doch was genau soll “replacer as function” bedeuten und wie verwende ich “columnsToSearch as list” im letzten Parameter?

Meiner Meinung nach fehlt es der offiziellen Dokumentation hier ein wenig an Erklärungen. Wir haben einige Beispiele in diesem Artikel. Im ersten Beispiel wird die Funktion Replacer.ReplaceValue verwendet:

Im zweiten Beispiel wird die Funktion Replacer.ReplaceText als “Replacer”-Parameter verwendet:

Allerdings gibt es keine zusätzlichen Erklärungen. Ich muss als Entwickler selbst herausfinden, was das bedeuten soll.

Table.ReplaceValue als Beispiel in der PowerQuery.how-Dokumentation

Schauen wir uns einmal an, wie PowerQuery.how die Funktion erklärt!

Ausführliche Beschreibung der Funktion

Als ersten Unterschied erhalten wir eine kurze Beschreibung der Funktion. Dies hilft dabei, zu verstehen, was die Funktion wirklich tut. Zusätzlich erhält man auch eine Kompatibilitätsliste mit kleinen Symbolen:

Danach sehen wir die Syntax, wobei ich jeden Parameter jeweils in einer neuen Zeile bekomme und zusätzlich darunter eine Tabelle habe, die jeden Parameter in ein paar Sätzen beschreibt:

Überspringen wir wieder die ersten 3 Parameter, da diese selbsterklärend sind, und konzentrieren wir uns auf den vierten Parameter, den “Replacer”. Hier erhalte ich die Information, dass es sich um die Ersetzungsmethode handelt und ich zwischen Replacer.ReplaceValue und Replacer.ReplaceText wählen kann (mit einem Link zu einer ausführlicheren Erklärung) und den Hinweis, dass ich auch eine benutzerdefinierte Vergleichsfunktion verwenden kann.

Und schließlich erhalte ich auch eine Erklärung zum letzten Parameter, dass dies nur die Spalte oder Spalten sind, in denen gesucht wird.

Dann folgt eine noch längere Beschreibung, bevor wir uns mit den Beispielen beschäftigen:

Jede Menge detaillierte Beispiele

Einer der größten Vorteile von PowerQuery.how sind die wirklich detaillierten Beispiele. Schauen wir uns das erste Beispiel an.

PowerQuery.how beschreibt zunächst das Szenario und danach die beiden Lösungen mit den beiden Replacer-Funktionen. Es zeigt das Ergebnis und man kann den gesamten M-Code kopieren und es selbst ausprobieren!

Ganz ehrlich, ist das nicht der Wahnsinn! Das bringt so viel mehr Verständnis für die Funktion!

Nach der allgemeinen Erklärung gibt es viele weitere Beispiele. Für diese Funktion gibt es:

• Werte bedingt ersetzen
• Ersetzen jedes Wertes in einer Spalte
• Ersetzen mit Precision
• Wie man eine eigene Replacer-Funktion erstellt

Jedes dieser Beispiele ist wie ein kleiner Blogartikel, in dem der Fall beschrieben wird. Sie sind so lang, wie sie sein müssen und so kurz, wie sie sein können!

Und das Beste: All das gibt es für jede Funktion in M und ist völlig kostenlos!

Zusätzliche Erklärungen in häufigen Szenarien

Neben den sehr detaillierten Beschreibungen der einzelnen M-Funktionen bietet die Website auch verschiedene Leitfäden und grundlegende Erläuterungen zu Power BI.

So gibt es zum Beispiel einen Artikel, der die verschiedenen Datentypen in Power Query im Detail beschreibt, eine Erklärung der Operatoren in Power Query oder die häufigsten Fehlermeldungen.

Zusammenfassung

Nach all den guten Worten, die ich hier über PowerQuery.how schreibe, könnte man sich fragen, ob ich etwas von dieser “Werbung” habe oder ob ich dafür bezahlt werde. Und die Antwort ist nein. Wie alles in diesem Blog ist dies nur meine ehrliche und offene Meinung. PowerQuery.how hat mir geholfen, die Sprache M viel besser zu verstehen, und ich denke, Rick macht einen wirklich fantastischen Job!

Ich bin überzeugt, dass es jedem helfen kann, der mit Power Query arbeitet. Deshalb freue ich mich, diese Website weiterempfehlen zu können. Ich hoffe, ich kann sie einem breiteren Publikum vorstellen und dazu beitragen, dass du ein besserer Power Query Benutzer wirst!

Was denkst du von PowerQuery.how? Lassen es mich in den Kommentaren wissen!