Delen via

HTTP-aanvraag voor streamingopname

  • Artikel

Werkwoord en resource aanvragen

Bewerking HTTP-woord HTTP-resource
Opnemen POST /v1/rest/ingest/{database}/{table}?{additional parameters}

Aanvraagparameters

Parameter Beschrijving Vereist/optioneel
{database} Naam van de doeldatabase voor de opnameaanvraag Vereist
{table} Naam van de doeltabel voor de opnameaanvraag Vereist

Aanvullende parameters

Aanvullende parameters worden opgemaakt als URL-queryparen {name}={value} , gescheiden door het & teken.

Parameter Beschrijving Vereist/optioneel
streamFormat Hiermee geeft u de indeling van de gegevens in de aanvraagtekst. De waarde moet een van de volgende zijn: , , , , SOHsv, PSVJSON, MultiJSON, Avro. SCsvTSVCSV Zie Ondersteunde gegevensindelingen voor meer informatie. Vereist
mappingName De naam van de vooraf gemaakte opnametoewijzing die is gedefinieerd in de tabel. Zie Gegevenstoewijzingen voor meer informatie. De manier waarop u vooraf gemaakte toewijzingen in de tabel kunt beheren, wordt hier beschreven. Optioneel, maar vereist als streamFormat een van JSON, MultiJSONof Avro

Als u bijvoorbeeld gegevens in CSV-indeling wilt opnemen in een tabel Logs in de database Test, gebruikt u:

POST https://help.kusto.windows.net/v1/rest/ingest/Test/Logs?streamFormat=Csv HTTP/1.1

Als u gegevens in JSON-indeling wilt opnemen met een vooraf gemaakte toewijzing mylogmapping, gebruikt u:

POST https://help.kusto.windows.net/v1/rest/ingest/Test/Logs?streamFormat=Json&mappingName=mylogmapping HTTP/1.1

Aanvraagheaders

De volgende tabel bevat de algemene headers voor query- en beheerbewerkingen.

Standaardkoptekst Description Vereist/optioneel
Accept Stel deze waarde in op application/json. Optioneel
Accept-Encoding Ondersteunde coderingen zijn gzip en deflate. Optioneel
Authorization Zie verificatie. Vereist
Connection Schakel Keep-Alive in. Optioneel
Content-Length Geef de lengte van de aanvraagbody op, indien bekend. Optioneel
Content-Encoding Ingesteld op gzip , maar de hoofdtekst moet gzip-gecomprimeerd zijn Optioneel
Expect Ingesteld op 100-Continue. Optioneel
Host Stel in op de domeinnaam waarnaar u de aanvraag hebt verzonden help.kusto.windows.net(zoals ). Vereist

De volgende tabel bevat de algemene aangepaste headers voor query- en beheerbewerkingen. Tenzij anders aangegeven, zijn de headers alleen voor telemetriedoeleinden en hebben ze geen invloed op de functionaliteit.

Aangepaste koptekst Description Vereist/optioneel
x-ms-app De (beschrijvende) naam van de toepassing die de aanvraag indient. Optioneel
x-ms-user De (beschrijvende) naam van de gebruiker die de aanvraag indient. Optioneel
x-ms-user-id Hetzelfde als x-ms-user. Optioneel
x-ms-client-request-id Een unieke id voor de aanvraag. Optioneel
x-ms-client-version De (beschrijvende) versie-id voor de client die de aanvraag indient. Vereist in scenario's, waarin deze wordt gebruikt om de aanvraag te identificeren, zoals het annuleren van een actieve query. Optioneel/vereist

Hoofdtekst

De hoofdtekst is de gegevens die daadwerkelijk moeten worden opgenomen. De tekstindelingen moeten UTF-8-codering gebruiken.

Voorbeelden

In het volgende voorbeeld ziet u de HTTP POST-aanvraag voor het opnemen van JSON-inhoud:

POST https://help.kusto.windows.net/v1/rest/ingest/Test/Logs?streamFormat=Json&mappingName=mylogmapping HTTP/1.1

Aanvraagheaders:

Authorization: Bearer ...AzureActiveDirectoryAccessToken...
Accept-Encoding: deflate
Accept-Encoding: gzip
Connection: Keep-Alive
Content-Length: 161
Host: help.kusto.windows.net
x-ms-client-request-id: MyApp.Ingest;5c0656b9-37c9-4e3a-a671-5f83e6843fce
x-ms-user-id: alex@contoso.com
x-ms-app: MyApp

Aanvraagtekst:

{"Timestamp":"2018-11-14 11:34","Level":"Info","EventText":"Nothing Happened"}
{"Timestamp":"2018-11-14 11:35","Level":"Error","EventText":"Something Happened"}

In het volgende voorbeeld ziet u de HTTP POST-aanvraag voor het opnemen van dezelfde gecomprimeerde gegevens.

POST https://help.kusto.windows.net/v1/rest/ingest/Test/Logs?streamFormat=Json&mappingName=mylogmapping HTTP/1.1

Aanvraagheaders:

Authorization: Bearer ...AzureActiveDirectoryAccessToken...
Accept-Encoding: deflate
Accept-Encoding: gzip
Connection: Keep-Alive
Content-Length: 116
Content-Encoding: gzip
Host: help.kusto.windows.net
x-ms-client-request-id: MyApp.Ingest;5c0656b9-37c9-4e3a-a671-5f83e6843fce
x-ms-user-id: alex@contoso.com
x-ms-app: MyApp

Aanvraagtekst:

... binary data ...