Redigera ett tabellschema

I den här artikeln får du lära dig hur du byter namn på tabeller och redigerar schemat för en tabell genom att lägga till, byta namn på och ta bort kolumner. Den beskriver konsekvenserna och beroendena av tabellschemaändringar på refererade objekt och mappningar.

Försiktighet

  • Befintliga inmatningar, inmatningsmappningar, uppdateringsprinciper, funktioner, exporter, materialiserade vyer och andra relaterade åtgärder kan misslyckas när du har redigerat tabellschemat. Se Beroenden och se till att du redigerar implementeringen av inmatningsmappningar, uppdateringsprinciper, funktioner, export och materialiserade vyer i enlighet med detta.

Beroenden

Redigering av tabellschemat kan orsaka inmatnings- och frågefel på grund av beroenden som refererar till tabellnamnet eller tabellkolumnerna. Följande matris anger konsekvenserna av schemaredigeringar.

Schemaredigering Beroende
Byta namn på tabeller Materialiserade vyer:
* Som standard uppdateras alla materialiserade vyer som direkt refererar till det gamla tabellnamnet så att de pekar på det nya namnet på ett transaktionellt sätt.
* Om tabellnamnet refereras från en lagrad funktion som anropas av vyfrågan måste du uppdatera referensen för den materialiserade vyn manuellt med hjälp av .alter materialized-view.
Byta namn på kolumner * Om du byter namn på en kolumn uppdateras automatiskt alla referenser till den i inmatningsmappningar.
* Om du byter namn på en kolumn bevaras alla befintliga transformeringar i dina mappningar.
Lägga till kolumner * Om du lägger till en ny kolumn uppdateras inte automatiskt inmatningsmappningar. Om du vill att den nya kolumnen ska inkluderas måste du uppdatera mappningarna manuellt.
* När schemat redigeras uppdateras inte mappningen av inkommande data till tabellkolumner under inmatningen.
* När du har lagt till kolumner kontrollerar du att du uppdaterar mappningen så att data matas in korrekt.
Mer information om hur du uppdaterar inmatningsmappning finns i .alter ingestion mapping command
Kolumntyp Redigering av en kolumntyp stöds inte med alternativet Redigera tabellschema, eftersom en ändring av en kolumntyp skulle leda till dataförlust.
Ta bort kolumner * Om du tar bort en kolumn tas kolumnen bort från alla inmatningsmappningar.
* Att ta bort en kolumn är oåterkalleligt och orsakar dataförlust. Du kan inte fråga efter data i den borttagna kolumnen.
* Försiktighet Om du tar bort en kolumn, sparar och sedan lägger till den igen återställs inte data. Den fungerar som en ny kolumn och inmatningsmappningar uppdateras inte. Du måste uppdatera inmatningsmappningarna manuellt.

Förutsättningar

Byt namn på en tabell

När du byter namn på en tabell uppdateras alla referenser till tabellen i dina inmatningsmappningar automatiskt. I vissa fall måste du uppdatera tabellmappningar och referenser manuellt. Granska Beroenden innan du byter namn på en tabell.

  1. Bläddra till önskad KQL-databas och expandera Tabeller i explorer-fönstret.

  2. Välj en tabell i listan och öppna menyn Mer [...].

    Skärmbild av menyn Mer i tabellen med Redigera schema markerat.

  3. I fönstret Redigera tabellschema redigerar du tabellnamnet. Du kan också redigera tabellbeskrivningen.

    Skärmbild av redigeringstabellschemat med fältet tabellnamn markerat.

  4. I avsnittet Beroenden granskar du de refererade objekten.

    • Som standard är automatisk uppdatering av materialiserade vyer aktiverat. Du kan visa uppdateringarna av kommandot i kommandovisningsprogrammet.

    • Om det behövs inaktiverar du Automatisk uppdatering av materialiserade vyer. Kontrollera att du granskar konsekvenserna i beroenden och uppdaterar tabellinmatningsmappningen manuellt om det behövs.

    Skärmbild av kommandovisaren och avsnittet beroenden med växlingsknappen för automatisk uppdatering av materialiserade vyer markerad.

  5. Välj Uppdatera och i bekräftelsefönstret anger du tabellnamnet igen och väljer Redigera tabellschema.

    Skärmbild av bekräftelsefönstret med fältet tabellnamn markerat.

Redigera tabellkolumner

När du byter namn på eller lägger till kolumner i en tabell uppdateras alla referenser till tabellen i dina inmatningsmappningar automatiskt. I vissa fall måste du uppdatera tabellmappningar och referenser manuellt. Granska Beroenden innan du redigerar tabellkolumnerna.

  1. Bläddra till önskad KQL-databas. I utforskarfönstret expanderar du Tabeller.

  2. Välj en tabell i listan och öppna menyn Mer [...].

    Skärmbild av menyn Mer i tabellen med Redigera schema markerat.

  3. Om du vill lägga till en ny kolumn anger du ett kolumnnamn längst ned i listan med kolumner. Kolumnnamnet måste börja med en bokstav och kan innehålla tal, punkter, bindestreck eller understreck.

  4. Välj en datatyp för kolumnen. Standardkolumntypen är string men du kan ändra den i den nedrullningsbara menyn i fältet Kolumntyp .

  5. Välj Lägg till kolumn för att lägga till fler kolumner.

  6. I avsnittet Beroenden granskar du de refererade objekten.

    • Som standard är automatiska uppdateringsmappningar aktiverade. Du kan visa uppdateringarna av inmatningsmappningskommandot i kommandovisningsprogrammet.

    • Om det behövs inaktiverar du Automatiska uppdateringsmappningar. Kontrollera att du granskar konsekvenserna i beroenden och uppdaterar tabellinmatningsmappningen manuellt om det behövs.

    Skärmbild av kommandovisningsprogrammet med automatiska uppdateringsmappningar aktiverade i avsnittet beroenden.

  7. Uppdatera vid behov datainmatningsmappningen.