Ir al contenido

Geavanceerde M-code (Power Query)

Scripts en deterministische extractiepatronen in de M-taal voor robuuste consumptie van OData V4-API's.

0lecturas

Om de data-extractie van onze native API's (ELT) naar het Power BI-semantische model te beheren, vermijden we de grafische gebruikersinterface en schrijven we de Power Query-code (taal M) rechtstreeks in de Geavanceerde Editor.

Dit brengt ons dichter bij een deterministische en controleerbare ontwikkeling, waarbij we elke parameter van het onderliggende HTTP-verzoek beheren.

De kern van onze ingestie maakt gebruik van de functie OData.Feed. In plaats van te vertrouwen op de automatisch gegenereerde versie, standaardiseren wij deze basissnippet voor alle extracties vanuit 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": Dwingt Power Query om de modernste versie van de OData-engine te gebruiken. Optimaliseert de JSON-lezing op binair niveau en het parsen van metadata.
  • Timeout=#duration(Días, Horas, Minutos, Segundos): Onze verzekering tegen systeemblokkades. Hoewel onze AL-API is geoptimaliseerd om ongeveer 30 seconden te duren, voegen we een strikte limiet van 10 minuten (0, 0, 10, 0) toe. Als de Microsoft ERP een ernstige prestatievermindering ervaart, zal Power BI het laden afbreken zonder processen onbeperkt in het geheugen te houden.

2. Ingesties Geïmplementeerd in Productie

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

Dit zijn de exacte scripts die we hebben geïntegreerd in onze belangrijkste Datasets om het business intelligence-model te voeden.

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

3. Overwegingen voor Transformatie na het Laden

Sección titulada «3. Consideraciones de Transformación Post-Carga»

Aangezien onze architectuur is gebaseerd op Pushdown Computation (ELT), is de fundamentele regel van onze scripts M om de lokale computationele belasting op nul te houden.

  1. Geen filters (WHERE) in M: Elke uitsluiting van rijen (bijv. het uitsluiten van bepaalde magazijnen of datums) is al uitgevoerd in de SQL-engine van Business Central via de eigenschap DataItemTableFilter.
  2. Geen kolomverwijdering in M: Alleen de kolommen die strikt geprojecteerd zijn in de endpoint reizen via het HTTP-netwerk. We moeten niet 100 kolommen ophalen om er vervolgens 90 te verwijderen in Power Query.
  3. Het enige wat we lokaal doen is de uiteindelijke datatypeconversie (Type Casting) via Table.TransformColumnTypes, om ervoor te zorgen dat het DAX-model onveranderlijke gegevens ontvangt (bijv. Int64.Type, type date, type number).
  • ✓ M-implementatie: Expliciet gebruik van de parameter Implementation="2.0" in alle queries voor versnelde gegevensopname.
  • ✓ Latentiecontrole: Preventieve injectie van een Timeout van 10 minuten om de stabiliteit van de updatewachtrij in Power BI Service te beschermen.
  • ✓ ELT-optimalisatie: Nul lokale filters toegepast op Power Query-niveau, waarbij alle zware datalogica in de SQL-backend wordt gehouden.