Ir al contenido

Codice M (Power Query) Avanzato

Script e pattern di estrazione deterministica nel linguaggio M per il consumo robusto di API OData V4.

0letture

Per governare l'estrazione dei dati dalle nostre API native (ELT) verso il modello semantico di Power BI, evitiamo l'interfaccia grafica e scriviamo il codice Power Query (Linguaggio M) direttamente nell'Editor Avanzato.

Questo ci avvicina a uno sviluppo deterministico e controllabile, in cui governiamo ogni parametro della richiesta HTTP sottostante.

Il nucleo della nostra ingestione utilizza la funzione OData.Feed. Invece di dipendere dalla generazione automatica, standardizziamo questo snippet di base per tutte le estrazioni da 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": Forza Power Query a utilizzare la versione più recente del motore OData. Ottimizza la lettura di JSON a livello binario e il parsing dei metadati.
  • Timeout=#duration(Días, Horas, Minutos, Segundos): La nostra protezione contro i blocchi di sistema. Sebbene la nostra API in AL sia ottimizzata per impiegare circa 30 secondi, iniettiamo un limite rigoroso di 10 minuti (0, 0, 10, 0). Se l'ERP di Microsoft subisce un grave degrado, Power BI interromperà il caricamento senza mantenere i processi in memoria indefinitamente.

Questi sono gli script esatti che abbiamo integrato nei nostri Dataset principali per alimentare il modello di 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

3. Considerazioni sulla Trasformazione Post-Caricamento

Sección titulada «3. Consideraciones de Transformación Post-Carga»

Poiché la nostra architettura si basa su Pushdown Computation (ELT), la regola fondamentale dei nostri script M è mantenere il carico computazionale locale a zero.

  1. Senza filtri (WHERE) in M: Ogni esclusione di righe (es. omettere determinati magazzini o date) è già stata eseguita nel motore SQL di Business Central tramite la proprietà DataItemTableFilter.
  2. Senza eliminazione di colonne in M: Solo le colonne strettamente proiettate nell'endpoint transitano sulla rete HTTP. Non dobbiamo recuperare 100 colonne per eliminarne 90 in Power Query.
  3. L'unica operazione che eseguiamo localmente è la tipizzazione finale dei dati (Type Casting) tramite Table.TransformColumnTypes, assicurando che il modello DAX riceva dati immutabili (es. Int64.Type, type date, type number).
  • ✓ Implementazione M: Uso esplicito del parametro Implementation="2.0" in tutte le query per un caricamento dati accelerato.
  • ✓ Controllo della latenza: Iniezione preventiva di Timeout di 10 minuti per proteggere la stabilità della coda di aggiornamento in Power BI Service.
  • ✓ Ottimizzazione ELT: Zero filtri locali applicati a livello di Power Query, mantenendo tutta la logica pesante dei dati nel backend SQL.