Partager via


Vue d’ensemble de la bibliothèque Kusto Ingest

La bibliothèque Kusto Ingest fournit un client pour l’ingestion de données dans votre cluster. La bibliothèque prend en charge l’ingestion directe et en file d’attente. Les méthodes d’ingestion sont définies par l’objet client d’ingestion Kusto.

Pour obtenir la liste des interfaces et des classes, consultez Informations de référence sur le client Kusto Ingest.

Obtenir la bibliothèque

Sélectionnez l’onglet correspondant à votre langue préférée.

Autorisations

Pour ingérer des données dans des tables existantes, vous devez disposer d’au moins des autorisations d’ingestion de base de données ou d’ingestion de table. Pour créer une table, vous devez disposer d’au moins des autorisations d’utilisateur de base de données. Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle.

Ingestion en file d’attente

Le client ingéré en file d’attente réduit les dépendances du code client sur le service d’ingestion Azure Data Explorer. Dans ce mode, l’ingestion s’effectue en envoyant un message d’ingestion à une file d’attente Azure, qui est ensuite traité par le service d’ingestion Azure Data Explorer. Si des éléments de stockage intermédiaires sont nécessaires, le client d’ingestion les génère à l’aide des ressources fournies par le service d’ingestion.

L’ingestion en file d’attente permet de conserver les demandes d’ingestion lorsque le service d’ingestion Azure Data Explorer n’est pas disponible et permet au service d’ingestion de gérer la charge d’ingestion sur votre cluster. Cette méthode fournit un mécanisme permettant de suivre la progression et le résultat de chaque demande d’ingestion, de réessayer l’ingestion en cas d’échecs temporaires et d’améliorer les performances par une agrégation efficace et contrôlable sur les données entrantes.

Ingestion directe

Le client d’ingestion directe nécessite une interaction directe avec le service d’ingestion Azure Data Explorer. Dans ce mode, le service d’ingestion ne modère ni ne gère les données. Chaque demande d’ingestion est traduite en une commande exécutée directement sur le service. Lorsque des méthodes synchrones sont utilisées, l’achèvement de la méthode indique la fin de l’opération d’ingestion.

L’ingestion directe a une faible latence et n’implique pas d’agrégation. Toutefois, le code client doit implémenter une logique de gestion des nouvelles tentatives ou des erreurs, et le code client peut surcharger le cluster de requêtes, car il n’est pas conscient de la capacité.

Notes

Nous ne recommandons pas l’ingestion directe pour les solutions de qualité de production.