MySQL — MySQL / MariaDB
Der MySQL-Konnektor ist als Vorabversion eingestuft und für den produktiven Einsatz derzeit nicht geeignet. Er ist weder freigegeben noch für den Regelbetrieb abgesichert.
Wer MySQL oder MariaDB anbinden möchte, wendet sich bitte vorab an WYSA — dort wird der konkrete Anwendungsfall geprüft und der aktuelle Stand mitgeteilt.
Der MySQL-Konnektor ist für das Lesen von Daten aus MySQL- und MariaDB-Datenbanken vorgesehen.
| Eigenschaft | Wert |
|---|---|
| Lesen | ⚠️ Preview, nicht produktionsreif |
| Schreiben | — nicht unterstützt |
| Job-Filter | ✅ wird als WHERE-Klausel übernommen |
| Status | Preview |
Wie beim MSSQL-Konnektor wird der Inhalt des Feldes Filter am Job — nach
Ersetzung des Platzhalters %watermark% — wörtlich hinter WHERE eingesetzt. Ohne Eintrag
im Feld Filter entsteht keine WHERE-Klausel und der Job liest bei jedem Lauf die
vollständige Tabelle. Der Ausdruck muss gültiges MySQL-SQL sein; es findet keine
Parametrisierung statt. Details zur Filter-Syntax siehe MSSQL — Filter.
Ein MySQL-System als TargetConnection führt zur Laufzeit zu einem Abbruch. Auch das
Löschen von Datensätzen ist nicht implementiert.
Verbindungsparameter
{
"connectionstring": "<MySQL Connection String>"
}
Beispiel:
Server=<server>;Database=<db>;User=<user>;Password=<password>;
Optionale Parameter
| Parameter | Standardwert | Beschreibung |
|---|---|---|
commandTimeOut | 30 | Zeitlimit für einzelne SQL-Befehle in Sekunden |
maxPageSize | 5000 | Anzahl Datensätze je Seite |
language | de-DE | Kultur, in der gelesene Zahlen- und Datumswerte formatiert werden |
keyVaultUrl | (leer) | Key-Vault-Secret-URL; ersetzt sämtliche übrigen Parameter |
Tabellen- und Feldnamen
| Einstellung | Wert |
|---|---|
| SourceTable | Tabellenname (z. B. customers, orders) |
| SourceField | Spaltenname, wie in der Tabelle definiert |
Änderungserkennung (Watermark)
| Eigenschaft | Wert |
|---|---|
| WatermarkType | date oder datetime |
| WatermarkField | Name der Zeitstempel-Spalte |
Die Spalte aus WatermarkField wird zusätzlich zu den gemappten Feldern abgefragt und für
die Sortierung verwendet.
Geeignet sind datetime, timestamp und date — der Wert wird dann als ISO-Zeitstempel
weitergereicht. Eine Spalte anderen Typs, etwa bigint oder int, führt nicht mehr zu
einem Abbruch, wird aber unverändert über ToString() weitergegeben.
Datentypen — gelesene Werte
Da Schreiben nicht unterstützt wird, ist allein der Lesepfad relevant. Der Typ ergibt sich aus dem ADO.NET-Spaltentyp; der so ermittelte Typname wird zusammen mit dem formatierten Wert an den Zielkonnektor weitergereicht und dort für die Auswahl der Umwandlung verwendet.
| ADO.NET-Spaltentyp | Weitergegebener Typ | Formatierung des Wertes |
|---|---|---|
Int32 | int32 | Wird als Ganzzahl gelesen und in der Kultur aus language ausgegeben |
Decimal | decimal | Wird als Dezimalzahl gelesen und in der Kultur aus language ausgegeben |
Double | double | Wie Decimal — Umwandlung über einen Dezimalwert |
DateTime | datetime | Format u, also yyyy-MM-dd HH:mm:ssZ |
| alle übrigen | Name des .NET-Typs (z. B. string, boolean, guid) | Unveränderte Textdarstellung |
Welche Quelltypen ein Zielsystem akzeptiert, steht auf der jeweiligen Zielkonnektor-Seite: D365BC, D365CE, D365NAV.