Panoramica della libreria di inserimento Kusto

La libreria di inserimento Kusto fornisce un client per l'inserimento dei dati nel cluster. La libreria supporta l'inserimento diretto e in coda. I metodi di inserimento sono definiti dall'oggetto client di inserimento Kusto.

Per un elenco di interfacce e classi, vedere Informazioni di riferimento sul client di inserimento Kusto.

Ottenere la libreria

Selezionare la scheda per la lingua preferita.

Autorizzazioni

Per inserire i dati in tabelle esistenti, è necessario disporre almeno delle autorizzazioni Database Ingestor o Table Ingestor. Per creare una tabella, è necessario disporre almeno delle autorizzazioni Utente database. Per altre informazioni, vedere Controllo degli accessi in base al ruolo.

Inserimento in coda

Il client di inserimento in coda riduce al minimo le dipendenze del codice client nel servizio di inserimento Esplora dati di Azure. In questa modalità, l'inserimento viene eseguito inviando un messaggio di inserimento a una coda di Azure, che viene successivamente elaborato dal servizio di inserimento di Azure Esplora dati. Se sono necessari elementi di archiviazione intermedi, il client di inserimento li genera usando le risorse fornite dal servizio di inserimento.

L'inserimento in coda consente di rendere persistenti le richieste di inserimento quando il servizio di inserimento di Azure Esplora dati non è disponibile e consente al servizio di inserimento di gestire il carico di inserimento nel cluster. Questo metodo fornisce un meccanismo per tenere traccia dello stato e del risultato di ogni richiesta di inserimento, ritentare l'inserimento in errori temporanei e migliorare le prestazioni grazie a un'aggregazione efficiente e controllabile sui dati in ingresso.

Inserimento diretto

Il client di inserimento diretto richiede l'interazione diretta con il servizio di inserimento Esplora dati di Azure. In questa modalità, il servizio di inserimento non modera o gestisce i dati. Ogni richiesta di inserimento viene convertita in un comando eseguito direttamente nel servizio. Quando vengono usati metodi sincroni, il completamento del metodo indica la fine dell'operazione di inserimento.

L'inserimento diretto ha una bassa latenza e non comporta l'aggregazione. Tuttavia, il codice client deve implementare la logica di ripetizione dei tentativi o di gestione degli errori e il codice client potrebbe sovraccaricare il cluster con le richieste perché non è a conoscenza della capacità.

Nota

Non è consigliabile l'inserimento diretto per le soluzioni di livello di produzione.