Konfiguration on dsyr.DataBridge

Verbindungen (connections)

Mon, 01 Jan 0001 00:00:00 +0000

Die Tabelle connections ist die Grundlage jeder DataBridge-Konfiguration. Sie enthält die Zugangsdaten zu allen Systemen, mit denen die DataBridge kommuniziert — sowohl Quell- als auch Zielsysteme.

Tabellenstruktur

Spalte	Wert	Beschreibung
PartitionKey	`connection`	Muss immer `connection` lauten
RowKey	frei wählbar	Eindeutiger Name dieser Verbindung. Wird in der `jobs`-Tabelle als Referenz verwendet.
Timestamp	automatisch	Systemseitig gesetzt, nicht bearbeitbar
Type	Connector-Typ	Gibt an, um welches System es sich handelt (siehe Tabelle unten)
Json	JSON-Objekt	System-spezifische Verbindungsparameter (unterscheidet sich je nach `Type`)

PartitionKey ist nicht frei wählbar

Die DataBridge liest die Tabelle ausschließlich mit dem Filter PartitionKey eq 'connection'. Zeilen mit einem abweichenden PartitionKey werden ohne Fehlermeldung und ohne Warnung ignoriert — die Verbindung existiert dann für die DataBridge nicht, und jeder Job, der sie referenziert, wird als unvollständig verworfen.

Jobs (jobs)

Mon, 01 Jan 0001 00:00:00 +0000

Ein Job beschreibt genau eine Synchronisationsrichtung zwischen zwei Systemen: er verbindet eine Quelltabelle mit einer Zieltabelle, legt den Zeitplan fest und verweist auf das zugehörige Mapping.

Tabellenstruktur

Spalte	Pflicht	Beschreibung
PartitionKey	✅	Muss immer `job` lauten.
RowKey	✅	Eindeutiger Jobname. Wird im Logging und als Referenz für ResponseJobs verwendet.
IsActive	✅	`true` = Job wird von `GetChanges` ausgeführt. `false` = Job wird nur indirekt (als ResponseJob) aufgerufen.
SourceConnection	✅	RowKey-Referenz auf einen Eintrag in der `connections`-Tabelle (Quelldaten).
TargetConnection	✅	RowKey-Referenz auf einen Eintrag in der `connections`-Tabelle (Zieldaten).
Mapping	✅	PartitionKey-Referenz auf eine Gruppe von Einträgen in der `mappings`-Tabelle.
Source	—	Quellressource (Tabelle, Entität, Pfad oder Aktion). Überschreibt die `SourceTable` der Mapping-Zeilen für diesen Job (siehe unten).
Target	—	Zielressource (Tabelle, Entität, Pfad oder Aktion). Überschreibt die `TargetTable` der Mapping-Zeilen für diesen Job (siehe unten).
Order	✅	Ganzzahl. Legt die Ausführungsreihenfolge fest — muss über alle Jobs eindeutig sein.
WatermarkField	—	Feldname im Quellsystem, der als Änderungsindikator genutzt wird (meistens ein Datums-/Zeitstempelfeld). Nur bei `WatermarkType` = `date` oder `datetime` erforderlich; bei `string` (Dataverse Change Tracking) bleibt das Feld leer.
WatermarkType	✅	Typ des Watermark-Wertes: `date`, `datetime` oder `string` (Details: Watermarks).
Filter	—	Filterausdruck für die Quellanfrage. Format ist systemabhängig (siehe unten).
Schedule	—	CRON-Ausdruck (6-stellig, NCrontab). Wenn leer, läuft der Job bei jedem Timer-Aufruf.
Action	—	Steuert, welche Änderungsarten gelesen werden, oder benennt eine Aktion. Leer = `NewUpdate`. Wirkt bei den CRUD-Werten (`Delete`, `DeleteOnUpdate`) nur bei D365CE als Quellsystem (siehe unten); ein nicht erkannter Wert schaltet den Job auf `InvokeAction` (siehe unten).
Priority	—	`Standard` (Vorgabe), `High` oder `Low`. Steuert die Service-Bus-Queue.
ResponseJob	—	RowKey eines anderen Jobs, der nach erfolgreichem Schreiben automatisch ausgeführt wird.
IsValid	—	Reserviert. Die Spalte kommt in bestehenden Tabellen vor, wird von der DataBridge aber nicht gelesen und hat keine Wirkung.

PartitionKey ist nicht frei wählbar

Die DataBridge liest die Tabelle ausschließlich mit dem Filter PartitionKey eq 'job'. Zeilen mit einem abweichenden PartitionKey werden ohne Fehlermeldung und ohne Warnung ignoriert — der Job existiert dann für die DataBridge schlicht nicht.

Mappings (mappings)

Mon, 01 Jan 0001 00:00:00 +0000

Die mappings-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.

Ein Mapping ist eine Gruppe von Zeilen in der Tabelle — alle mit demselben PartitionKey. Jede Zeile beschreibt genau eine Feld-Zuordnung.

Tabellenstruktur

Spalte	Pflicht	Beschreibung
PartitionKey	✅	Name des Mappings. Wird im Job unter `Mapping` referenziert. Im Gegensatz zu `jobs` und `connections` ist der PartitionKey hier frei wählbar — er dient der Gruppierung.
RowKey	✅	Eindeutiger Bezeichner innerhalb des Mappings. Konvention: `_quellfeld__zielfeld_`
SourceTable	✅	Name der Quelltabelle/-entität. Muss innerhalb eines Mappings konsistent sein.
SourceField	—	Name des Quellfeldes. Kann leer sein (bei `DefaultValue`) oder mit `_` beginnen — dann handelt es sich um ein virtuelles Feld.
TargetTable	✅	Name der Zieltabelle/-entität. Muss innerhalb eines Mappings konsistent sein.
TargetField	✅	Name des Zielfeldes. Muss dem tatsächlichen API-/Spaltenname entsprechen.
TargetKey	—	JSON-Objekt. Definiert, wie ein bestehender Datensatz im Zielsystem identifiziert wird (für Upsert-Logik).
SourceOperation	—	JSON-Objekt der Form `{ "Operations": [ … ] }`. Transformation beim Lesen aus der Quelle.
TargetOperation	—	JSON-Objekt der Form `{ "Operations": [ … ] }`. Transformationen beim Schreiben ins Ziel.

RowKey-Namenskonvention

Die empfohlene Konvention für den RowKey: _quellfeld__zielfeld_

Watermarks (watermark)

Mon, 01 Jan 0001 00:00:00 +0000

Die Tabelle watermark ist die Gedächtnisfunktion der DataBridge. Nach jedem Job-Lauf wird hier gespeichert, bis zu welchem Stand die Daten gelesen wurden. Beim nächsten Lauf startet der Quellabruf genau an diesem Punkt.

Diese Tabelle wird vom Deployment angelegt und zur Laufzeit automatisch befüllt — manuelle Einträge sind normalerweise nicht nötig. Es gibt jedoch Situationen, in denen ein gezielter Eingriff sinnvoll ist.

Tabellenstruktur

Spalte	Wert	Beschreibung
PartitionKey	`watermark`	Fest vorgegeben — immer `watermark`
RowKey	Jobname	Entspricht dem RowKey des zugehörigen Jobs in der `jobs`-Tabelle
Timestamp	automatisch	Systemseitig gesetzt, nicht bearbeitbar
Watermark	Letzter Stand	Format abhängig vom `WatermarkType` des Jobs (siehe unten)
LastCronRun	Zeitstempel	Beginn der letzten Ausführung des Jobs. Basis für die CRON-Intervallprüfung.

Watermark-Typen

Der Typ wird im Job über das Feld WatermarkType festgelegt und bestimmt, wie der gespeicherte Wert interpretiert wird.