Ir al contenido

Pokročilý kód M (Power Query)

Skripty a vzory deterministickej extrakcie v jazyku M pre robustnú spotrebu rozhraní API OData V4.

0lecturas

Na riadenie extrakcie dát z našich natívnych API (ELT) smerom k semantickému modelu Power BI sa vyhýbame grafickému rozhraniu a píšeme kód Power Query (jazyk M ) priamo v rozšírenom editore.

To nás približuje k deterministickému a kontrolovateľnému vývoju, kde riadime každý parameter podkladovej požiadavky HTTP.

Jadro našej ingestie využíva funkciu OData.Feed. Namiesto spoliehania sa na automaticky vygenerovaný kód štandardizujeme tento základný snippet pre všetky extrakcie z 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": Núti Power Query používať najmodernejšiu verziu motora OData. Optimalizuje čítanie JSON na binárnej úrovni a parsovanie metadát.
  • Timeout=#duration(Días, Horas, Minutos, Segundos): Naše poistenie proti zablokovaniu systému. Aj keď naša API v AL je optimalizovaná na ~30 sekúnd, vkladáme prísny limit 10 minút (0, 0, 10, 0). Ak dôjde k vážnemu zlyhaniu ERP spoločnosti Microsoft, Power BI zruší načítanie bez udržania procesov v pamäti na neurčito.

Toto sú presné skripty, ktoré máme integrované do našich hlavných datasetov, aby sme podporili model obchodnej inteligencie.

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

Keďže naša architektúra je založená na Pushdown Computation (ELT), základným pravidlom našich skriptov M je udržať lokálnu výpočtovú záťaž na nule.

  1. Bez filtrov (WHERE) v M: Všetky vylúčenia riadkov (napr. vynechanie určitých skladov alebo dátumov) už boli vykonané v motore SQL Business Central pomocou vlastnosti DataItemTableFilter.
  2. Bez odstránenia stĺpcov v M: Sieť HTTP prechádzajú len striktne projektované stĺpce v endpoint. Nemusíme priniesť 100 stĺpcov, aby sme odstránili 90 v Power Query.
  3. Jediná vec, ktorú vykonávame lokálne, je finálny typ údajov (Type Casting) pomocou Table.TransformColumnTypes, čím sa zabezpečuje, že model DAX dostáva nemenné údaje (napr. Int64.Type, type date, type number).
  • ✓ Implementácia M: Explicitné použitie parametra Implementation="2.0" vo všetkých dotazoch pre urýchlené načítanie údajov.
  • ✓ Riadenie latencie: Preventívna injekcia Timeout 10 minút na ochranu stability fronty aktualizácií v Power BI Service.
  • ✓ Optimalizácia ELT: Žiadne lokálne filtre aplikované na úrovni Power Query, pričom všetka ťažká logika údajov je ponechaná v backendu SQL.