Pokročilý kód M (Power Query)
Skripty a vzorce deterministické extrakce v jazyce M pro robustní konzumaci OData V4 API.
Pro řízení extrakce dat z našich nativních API (ELT) do sémantického modelu Power BI se vyhýbáme grafickému rozhraní a píšeme kód Power Query (jazyk M) přímo v Pokročilém editoru.
To nás přibližuje k deterministickému a kontrolovatelnému vývoji, kde řídíme každý parametr základního požadavku HTTP.
1. Základní vzor extrakce OData
Sección titulada «1. El Patrón Base de Extracción OData»Jádro našeho ingestu používá funkci OData.Feed. Místo spoléhání se na automaticky generovaný kód standardizujeme tento základní snippet pro všechny extrakce 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 OrigenVysvětlení kritických parametrů (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Vynucuje použití nejmodernější verze motoru OData v Power Query. Optimalizuje čtení JSON na binární úrovni a parsování metadat.Timeout=#duration(Días, Horas, Minutos, Segundos): Naše pojistka proti blokování systému. Ačkoliv je naše API v jazyce AL optimalizováno na čas ~30 sekund, vkládáme přísný limit 10 minut (0, 0, 10, 0). Pokud dojde k vážnému zhoršení výkonu Microsoft ERP, Power BI přeruší načítání, aniž by procesy v paměti držely nedefinitně.
2. Ingesce nasazené v produkci
Sección titulada «2. Ingestas Desplegadas en Producción»Toto jsou přesné skripty, které máme integrované v našich hlavních datových sadách pro napájení modelu business intelligence.
2.1. Pohyby zboží (Logistická fakta)
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. Nákupní řádky
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. Prodejní řádky
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 transformaci po načtení
Sección titulada «3. Consideraciones de Transformación Post-Carga»Protože naše architektura vychází z Pushdown Computation (ELT), základní pravidlem našich skriptů M je udržet lokální výpočetní zátěž na nule.
- Bez filtrů (
WHERE) vM: Veškeré vyloučení řádků (např. vynechání určitých skladů nebo dat) již bylo provedeno v SQL enginu Business Central pomocí vlastnostiDataItemTableFilter. - Bez odstraňování sloupců v
M: Přes HTTP síť procházejí pouze sloupce striktně projektované v endpointu. Nemáme tahat 100 sloupců, abychom jich 90 smazali v Power Query. - Jediné, co provádíme lokálně, je finální typování dat (Type Casting) prostřednictvím
Table.TransformColumnTypes, čímž zajišťujeme, že DAX model přijímá neměnné údaje (např.Int64.Type,type date,type number).
4. Kontrolní seznam vývoje M
Sección titulada «4. Checklist de Desarrollo M»- ✓ Implementace M: Explicitní použití parametru
Implementation="2.0"ve všech dotazech pro urychlené načítání dat. - ✓ Kontrola latence: Preventivní injekce
Timeouto délce 10 minut pro ochranu stability fronty aktualizací v Power BI Service. - ✓ Optimalizace ELT: Žádné lokální filtry aplikované na úrovni Power Query, přičemž veškerá náročná datová logika zůstává v backendu SQL.

