Požadavek HTTP pro příjem streamování

Přepněte služby pomocí rozevíracího seznamu Verze . Přečtěte si další informace o navigaci.
Platí pro: ✅ Microsoft Fabric ✅ Azure Data Explorer

Žádost o příkaz a prostředek

Činnost	příkaz HTTP	Prostředek HTTP
Požít	PŘÍSPĚVEK	`/v1/rest/ingest/{database}/{table}?{additional parameters}`

Parametry požadavku

Parameter	Description	Povinné nebo volitelné
`{database}`	Název cílové databáze pro žádost o příjem dat	Povinné
`{table}`	Název cílové tabulky pro žádost o příjem dat	Povinné

Další parametry

Další parametry jsou formátované jako dvojice dotazů {name}={value} URL oddělené znakem >.

Parameter	Description	Povinné nebo volitelné
`streamFormat`	Určuje formát dat v textu požadavku. Hodnota by měla být jedna z těchto hodnot: `CSV`, `TSV`, `SCsvSOHsv`, `PSV`, `JSON`, `MultiJSON`. `Avro` Další informace naleznete v tématu Podporované formáty dat.	Povinné
`mappingName`	Název předem vytvořeného mapování příjmu dat definovaného v tabulce. Další informace najdete v tématu Mapování dat. Tady je popsán způsob správy předem vytvořených mapování v tabulce.	Volitelné, ale povinné, pokud `streamFormat` je některá z `JSON`, `MultiJSON`nebo `Avro`

Pokud například chcete ingestovat data ve formátu CSV do tabulky Logs v databázi Test, použijte:

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

K ingestování dat ve formátu JSON s předem vytvořeným mapováním mylogmappingpoužijte:

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

Hlavičky žádosti

Následující tabulka obsahuje společné hlavičky pro operace dotazování a správy.

Standardní hlavička	Description	Povinné nebo volitelné
`Accept`	Nastavte tuto hodnotu na `application/json`hodnotu .	Volitelný
`Accept-Encoding`	Podporované kódování jsou `gzip` a `deflate`.	Volitelný
`Authorization`	Viz ověřování.	Povinné
`Connection`	Povolte `Keep-Alive`.	Volitelný
`Content-Length`	Zadejte délku textu požadavku, pokud je to známo.	Volitelný
`Content-Encoding`	Nastavit na `gzip` , ale tělo musí být gzip-komprimováno	Volitelný
`Expect`	Nastavte na `100-Continue`.	Volitelný
`Host`	Nastavte název domény, na který jste odeslali požadavek (například `help.kusto.windows.net`).	Povinné

Následující tabulka obsahuje společné vlastní hlavičky pro operace dotazování a správy. Pokud není uvedeno jinak, hlavičky jsou určené jenom pro účely telemetrie a nemají žádný vliv na funkce.

Vlastní hlavička	Description	Povinné nebo volitelné
`x-ms-app`	(popisný) název aplikace, která požadavek provádí.	Volitelný
`x-ms-user`	(popisný) název uživatele, který žádost provádí.	Volitelný
`x-ms-user-id`	Stejné jako `x-ms-user`.	Volitelný
`x-ms-client-request-id`	Jedinečný identifikátor požadavku.	Volitelný
`x-ms-client-version`	Identifikátor verze (popisný) pro klienta, který požadavek provádí. Vyžaduje se ve scénářích, kdy se používá k identifikaci požadavku, například zrušení spuštěného dotazu.	Volitelné nebo povinné

Body

Tělo je skutečná data, která se mají ingestovat. Textové formáty by měly používat kódování UTF-8.

Examples

Následující příklad ukazuje požadavek HTTP POST pro příjem obsahu JSON:

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

Hlavičky požadavku:

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

Tělo žádosti:

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

Následující příklad ukazuje požadavek HTTP POST pro příjem stejných komprimovaných dat.

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