Código M (Power Query) Avanzado
Skrypty i wzorce ekstrakcji deterministycznej w języku M do solidnego zużycia API OData V4.
Aby zarządzać ekstrakcją danych z naszych rodzimych interfejsów API (ELT) do semantycznego modelu Power BI, unikamy interfejsu graficznego i piszemy kod Power Query (język M) bezpośrednio w Edytorze zaawansowanym.
Dzięki temu zbliżamy się do deterministycznego i kontrolowalnego rozwoju, gdzie zarządzamy każdym parametrem podstawowego żądania HTTP.
1. Podstawowy wzorzec ekstrakcji OData
Sección titulada «1. El Patrón Base de Extracción OData»Rdzeń naszej ingesty używa funkcji OData.Feed. Zamiast polegać na automatycznie wygenerowanym, standaryzujemy ten fragment kodu podstawowy dla wszystkich ekstrakcji 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 OrigenWyjaśnienie krytycznych parametrów (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Wymusza na Power Query użycie najnowszej wersji silnika OData. Optymalizuje odczyt JSON na poziomie binarnym i analizę metadanych.Timeout=#duration(Días, Horas, Minutos, Segundos): Nasze zabezpieczenie przed blokowaniem systemu. Chociaż nasz interfejs API w AL jest zoptymalizowany, aby trwać ~30 sekund, wstrzykujemy ścisły limit 10 minut (0, 0, 10, 0). Jeśli ERP Microsoft ulegnie ciężkiej degradacji, Power BI przerwie załadunek bez utrzymywania procesów w pamięci przez nieograniczony czas.
2. Ingestie wdrożone w produkcji
Sección titulada «2. Ingestas Desplegadas en Producción»To są dokładne skrypty, które mamy zintegrowane w naszych głównych zestawach danych, aby zasilić model inteligencji biznesowej.
2.1. Ruchy produktu (fakta logistyczne)
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. Linie zakupu
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. Linie sprzedaży
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. Rozważania dotyczące transformacji po załadunku
Sección titulada «3. Consideraciones de Transformación Post-Carga»Ponieważ nasza architektura opiera się na obliczeniach pushdown (ELT), podstawową zasadą naszych skryptów M jest utrzymanie obciążenia obliczeniowego lokalnego na poziomie zero.
- Bez filtrów (
WHERE) wM: Każde wykluczenie wierszy (np. pomijanie pewnych magazynów lub dat) zostało już wykonane w silniku SQL Business Central za pomocą właściwościDataItemTableFilter. - Bez usuwania kolumn w
M: Przez sieć HTTP przechodzą tylko kolumny ściśle przypisane do punktu końcowego. Nie powinniśmy pobierać 100 kolumn, aby usunąć 90 w Power Query. - Jedyną rzeczą, którą wykonujemy lokalnie, jest ostateczne przypisanie typów danych (Type Casting) za pomocą
Table.TransformColumnTypes, zapewniając, że model DAX otrzymuje niezmienne dane (np.Int64.Type,type date,type number).
4. Lista kontrolna rozwoju M
Sección titulada «4. Checklist de Desarrollo M»- ✓ Implementacja M: Jawne użycie parametru
Implementation="2.0"we wszystkich zapytaniach w celu przyspieszenia załadunku danych. - ✓ Kontrola opóźnień: Prewencyjne wstrzykiwanie
Timeouto wartości 10 minut w celu ochrony stabilności kolejki aktualizacji w usłudze Power BI. - ✓ Optymalizacja ELT: Brak lokalnych filtrów stosowanych na poziomie Power Query, utrzymując całą ciężką logikę danych w backendzie SQL.

