Bearbeiten eines Tabellenschemas

In diesem Artikel erfahren Sie, wie Sie Tabellen umbenennen und das Schema einer Tabelle bearbeiten, indem Sie Spalten hinzufügen, umbenennen und entfernen. Es beschreibt die Auswirkungen und Abhängigkeiten von Tabellenschemaänderungen für referenzierte Objekte und Zuordnungen.

Vorsicht

  • Vorhandene Datenimporte, Importzuordnungen, Aktualisierungsrichtlinien, Funktionen, Exporte, materialisierte Ansichten und andere verwandte Vorgänge können nach der Bearbeitung des Tabellenschemas fehlschlagen. Siehe Abhängigkeiten, und stellen Sie sicher, dass Sie die Implementierung der Erfassungszuordnungen, Aktualisierungsrichtlinien, Funktionen, Exporte und materialisierten Ansichten entsprechend anpassen.

Abhängigkeiten

Das Bearbeiten des Tabellenschemas kann aufgrund von Abhängigkeiten, die auf den Tabellennamen oder die Tabellenspalten verweisen, zu Aufnahme- und Abfragefehlern führen. Die folgende Matrix gibt die Auswirkungen von Schemabearbeitungen an.

Schemabearbeitung Abhängigkeit
Umbenennen von Tabellen Materialisierte Ansichten:
* Standardmäßig werden alle materialisierten Ansichten, die direkt auf den alten Tabellennamen verweisen, aktualisiert, um auf den neuen Namen zu verweisen, auf transaktionsale Weise.
* Wenn auf den Tabellennamen von einer gespeicherten Funktion verwiesen wird, die von der Ansichtsabfrage aufgerufen wird, müssen Sie den materialisierten Ansichtsverweis manuell mithilfe von . alter materialized-view aktualisieren.
Umbenennen von Spalten * Durch das Umbenennen einer Spalte werden automatisch alle Verweise auf die Spalte in Aufnahmezuordnungen aktualisiert.
* Das Umbenennen einer Spalte behält alle vorhandenen Transformationen in Ihren Zuordnungen bei.
Hinzufügen von Spalten * Das Hinzufügen einer neuen Spalte aktualisiert Ingestionszuordnungen nicht automatisch. Wenn die neue Spalte einbezogen werden soll, müssen Sie die Zuordnungen manuell aktualisieren.
* Das Bearbeiten des Schemas aktualisiert während der Aufnahme nicht die Zuordnung der eingehenden Daten zu den Tabellenspalten.
* Stellen Sie nach dem Hinzufügen von Spalten sicher, dass die Zuordnung aktualisiert wird, damit die Daten korrekt verarbeitet werden.
Weitere Informationen zum Aktualisieren der Erfassungszuordnung finden Sie unter ".alter ingestion mapping command"
Spaltentyp Das Bearbeiten eines Spaltentyps wird nicht mit der Option "Tabellenschema bearbeiten" unterstützt, da das Ändern eines Spaltentyps zu Datenverlust führen würde.
Entfernen von Spalten * Beim Löschen einer Spalte wird die Spalte aus allen Aufnahmezuordnungen entfernt.
* Das Löschen einer Spalte ist unumkehrbar und verursacht Datenverlust. Sie können keine Daten in der entfernten Spalte abfragen.
* Vorsicht Wenn Sie eine Spalte löschen, speichern und dann erneut hinzufügen, werden die Daten nicht wiederhergestellt. Es verhält sich wie eine neue Spalte und die Ingestion-Zuordnungen werden nicht aktualisiert. Sie müssen die Aufnahmezuordnungen manuell aktualisieren.

Voraussetzungen

Umbenennen einer Tabelle

Wenn Sie eine Tabelle umbenennen, werden alle Verweise auf diese Tabelle in Ihren Aufnahmezuordnungen automatisch aktualisiert. In einigen Fällen müssen Sie Tabellenzuordnungen und -verweise manuell aktualisieren. Überprüfen Sie vor dem Umbenennen einer Tabelle Abhängigkeiten.

  1. Navigieren Sie zu Ihrer gewünschten KQL-Datenbank, und erweitern Sie im Explorer-Bereich "Tabellen".

  2. Wählen Sie eine Tabelle aus der Liste aus, und öffnen Sie das Menü "Weitere" [...].

    Screenshot des Menüs

  3. Bearbeiten Sie im Fenster "Tabellenschema bearbeiten" den Tabellennamen. Bearbeiten Sie optional die Tabellenbeschreibung.

    Screenshot des Schemas

  4. Überprüfen Sie im Abschnitt "Abhängigkeiten" die referenzierten Objekte.

    • Standardmäßig ist " Materialisierte Ansichten automatisch aktualisieren " aktiviert. Sie können die Aktualisierungen des Befehls in der Befehlsanzeige anzeigen.

    • Deaktivieren Sie bei Bedarf die automatisch aktualisierten materialisierten Ansichten. Überprüfen Sie die Auswirkungen in Abhängigkeiten und aktualisieren Sie das Tabellen-Ingestions-Mapping bei Bedarf manuell.

    Screenshot der Befehlsanzeige und des Abschnitts

  5. Wählen Sie "Aktualisieren" aus, und geben Sie im Bestätigungsfenster den Tabellennamen erneut ein, und wählen Sie " Tabellenschema bearbeiten" aus.

    Screenshot des Bestätigungsfensters, in dem das Feld

Tabellenspalten bearbeiten

Wenn Sie einer Tabelle Spalten umbenennen oder hinzufügen, werden alle Verweise auf diese Tabelle in Ihren Aufnahmezuordnungen automatisch aktualisiert. In einigen Fällen müssen Sie Tabellenzuordnungen und -verweise manuell aktualisieren. Überprüfen Sie vor dem Bearbeiten der Tabellenspalten Abhängigkeiten.

  1. Navigieren Sie zu Ihrer gewünschten KQL-Datenbank. Erweitern Sie im Explorer-Bereich "Tabellen".

  2. Wählen Sie eine Tabelle aus der Liste aus, und öffnen Sie das Menü "Weitere" [...].

    Screenshot des Menüs

  3. Wenn Sie eine neue Spalte hinzufügen möchten, geben Sie unten in der Liste der Spalten einen Spaltennamen ein. Der Spaltenname muss mit einem Buchstaben beginnen und kann Zahlen, Punkte, Bindestriche oder Unterstriche enthalten.

  4. Wählen Sie einen Datentyp für Ihre Spalte aus. Der Standardspaltentyp ist string jedoch, Sie können ihn aber im Dropdownmenü des Felds "Spaltentyp " ändern.

  5. Wählen Sie Spalte hinzufügen aus, um weitere Spalten hinzuzufügen.

  6. Überprüfen Sie im Abschnitt "Abhängigkeiten" die referenzierten Objekte.

    • Standardmäßig ist die automatische Aktualisierungszuordnung aktiviert. Sie können die Aktualisierungen des Aufnahmezuordnungsbefehls im Befehlsanzeige anzeigen.

    • Deaktivieren Sie bei Bedarf automatische Aktualisierungszuordnungen. Überprüfen Sie die Auswirkungen in Abhängigkeiten und aktualisieren Sie das Tabellen-Ingestions-Mapping bei Bedarf manuell.

    Screenshot der Befehlsanzeige mit aktivierten automatischen Aktualisierungszuordnungen im Abschnitt

  7. Aktualisieren Sie bei Bedarf die Datenaufnahmezuordnung.