Ir al contenido

Fortgeschrittener M-Code (Power Query)

Skripte und Muster für deterministische Extraktion in der M-Sprache für den robusten Verbrauch von OData V4-APIs.

0Lesungen

Um die Extraktion von Daten aus unseren nativen APIs (ELT) in das semantische Modell von Power BI zu steuern, vermeiden wir die grafische Oberfläche und schreiben den Power Query-Code (Sprache M) direkt im Advanced Editor.

Dies bringt uns einer deterministischen und kontrollierbaren Entwicklung näher, bei der wir jeden Parameter der zugrunde liegenden HTTP-Anfrage steuern.

Der Kern unserer Ingestion nutzt die Funktion OData.Feed. Anstatt uns auf die automatisch generierte Version zu verlassen, standardisieren wir dieses grundlegende Snippet für alle Extraktionen aus Business Central:

let
// 1. Definición de la URL absoluta apuntando a nuestro Endpoint AL (EntitySetName)
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
// 2. Invocación de la API con inyección de protecciones de red
Origen = OData.Feed(UrlBase, null, [
Implementation="2.0",
Timeout=#duration(0, 0, 10, 0)
])
in
Origen
  • Implementation="2.0": Erzwingt, dass Power Query die modernste Version der OData-Engine verwendet. Optimiert das Lesen von JSON auf Binärebene und das Parsen von Metadaten.
  • Timeout=#duration(Días, Horas, Minutos, Segundos): Unsere Absicherung gegen Systemblockaden. Obwohl unsere API in AL so optimiert ist, dass sie etwa 30 Sekunden benötigt, injizieren wir ein striktes Limit von 10 Minuten (0, 0, 10, 0). Wenn das Microsoft ERP eine schwerwiegende Verschlechterung erfährt, bricht Power BI den Ladevorgang ab, ohne Prozesse unendlich lange im Speicher zu halten.

2. In Produktion bereitgestellte Ingestionen

Sección titulada «2. Ingestas Desplegadas en Producción»

Dies sind die genauen Skripte, die wir in unsere Haupt-Datasets integriert haben, um das Business-Intelligence-Modell zu speisen.

let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasCompra",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasVenta",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen

Da unsere Architektur auf Pushdown Computation (ELT) basiert, ist die Grundregel unserer Skripte M, die lokale Rechenlast bei Null zu halten.

  1. Keine Filter (WHERE) in M: Jeder Zeilenausschluss (z. B. das Auslassen bestimmter Lager oder Daten) wurde bereits im SQL-Motor von Business Central über die Eigenschaft DataItemTableFilter ausgeführt.
  2. Keine Spaltenlöschung in M: Nur die im Endpoint strikt projizierten Spalten werden über das HTTP-Netzwerk übertragen. Wir sollten nicht 100 Spalten abrufen, um 90 davon in Power Query zu löschen.
  3. Das Einzige, was wir lokal durchführen, ist das finale Datentypisieren (Type Casting) mittels Table.TransformColumnTypes, um sicherzustellen, dass das DAX-Modell unveränderliche Daten erhält (z. B. Int64.Type, type date, type number).
  • ✓ M-Implementierung: Explizite Verwendung des Parameters Implementation="2.0" in allen Abfragen für eine beschleunigte Datenladung.
  • ✓ Latenzkontrolle: Präventive Injektion von Timeout von 10 Minuten, um die Stabilität der Aktualisierungswarteschlange im Power BI Service zu schützen.
  • ✓ ELT-Optimierung: Keine lokalen Filter auf Power Query-Ebene, wodurch die gesamte schwere Datenlogik im SQL-Backend verbleibt.