Pokročilý kód M (Power Query)
Skripty a vzory deterministickej extrakcie v jazyku M pre robustnú spotrebu rozhraní API OData V4.
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.
1. Základný vzor extrakcie OData
Sección titulada «1. El Patrón Base de Extracción OData»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 OrigenVysvetlenie kritických parametrov (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»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.
2. Ingesty nasadené do produkcie
Sección titulada «2. Ingestas Desplegadas en Producción»Toto sú presné skripty, ktoré máme integrované do našich hlavných datasetov, aby sme podporili model obchodnej inteligencie.
2.1. Pohyby produktu (logistické fakty)
Sección titulada «2.1. Movimientos de Producto (Hechos Logísticos)»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 Origen2.2. Linky nákupu
Sección titulada «2.2. Líneas de Compra»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 Origen2.3. Linky predaja
Sección titulada «2.3. Líneas de Venta»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 Origen3. Úvahy o transformácii po načítaní
Sección titulada «3. Consideraciones de Transformación Post-Carga»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.
- Bez filtrov (
WHERE) vM: Všetky vylúčenia riadkov (napr. vynechanie určitých skladov alebo dátumov) už boli vykonané v motore SQL Business Central pomocou vlastnostiDataItemTableFilter. - 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. - 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).
4. Kontrolný zoznam vývoja M
Sección titulada «4. Checklist de Desarrollo M»- ✓ 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
Timeout10 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.

