Delen via


Overzicht van Kusto Ingest-bibliotheek

De Kusto Ingest-bibliotheek biedt een client voor het opnemen van gegevens in uw cluster. De bibliotheek biedt ondersteuning voor in de wachtrij geplaatste en directe opname. De opnamemethoden worden gedefinieerd door het clientobject Kusto-opname.

Zie Kusto Ingest-clientreferentie voor een lijst met interfaces en klassen.

De bibliotheek ophalen

Selecteer het tabblad voor uw voorkeurstaal.

Machtigingen

Als u gegevens wilt opnemen in bestaande tabellen, moet u ten minste de machtigingen Database Ingestor of Table Ingestor hebben. Als u een tabel wilt maken, moet u ten minste machtigingen voor databasegebruiker hebben. Zie Op rollen gebaseerd toegangsbeheer voor meer informatie.

Opname via een wachtrij

De opnameclient in de wachtrij minimaliseert de afhankelijkheden van clientcode op de Azure Data Explorer-opnameservice. In deze modus wordt opname uitgevoerd door een opnamebericht in te dienen bij een Azure-wachtrij, die vervolgens wordt verwerkt door de Azure Data Explorer opnameservice. Als er tussenliggende opslagitems zijn vereist, genereert de opnameclient deze met behulp van de resources die door de opnameservice worden geleverd.

Met opname in de wachtrij kunnen de opnameaanvragen worden opgeslagen wanneer de Azure Data Explorer-opnameservice niet beschikbaar is en kan de opnameservice de opnamebelasting van uw cluster beheren. Deze methode biedt een mechanisme voor het bijhouden van de voortgang en het resultaat van elke opnameaanvraag, voert de opname opnieuw uit bij tijdelijke fouten en verbetert de prestaties door een efficiƫnte en controleerbare aggregatie van binnenkomende gegevens.

Directe opname

De client voor directe opname vereist directe interactie met de Azure Data Explorer-opnameservice. In deze modus beheert de opnameservice de gegevens niet. Elke opnameaanvraag wordt omgezet in een opdracht die rechtstreeks op de service wordt uitgevoerd. Wanneer synchrone methoden worden gebruikt, geeft de voltooiing van de methode het einde van de opnamebewerking aan.

Directe opname heeft een lage latentie en heeft geen betrekking op aggregatie. De clientcode moet echter logica voor opnieuw proberen of foutafhandeling implementeren en de clientcode kan het cluster overbelasten met aanvragen omdat het niet op de hoogte is van de capaciteit.

Notitie

We raden de directe opname niet aan voor oplossingen op basis van productiekwaliteit.