https://blue-wave-000dd0703-preview.westeurope.6.azurestaticapps.net/themen/mapping/Recent content in Mapping on dsyr.DataBridgeHugodehttps://blue-wave-000dd0703-preview.westeurope.6.azurestaticapps.net/docs/konfiguration/mappings/Mon, 01 Jan 0001 00:00:00 +0000https://blue-wave-000dd0703-preview.westeurope.6.azurestaticapps.net/docs/konfiguration/mappings/<p>Die <code>mappings</code>-Tabelle ist die mächtigste Konfigurationsebene der DataBridge. Sie legt für jedes Feld fest: woher kommt der Wert, wohin geht er, und wie wird er unterwegs transformiert.</p> <p>Ein Mapping ist eine <strong>Gruppe von Zeilen</strong> in der Tabelle — alle mit demselben <code>PartitionKey</code>. Jede Zeile beschreibt genau eine Feld-Zuordnung.</p> <hr> <h2 id="tabellenstruktur">Tabellenstruktur</h2> <table> <thead> <tr> <th>Spalte</th> <th style="text-align: center">Pflicht</th> <th>Beschreibung</th> </tr> </thead> <tbody> <tr> <td><strong>PartitionKey</strong></td> <td style="text-align: center">✅</td> <td>Name des Mappings. Wird im Job unter <code>Mapping</code> referenziert. Im Gegensatz zu <code>jobs</code> und <code>connections</code> ist der PartitionKey hier <strong>frei wählbar</strong> — er dient der Gruppierung.</td> </tr> <tr> <td><strong>RowKey</strong></td> <td style="text-align: center">✅</td> <td>Eindeutiger Bezeichner innerhalb des Mappings. Konvention: <code>_quellfeld__zielfeld_</code></td> </tr> <tr> <td><strong>SourceTable</strong></td> <td style="text-align: center">✅</td> <td>Name der Quelltabelle/-entität. Muss innerhalb eines Mappings konsistent sein.</td> </tr> <tr> <td><strong>SourceField</strong></td> <td style="text-align: center">—</td> <td>Name des Quellfeldes. Kann leer sein (bei <code>DefaultValue</code>) oder mit <code>_</code> beginnen — dann handelt es sich um ein <a href="https://blue-wave-000dd0703-preview.westeurope.6.azurestaticapps.net/docs/konfiguration/mappings/#virtuelle-felder">virtuelles Feld</a>.</td> </tr> <tr> <td><strong>TargetTable</strong></td> <td style="text-align: center">✅</td> <td>Name der Zieltabelle/-entität. Muss innerhalb eines Mappings konsistent sein.</td> </tr> <tr> <td><strong>TargetField</strong></td> <td style="text-align: center">✅</td> <td>Name des Zielfeldes. Muss dem tatsächlichen API-/Spaltenname entsprechen.</td> </tr> <tr> <td><strong>TargetKey</strong></td> <td style="text-align: center">—</td> <td>JSON-Objekt. Definiert, wie ein bestehender Datensatz im Zielsystem identifiziert wird (für Upsert-Logik).</td> </tr> <tr> <td><strong>SourceOperation</strong></td> <td style="text-align: center">—</td> <td>JSON-Objekt der Form <code>{ &quot;Operations&quot;: [ … ] }</code>. Transformation beim <strong>Lesen</strong> aus der Quelle.</td> </tr> <tr> <td><strong>TargetOperation</strong></td> <td style="text-align: center">—</td> <td>JSON-Objekt der Form <code>{ &quot;Operations&quot;: [ … ] }</code>. Transformationen beim <strong>Schreiben</strong> ins Ziel.</td> </tr> </tbody> </table> <h3 id="rowkey-namenskonvention">RowKey-Namenskonvention</h3> <p>Die empfohlene Konvention für den RowKey: <code>_quellfeld__zielfeld_</code></p>