Share via

Een KQL-databasebestemming toevoegen aan een eventstream

  • Artikel

In dit artikel leest u hoe u een KQL-database als bestemming toevoegt aan een eventstream in Microsoft Fabric-gebeurtenisstromen.

Notitie

Als u verbeterde mogelijkheden wilt gebruiken die in preview zijn, selecteert u Bovenaan verbeterde mogelijkheden . Anders selecteert u Standaardmogelijkheden. Zie Inleiding tot fabric-gebeurtenisstromen voor meer informatie over verbeterde mogelijkheden die in preview zijn.

Vereisten

  • Toegang tot de Fabric Premium-werkruimte waar uw eventstream zich bevindt met inzender - of hogere machtigingen.
  • Toegang tot een KQL-database die is gemaakt in een Fabric Premium-werkruimte waarvoor u inzender- of hogere machtigingen hebt.

Notitie

Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.

Een KQL-database toevoegen als doel

Als u een KQL-database als bestemming wilt toevoegen, kunt u kiezen tussen twee opnamemodi: Directe opname of gebeurtenisverwerking vóór opname.

Directe opnamemodus

De modus voor directe opname neemt uw gebeurtenisgegevens rechtstreeks op in de KQL-database zonder enige verwerking. U kunt de directe opnamemodus gebruiken om een KQL-databasebestemming toe te voegen aan uw standaardstream.

Belangrijk

U kunt direct opnemen alleen gebruiken voor uw standaardstream. Directe opname kan geen verwerkingsoperators of afgeleide streams volgen. Als u een KQL-databasebestemming wilt toevoegen na verwerkingsoperators of afgeleide streams, gebruikt u in plaats daarvan gebeurtenisverwerking voordat u gegevens opneemt .

  1. Selecteer in de bewerkingsmodus voor uw eventstream de optie Bestemming toevoegen op het lint of selecteer de transformatiegebeurtenissen of voeg doelkaart toe op het canvas en selecteer vervolgens KQL-database.

    Een schermopname van het selecteren van de KQL-database in de vervolgkeuzelijst Bestemming toevoegen.

  2. Selecteer Direct opnemen in het scherm KQL-database.

  3. Voer een doelnaam, een werkruimte en een KQL-database in vanuit de geselecteerde werkruimte.

  4. Selecteer Opslaan.

    Een schermopname van het scherm voor de configuratie van de KQL-database.

  5. Verbinding maken de nieuwe KQL Database-doelkaart naar de uitvoer van uw eventstream als deze nog niet is verbonden en selecteert u Publiceren.

    Een schermopname van de eventstream met de knop Publiceren gemarkeerd.

  6. Selecteer configureren in de liveweergave in het doelknooppunt van de KQL-database.

    Een schermopname van de gepubliceerde gebeurtenisstream met de knop Configureren in het KQL Database-doel gemarkeerd.

  7. De KQL-database wordt geopend in het scherm Gegevens ophalen. Selecteer een bestaande tabel van de KQL-database of selecteer Nieuwe tabel om een nieuwe te maken om de gegevens te routeren en op te nemen.

  8. Geef een naam op voor de gegevensverbinding of behoud de opgegeven naam en selecteer vervolgens Volgende. Het kan enkele minuten duren voordat gegevens uit de eventstream worden opgehaald.

    Een schermopname van het scherm Gegevens ophalen voor de bestemming van de KQL-database, met de knop Volgende gemarkeerd.

  9. Op het scherm Gegevens controleren kunt u het volgende doen:

    • Selecteer een indeling om een voorbeeld te bekijken van hoe de gegevens naar uw KQL-database worden verzonden.
    • Selecteer Kolommen bewerken om de kolommen voor uw gegevens te configureren.
    • Selecteer Geavanceerd om gebeurtenissen te selecteren die u wilt opnemen of om toewijzingsopties te kiezen.

    Een schermopname met de gegevensindelingen en geavanceerde opties op het scherm Gegevens controleren.

  10. Als u Kolommen bewerken selecteert, kunt u het volgende doen in het scherm Kolommen bewerken:

    • Selecteer Kolom toevoegen om een kolom toe te voegen.
    • Selecteer Bronkolommen die u wilt toewijzen.
    • Pas toewijzingstransformatie toe op kolommen.
    • Voorbeeldgegevenswaarden wijzigen.

    Selecteer vervolgens Toepassen.

    Een schermopname van het scherm Kolommen bewerken.

  11. Wanneer u klaar bent met het configureren van de gegevens, selecteert u Voltooien op het scherm Gegevens controleren.

  12. Bekijk in het scherm Samenvatting de details en status van uw gegevensopname, inclusief de tabel met het schema dat u hebt gedefinieerd en de verbinding tussen de eventstream en de KQL-database. Selecteer Sluiten om de installatie van de KQL-database te voltooien.

    Een schermopname van het scherm Samenvatting met de knop Sluiten gemarkeerd.

U kunt nu het KQL-databasedoel zien op het canvas in liveweergave.

Een schermopname van de geconfigureerde KQL-databasebestemming in de liveweergave.

Gebeurtenisverwerking vóór opname

De gebeurtenisverwerking vóór de opnamemodus verwerkt uw gebeurtenisgegevens voordat deze worden opgenomen in de KQL-database. Gebruik deze modus als u operators zoals filteren of aggregatie toepast om de gegevens vóór opname of na een afgeleide stroom te verwerken.

  1. Beweeg in de bewerkingsmodus voor uw eventstream de muisaanwijzer over een operator of afgeleide stroom, selecteer +en selecteer vervolgens KQL-database.

    Een schermopname van het selecteren van het plusteken voor de operatoruitvoer en het selecteren van KQL-database.

  2. Op het scherm KQL-database moet gebeurtenisverwerking vóór opname al zijn geselecteerd. Voltooi de rest van de informatie over uw KQL-database en selecteer Opslaan.

    Een schermopname van het scherm voor de configuratie van de KQL-database voor gebeurtenisverwerking voordat deze wordt opgenomen.

  3. Als u het zojuist toegevoegde KQL-databasedoel wilt implementeren, selecteert u Publiceren.

    Een schermopname van de eventstream in de bewerkingsmodus, waarbij het KQL Database-doel is toegevoegd.

Zodra u deze stappen hebt voltooid, is de eventstream met KQL Database-bestemming beschikbaar voor visualisatie in de liveweergave.

Een schermopname van de geconfigureerde KQL Database-gebeurtenisverwerkingsstroom in liveweergave.

Gerelateerde inhoud

Zie de volgende artikelen voor meer informatie over het toevoegen van andere bestemmingen aan een eventstream:

Vereisten

Voordat u begint, moet u de volgende vereisten voltooien:

  • Krijg toegang tot een Premium-werkruimte met inzender- of bovenstaande machtigingen waar uw eventstream zich bevindt.
  • Toegang tot een Premium-werkruimte met inzender - of bovenstaande machtigingen waar uw KQL-database zich bevindt.

Notitie

Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.

Een KQL-database toevoegen als doel

Als u een KQL-database als bestemming wilt toevoegen, moet u een KQL-database hebben gemaakt in de werkruimte en kiezen tussen twee opnamemodi: Directe opname en gebeurtenisverwerking voordat deze wordt opgenomen.

Directe opname

In deze modus worden uw gebeurtenisgegevens rechtstreeks opgenomen in de KQL-database zonder enige verwerking. U kunt deze modus gebruiken als u uw gebeurtenisgegevens als zodanig wilt opnemen en elke verwerking of transformatie later in KQL-database wilt uitvoeren met behulp van KQL-query's.

  1. Selecteer Nieuwe bestemming op het lint of '+' in het hoofdeditorcanvas en selecteer vervolgens KQL-database. Het scherm voor de configuratie van de KQL-databaselocatie wordt weergegeven.

  2. Selecteer Directe opname, voer een doelnaam in, selecteer een werkruimte, kies een KQL-database in de geselecteerde werkruimte en selecteer vervolgens Toevoegen en configureren.

    Notitie

    U kunt alleen werkruimten selecteren met dezelfde regio-infrastructuurcapaciteit als de eventstream.

    Schermopname van het doelconfiguratiescherm voor de pull-modus van de KQL-database.

  3. Navigeer op de pagina Gegevens ophalen door de tabbladen om de configuratie te voltooien:

    1. Configureren: Gebruik een bestaande tabel van uw KQL-database of maak een nieuwe tabel om de gegevens te routeren en op te nemen. Vul de vereiste velden in en selecteer Volgende.

      Schermopname van het tabblad Bestemming van het scherm Gegevens opnemen voor het maken van een KQL-databasebestemming.

    2. Inspect: Selecteer een gegevensindeling en bekijk hoe de gegevens naar uw KQL-database worden verzonden.

      Schermopname van de gegevensindeling van het scherm Gegevens opnemen voor het maken van een KQL-databasebestemming.

      U kunt ook de kolomnaam, het gegevenstype of de kolom bijwerken door op de pijl in de tabelkop te klikken. Vul de vereiste velden in en selecteer Voltooien.

      Schermopname die laat zien hoe u de kolom van het scherm Gegevens opnemen wijzigt voor het maken van een KQL-databasebestemming.

      Schermopname van de naam van de kolom, het gegevenstype van het scherm Gegevens opnemen voor het maken van een KQL-databasebestemming.

    3. Samenvatting: Controleer de status van uw gegevensopname, inclusief de tabel die is gemaakt met het schema dat u hebt gedefinieerd en de verbinding tussen de eventstream en de KQL-database.

      Schermopname van het tabblad Samenvatting van het scherm Gegevens opnemen voor het maken van een KQL-databasebestemming.

  4. Nadat u alles hebt geconfigureerd en Sluiten hebt geselecteerd, wordt een KQL-databasebestemming weergegeven op het canvas, verbonden met uw eventstream.

    Schermopname van het nieuwe doel van de pull-modus van de KQL-database.

Gebeurtenisverwerking vóór opname

In deze modus worden uw gebeurtenisgegevens verwerkt voordat u deze opneemt in de KQL-database. U kunt deze modus gebruiken als u bepaalde verwerking of transformatie wilt toepassen op uw gebeurtenisgegevens voordat u deze opneemt, zoals filteren, samenvoegen of uitbreiden. U kunt de verwerkingslogica ontwerpen met behulp van gebeurtenisprocessor.

  1. Selecteer Gebeurtenisverwerking vóór opname, vul de informatie over uw KQL-database in en selecteer vervolgens Gebeurtenisprocessor openen.

    Schermopname van het doelconfiguratiescherm voor de doelconfiguratie van de KQL-database.

  2. Ontwerp de gebeurtenisverwerking met gebeurtenisprocessor en selecteer Opslaan

    Schermopname van het scherm voor gebeurtenisprocessor in de pushmodus.

  3. Wanneer u een bestaande Kusto-tabel kiest, wordt schemavalidatie tussen het huidige schema in deze eventstream en de doel-KQL-tabel uitgevoerd. Als de twee schema's niet overeenkomen, wordt een foutbericht weergegeven en wordt u eraan herinnerd om de gebeurtenisprocessor te openen om het schema in deze eventstream dienovereenkomstig aan te passen.

    Schermopname van het foutscherm van de gebeurtenisprocessor in de pushmodus.

    Wanneer u de gebeurtenisprocessor opent, wordt de gedetailleerde informatie over niet-overeenkomende gegevens weergegeven op het tabblad Fout bij ontwerpen.

    Schermopname van het gebeurtenisprocessor in de pushmodus die niet overeenkomt met het informatiescherm.

  4. Nadat u alles hebt geconfigureerd en Opslaan hebt geselecteerd, wordt een KQL-databasebestemming weergegeven op het canvas, verbonden met uw eventstream en kunt u de metrische gegevens controleren in de gegevensinzichten en logboeken in Runtime-logboeken.

    Schermopname van het nieuwe doel van de KQL-databasepushmodus.

Een bestemming beheren

Bewerken/verwijderen: u kunt een eventstream-bestemming bewerken of verwijderen via het navigatiedeelvenster of canvas.

Wanneer u Bewerken selecteert, wordt het bewerkingsvenster aan de rechterkant van de hoofdeditor geopend. U kunt de configuratie naar wens wijzigen, inclusief de logica voor gebeurtenistransformatie via de editor van de gebeurtenisprocessor.

Schermopname die laat zien waar u de opties voor wijzigen en verwijderen voor bestemmingen op het canvas selecteert.

Gerelateerde inhoud

Zie de volgende artikelen voor meer informatie over het toevoegen van andere bestemmingen aan een eventstream: