Übersicht über die Kusto-Erfassungsbibliothek

Die Kusto-Erfassungsbibliothek stellt einen Client zum Erfassen von Daten in Ihrem Cluster bereit. Die Bibliothek unterstützt die Warteschlange und die direkte Erfassung. Die Erfassungsmethoden werden vom Kusto-Erfassungsclientobjekt definiert.

Eine Liste der Schnittstellen und Klassen finden Sie unter Kusto Ingest-Clientreferenz.

Abrufen der Bibliothek

Wählen Sie die Registerkarte für Ihre bevorzugte Sprache aus.

Installieren Sie Microsoft.Azure.Kusto.Ingest.

Berechtigungen

Zum Erfassen von Daten in vorhandenen Tabellen müssen Sie mindestens über Database Ingestor- oder Table Ingestor-Berechtigungen verfügen. Zum Erstellen einer Tabelle müssen Sie mindestens über Datenbankbenutzerberechtigungen verfügen. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung mit Microsoft Intune.

Erfassung aus der Warteschlange

Der In die Warteschlange eingereihte Erfassungsclient minimiert die Abhängigkeiten von Clientcode vom Azure Data Explorer Erfassungsdienst. In diesem Modus erfolgt die Erfassung durch Senden einer Erfassungsnachricht an eine Azure-Warteschlange, die anschließend vom Azure Data Explorer Erfassungsdienst verarbeitet wird. Wenn Zwischenspeicherelemente erforderlich sind, generiert der Erfassungsclient diese mithilfe der vom Erfassungsdienst bereitgestellten Ressourcen.

Mit der Erfassung in die Warteschlange können die Erfassungsanforderungen beibehalten werden, wenn der Azure Data Explorer Erfassungsdienst nicht verfügbar ist, und der Erfassungsdienst ermöglicht es dem Erfassungsdienst, die Erfassungslast in Ihrem Cluster zu verwalten. Diese Methode bietet einen Mechanismus, um den Fortschritt und das Ergebnis jeder Erfassungsanforderung nachzuverfolgen, die Erfassung bei vorübergehenden Fehlern erneut durchzuführen und die Leistung durch effiziente und steuerbare Aggregation eingehender Daten zu verbessern.

Direkte Erfassung

Der Client für die direkte Erfassung erfordert eine direkte Interaktion mit dem Azure Data Explorer Erfassungsdienst. In diesem Modus moderieren oder verwaltet der Erfassungsdienst die Daten nicht. Jede Erfassungsanforderung wird in einen Befehl übersetzt, der direkt im Dienst ausgeführt wird. Wenn synchrone Methoden verwendet werden, gibt die Methodenerfüllung das Ende des Erfassungsvorgangs an.

Die direkte Erfassung hat eine geringe Latenz und beinhaltet keine Aggregation. Der Clientcode muss jedoch Wiederholungs- oder Fehlerbehandlungslogik implementieren, und der Clientcode könnte den Cluster mit Anforderungen überlasten, da er die Kapazität nicht kennt.

Hinweis

Die direkte Erfassung für Produktionslösungen wird nicht empfohlen.