Ir al contenido

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

Skripty a vzorce deterministické extrakce v jazyce M pro robustní konzumaci OData V4 API.

0čtení

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.

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
Origen
  • 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ě.

Toto jsou přesné skripty, které máme integrované v našich hlavních datových sadách pro napájení modelu business intelligence.

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

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.

  1. Bez filtrů (WHERE) v M: Veškeré vyloučení řádků (např. vynechání určitých skladů nebo dat) již bylo provedeno v SQL enginu Business Central pomocí vlastnosti DataItemTableFilter.
  2. 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.
  3. 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).
  • ✓ Implementace M: Explicitní použití parametru Implementation="2.0" ve všech dotazech pro urychlené načítání dat.
  • ✓ Kontrola latence: Preventivní injekce Timeout o 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.