Mappingregel

Wat is een mappingregel?

Een mappingregel legt vast hoe data van een bronveld naar een doelveld wordt vertaald. Soms is dat een eenvoudige één-op-één-koppeling. Soms bevat de regel voorwaarden, berekeningen, standaardwaarden of vertalingen tussen codesets.

Mappingregels zijn de leesbare vertaling van technische integratielogica. Ze tonen niet alleen welke velden verbonden zijn, maar ook welke keuzes onderweg gemaakt worden.

Zonder mappingregels zit de betekenis vaak verstopt in SQL, Power Query, Python-code of Excel-formules. Dat maakt controle lastig en zorgt dat wijzigingen gevaarlijk worden.

Soorten mappingregels

Rechtstreekse mapping
Het bronveld gaat zonder inhoudelijke wijziging naar het doelveld. Bijvoorbeeld `customer_id` wordt `klantnummer`.

Naamstandaardisatie
Verschillende bronvelden krijgen één doelnaam. Bijvoorbeeld `cust_no`, `client_id` en `debiteur_nr` worden allemaal `klantnummer`.

Codevertaling
Broncodes worden vertaald naar doelcodes. Bijvoorbeeld `A`, `I` en `B` worden `Actief`, `Inactief` en `Geblokkeerd`.

Conditionele mapping
De waarde hangt af van een voorwaarde. Bijvoorbeeld: als `country = BE`, gebruik ondernemingsnummer als business key, anders gebruik btw-nummer.

Berekende mapping
Het doelveld wordt berekend uit meerdere bronvelden, zoals `netto_omzet = brutobedrag - korting - btw`.

Wanneer heb je mappingregels nodig?

1. Bij datamigratie. Oude velden moeten naar de structuur van het nieuwe systeem.

2. Bij data-integratie. Meerdere bronnen moeten in één datamodel samenkomen.

3. Bij rapportering. Businessbegrippen moeten traceerbaar zijn naar technische bronvelden.

4. Bij datakwaliteit. Je moet kunnen aantonen waarom een waarde in het doelmodel staat zoals ze staat.

Voorbeeld

Een supportsysteem gebruikt prioriteiten `1`, `2`, `3` en `4`. Het rapporteringsmodel gebruikt `Kritiek`, `Hoog`, `Normaal` en `Laag`. De mappingregel legt vast dat `1` naar `Kritiek` gaat, `2` naar `Hoog`, `3` naar `Normaal` en `4` naar `Laag`.

Als het supportsysteem later prioriteit `0` toevoegt voor veiligheidsincidenten, toont de mappingdocumentatie meteen dat er een nieuwe regel nodig is. Anders komt de waarde als leeg, fout of onbekend in het rapport.

Wat maakt een mappingregel goed?

Een goede mappingregel is concreet genoeg om te bouwen en duidelijk genoeg om te reviewen. Ze vermeldt bronveld, doelveld, eventuele voorwaarden, uitzonderingen en de eigenaar van de keuze.

Schrijf mappingregels niet alleen voor ontwikkelaars. Een business reviewer moet kunnen zien of de betekenis klopt. Als niemand buiten het datateam de mapping begrijpt, is de kans groot dat de regel te technisch of te impliciet is.

Verwant aan en niet verwarren met

Bronveld en doelveld
De mappingregel verbindt bronveld en doelveld. Zonder die twee heeft de regel geen richting.

Transformatie
Een mappingregel kan een transformatie bevatten, maar transformatie is breder. Ook opschonen, splitsen of aggregeren zijn transformaties.

Afleidingsregel
Een afleidingsregel berekent een nieuwe waarde. Dat kan onderdeel zijn van een mappingregel wanneer het doelveld niet rechtstreeks uit de bron komt.

Data lineage
Data lineage toont het volledige pad. Mappingregels beschrijven de inhoudelijke logica op één verbinding in dat pad.

FAQ over mappingregels

1. Is een mappingregel hetzelfde als SQL-code?
Nee. SQL kan de mapping uitvoeren, maar de mappingregel beschrijft de bedoeling op een manier die reviewbaar is.

2. Moeten mappingregels altijd in een document staan?
Niet noodzakelijk. Ze kunnen ook in metadata, dbt-documentatie, een catalogus of tests zitten. Ze moeten vooral vindbaar zijn.

3. Wie keurt mappingregels goed?
Technische mappings kan het datateam valideren. Businessbetekenis hoort bij de domeineigenaar of data steward.