Table of Contents

Tabellenzuordnungsteile

In diesem Artikel erfahren Sie, wie Sie Tabellenzuordnungsteile in der Aident SQL Migration App in Business Central verwenden.

Was ist der Zweck der Funktion?

Manchmal ist es notwendig, Daten von einer Tabelle in mehreren Datenpaketen zu migrieren, z. B. weil eine Tabelle eine besonders große Anzahl von Datensätzen enthält oder weil nur ein bestimmter Bereich von Datensätzen vor der Inbetriebnahme migriert werden soll. Dies soll durch den Einsatz von Tabellenzuordnungsteile ermöglicht werden. Diese können durch das Setzen von Filterwerten für Primärschlüsselfelder eingeschränkt oder ausgewählt werden.

Zum Beispiel können Daten von einer Postentabelle für einen spezifischen Nummernbereich migriert werden, indem die Lfd. Nr. als Filter eingegeben wird. Beim Erstellen eines Tabellenzuordnungsteils werden die Einstellungen einer Tabellenzuordnung und die dazugehörigen Feldzuordnungen geerbt, d.h., alle Tabellenzuordnungsteile haben dieselben Einstellungen. Zusätzlich werden separate SQL-Abfragen für alle Tabellenzuordnungsteile erstellt, um die Daten zu löschen und zu migrieren.

Das Erstellen von Zuordnungsteilen kann manuell oder automatisiert erfolgen. Bei der automatischen Erstellung der Teile werden die Anzahl der Datensätze in der Quelltabelle je Mandant sowie die maximale Anzahl an Datensätze per Migrationsabfrage berücksichtigt. Für jeden eingerichteten Zielmandanten werden anschließend die Teile mit den oberen und unteren Grenzwerten erzeugt.

Sind die Tabellenzuordnungsteile einmal eingerichtet, werden nur diese Teile unter Berücksichtigung der erstellten Filter ausgeführt.

Es sollte beachtet werden, dass beim Einsatz von Tabellenzuordnungensteilen die Daten der Zieltabelle nur gelöscht werden sollten, wenn der erste Teil ausgeführt wird. Wird das Löschen der Zieldaten auch vor weiteren Tabellenzuordnungsteile durchgeführt, existieren bereits migrierte Daten aus früheren Teilmigrationen nicht mehr in der Zieltabelle. Das Unterlassen des Löschens der Zieltabelle vor der Migration des ersten Teils kann zu Primärschlüsselverletzungen führen und die betroffenen Datensätze werden nicht migriert.

Maximale Anzahl Datensätze pro Migrationsabfrage einrichten

Folgen Sie diesen Schritten, um die maximale Anzahl an Datensätzen pro Migrationsabfrage einzurichten:

  1. Navigieren zu SQL Migration Einrichtung
    • Suchen Sie in Business Central nach der Seite SQL Migration Einrichtung und rufen sie diese auf.
  2. Maximale Anzahl Datensätze einrichten
    • Öffnen Sie den Fasttab Vorgabe Pakete und geben Sie im Feld Vorgabe Max. Anzahl Datensätze Abfrage die Anzahl an Datensätzen an, welche pro Migrationsabfrage migriert werden sollen. Dieser Wert sollte zwischen 1 Mio. und 10 Mio. Datensätzen liegen.

Automatische Erstellung von Tabelenzuordnungsteilen

Folgen Sie diesen Schritten, um Tabellenzuordnungsteile automatisch zu erstellen:

  1. Navigieren zu Datenbankzuordnungen
    • Suchen Sie in Business Central nach der Seite Datenbankzuordnungen und rufen sie diese auf.
  2. Datenbankzuordnung öffnen
    • Öffnen Sie die Datenbankzuordnung, für die ein Tabellenzuordnungsteil erstellt werden soll. Die Seite Datenbankzuordnung Karte öffnet sich.
  3. Maximale Anzahl Datensätze pro Migrationsabfrage einrichten
    • Geben Sie im Feld Max. Anzahl Datensätze Abfrage die Anzahl an Datensätzen an, welche pro Migrationsabfrage migriert werden sollen. Dieser Wert sollte zwischen 1 Mio. und 10 Mio. Datensätzen liegen.
  4. Navigieren zu Tabellenzuordnungsteile
    • Klicken Sie im Aktionsmenü Tabellenzuordnungsteile der Page Datenbankzuordnungs Karte auf Tabellenzuordnungsteile. Die Seite Tabellenzuordnungsteile wird geöffnet und zeigt alle bereits vorhandenen Tabellenzuordnungsteilköpfe an.
  5. Mögliche Tabellenzuordnungen holen
    • Klicken Sie im Aktionsmenü auf Hole mögliche Tabellenzuordnungen. Es werden die bereits angelegten Mandantenzuordnungen und Tabellenzuordnungen durchlaufen und je Zielmdandant die Datensätze der entsprechnden Quelltabellen gezählt. Sollte die Anzahl der ermittelten Datensätze größer sein als die Anzahl an Datensätzen je Migrationsabfrage, wird für den Zielmandanten und die Tabellenzuordnung ein neuer Tabellenzuordnungsteilkopf angelegt. Prüfen Sie die angelegten Tabellenzuordnungsteilköpfe.
  6. Teile erstellen
    • Wählen Sie die Datensätze aus, für welche die Teile automatisch angelegt werden sollen und klicken Sie im Aktionsmenü auf Teile erstellen. Es wird nun eine SQL-Abfrage ausgeführt, welche die Teile inklusive oberer und unterer Grenze erstellt.

Tabellenzuordnungsteil manuell erstellen

Folgen Sie diesen Schritten, um Tabellenzuordnungsteile manuell zu erstellen:

  1. Navigieren zu Datenbankzuordnungen
    • Suchen Sie in Business Central nach der Seite Datenbankzuordnungen und rufen sie diese auf.
  2. Datenbankzuordnung öffnen
    • Öffnen Sie die Datenbankzuordnung, für die ein Tabellenzuordnungsteil erstellt werden soll. Die Seite Datenbankzuordnung Karte öffnet sich.
  3. Maximale Anzahl Datensätze pro Migrationsabfrage einrichten
    • Geben Sie im Feld Max. Anzahl Datensätze Abfrage die Anzahl an Datensätzen an, welche pro Migrationsabfrage migriert werden sollen. Dieser Wert sollte zwischen 1 Mio. und 10 Mio. Datensätzen liegen.
  4. Navigieren zu Tabellenzuordnungsteile
    • Klicken Sie im Aktionsmenü Tabellenzuordnungsteile der Page Datenbankzuordnungs Karte auf Tabellenzuordnungsteile. Die Seite Tabellenzuordnungsteile wird geöffnet und zeigt alle bereits vorhandenen Tabellenzuordnungsteilköpfe an.
  5. Neuen Tabellenzuordnungsteilkopf anlegen
    • Klicken Sie im Aktionsmenü auf Neu. Die Seite Tabellenzuordnungsteil Karte öffnet sich.
    • Wählen Sie im Fasttab Allgemein einen Zielmandant und eine Zieltabelle ID aus. Der dazugehörige Quellmandant wird automatisch aus der Mandantenzuordnung geholt. Die dazugehörige Quelltabelle wird automatisch aus der Tabellenzuordnung geholt.
  6. Teile erstellen
    • Legen Sie eine neue Zeile auf der Unterseite Tabellenzuordnungsteil Zeilen an.
    • Wählen Sie ein Primärschlüsselfeld im Quelle Tabellenfilter Feld 1 zum Filtern aus.
    • Geben Sie einen Filterwert in den Feldern Quelle Tabellenfilter 1 Von und Quelle Tabellenfilter 1 Bis ein. Wenn im Feld Quelle Tabellenfilter 1 Bis kein Wert angegeben ist, wird das ausgewählte Primärschlüsselfeld nur mit dem Wert aus dem Feld Quelle Tabellenfilter 1 Von gefiltert.
    • Wenn Sie möchten, können Sie ein zusätzliches Primärschlüsselfeld im Quelle Tabellenfilter Feld 2 auswählen und einen zusätzlichen Filterwert in den Feldern Quelle Tabellenfilter 2 Von und Quelle Tabellenfilter 2 Bis eingeben. Wenn im Feld Quelle Tabellenfilter 2 Bis kein Wert angegeben ist, wird das ausgewählte Primärschlüsselfeld nur mit dem Wert aus dem Feld Quelle Tabellenfilter 2 Von gefiltert.
    • Für eine weitere Tabellenzuordnungsteil erstellen Sie eine neue Zeile mit den notwendigen Filtern.
    • Achten Sie beim Verwenden der Filterfelder darauf, dass es keine Überlappungen der Filterbereiche gibt, da sonst Primärschlüsselverletzungen während der Migration auftreten könnten und die Migration für die betroffene Tabelle abgebrochen werden könnte.
  7. Tabellenzuordnungsteil Zeilen aktivieren
    • Setzen Sie Aktiviert auf wahr für die Tabellenzuordnungsteilzeile. Dies verhindert, dass alle Tabellenzuordnungsteile versehentlich ausgeführt werden.
  8. Zieldaten behalten einstellen
    • Stellen Sie Zieldaten behalten auf falsch ein, um die Löschabfrage vor der Migration auszuführen, oder stellen Sie Zieldaten behalten auf wahr, wenn die Zieldaten vor der Migration nicht gelöscht werden sollen. Standardmäßig wird bei einer Migration eine SQL-Abfrage ausgeführt, um die Daten in der Zieltabelle zu löschen. Bei Verwendung von Tabellenzuordnungsteilen würde dies jedoch dazu führen, dass bereits migrierte Daten aus einer zuvor ausgeführten Tabellenzuordnung erneut gelöscht würden.
    • Um das Löschen von zuvor migrieren Daten in der Zieltabelle zu verhindern, überprüfen Sie das Feld Zieldaten behalten für alle nachfolgenden Tabellenzuordnungsteile.
  9. Quelle Tabellenbedingung einstellen
    • Geben Sie einen SQL-Ausdruck in Quelle Tabellenbedingung oder Quelle Tabellenbedingung 2 ein, um zusätzliche Filterkriterien hinzuzufügen.
    • Klicken Sie auf den AssistEdit-Knopf, um eine Übersicht möglicher SQL-Ausdrücke und zugehöriger Beispiele zu erhalten. Die Seite SQL-Ausdrücke öffnet sich.
    • Wählen Sie ein Beispiel aus und klicken Sie auf OK, um es anzuwenden. Der Ausdruck wird übernommen und kann dann angepasst werden.
  10. Abfrage für den Tabellenzuordnungsteil erstellen und ausführen
    • Klicken Sie auf Erstelle Abfrage, Lösche Zieldaten oder Übertrage Daten in der Aktionsleiste, um die Abfrage für eine einzelne Tabellenzuordnungsteile zu erstellen (und auszuführen).

Bestehende Tabellenzuordnungsteile löschen

Folgen Sie diesen Schritten, um Tabellenzuordnungsteile zu löschen:

  1. Navigieren zu Datenbankzuordnungen
    • Suchen Sie in Business Central nach der Seite Datenbankzuordnungen und rufen sie diese auf.
  2. Datenbankzuordnung öffnen
    • Öffnen Sie die Datenbankzuordnung, für die ein Tabellenzuordnungsteil gelöscht werden soll. Die Seite Datenbankzuordnung Karte öffnet sich.
  3. Navigieren zu Tabellenzuordnungsteile
    • Klicken Sie im Aktionsmenü Tabellenzuordnungsteile der Page Datenbankzuordnungs Karte auf Tabellenzuordnungsteile. Die Seite Tabellenzuordnungsteile wird geöffnet und zeigt alle bereits vorhandenen Tabellenzuordnungsteilköpfe an.
  4. Tabellenzuordnungsteil öffnen
    • Öffnen Sie den Tabellenzuordnungsteil, für die eine Tabellenzuordnungsteilzeile gelöscht werden soll. Die Seite Tabellenzuordnungsteil Karte öffnet sich.
  5. Tabellenzuordnungsteil Zeile löschen
    • Wählen Sie die letzte Zeile auf der Unterseite Tabellenzuordnungsteil Zeilen aus und löschen Sie sie.
    • Tabellenzuordnungsteile können nur nach dem Prinzip von unten nach oben gelöscht werden. Das heißt, der Teil mit der höchsten Nummer muss zuerst gelöscht werden, bevor die anderen Teile gelöscht werden können.

Nächster Schritt

SQL-Ausdrücke