HTTP-запрос приема потоковой передачи

Переключение служб с помощью раскрывающегося списка версий . Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer

Команда запроса и ресурс

Действие	HTTP-команда	Ресурс HTTP
Глотать	ПОСТ	`/v1/rest/ingest/{database}/{table}?{additional parameters}`

Параметры запроса

Параметр	Description	Обязательно/Необязательно
`{database}`	Имя целевой базы данных для запроса приема	Обязательно
`{table}`	Имя целевой таблицы для запроса приема	Обязательно

Дополнительные параметры

Дополнительные параметры форматируются как пары запросов URL-адресов {name}={value} , разделенные символом и символом.

Параметр	Description	Обязательно/Необязательно
`streamFormat`	Задает формат данных в тексте запроса. Значение должно быть одним из: `CSV`, `TSVSCsvSOHsvPSV`, , `JSON`, . `MultiJSONAvro` Дополнительные сведения см. в разделе "Поддерживаемые форматы данных".	Обязательно
`mappingName`	Имя предварительно созданного сопоставления приема, определенного в таблице. Дополнительные сведения см. в разделе "Сопоставления данных". Здесь описан способ управления предварительно созданными сопоставлениями в таблице.	Необязательный, но обязательный, если `streamFormat` является одним из `JSON`, `MultiJSON`или `Avro`

Например, чтобы получить данные в формате CSV в таблицу Logs в базе данных Test, используйте следующее:

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

Чтобы принять данные в формате JSON с предварительно созданным сопоставлением mylogmapping, используйте:

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

Заголовки запросов

В следующей таблице содержатся общие заголовки для операций запроса и управления.

Стандартный заголовок	Description	Обязательно/Необязательно
`Accept`	Задайте для этого значения `application/json`значение .	Необязательно
`Accept-Encoding`	Поддерживаются `gzip` кодировки и `deflate`.	Необязательно
`Authorization`	См. проверку подлинности.	Обязательно
`Connection`	Включите `Keep-Alive`.	Необязательно
`Content-Length`	Укажите длину текста запроса, если известно.	Необязательно
`Content-Encoding`	Задано значение `gzip` , но тело должно быть сжатым с помощью gzip	Необязательно
`Expect`	Задайте значение `100-Continue`.	Необязательно
`Host`	Задайте доменное имя, в которое отправлен запрос (например, `help.kusto.windows.net`).	Обязательно

В следующей таблице содержатся общие пользовательские заголовки для операций запроса и управления. Если иное не указано, заголовки предназначены только для телеметрии и не влияют на функциональные возможности.

Пользовательский заголовок	Description	Обязательно/Необязательно
`x-ms-app`	(понятное) имя приложения, выполняющего запрос.	Необязательно
`x-ms-user`	(понятное) имя пользователя, выполняющего запрос.	Необязательно
`x-ms-user-id`	То же, что и `x-ms-user`.	Необязательно
`x-ms-client-request-id`	Уникальный идентификатор запроса.	Необязательно
`x-ms-client-version`	Идентификатор (понятной) версии для клиента, выполняющего запрос. Требуется в сценариях, где он используется для идентификации запроса, например отмены выполняемого запроса.	Необязательный/Обязательный

Тело

Текст — это фактические данные для приема. Текстовые форматы должны использовать кодировку UTF-8.

Примеры

В следующем примере показан HTTP-запрос POST для приема содержимого JSON:

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

Заголовки запросов:

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

Текст запроса:

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

В следующем примере показан HTTP-запрос POST для приема одинаковых сжатых данных.

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