Share via

Solicitud HTTP de ingesta de streaming

  • Artículo

Solicitud de verbo y recurso

Acción Verbo HTTP Recurso HTTP
Ingesta POST /v1/rest/ingest/{database}/{table}?{additional parameters}

Parámetros de solicitud

Parámetro Descripción Obligatorio/opcional
{database} Nombre de la base de datos de destino para la solicitud de ingesta Requerido
{table} Nombre de la tabla de destino para la solicitud de ingesta Requerido

Parámetros adicionales

Los parámetros adicionales tienen el formato de pares de consulta {name}={value} url, separados por el carácter de &.

Parámetro Descripción Obligatorio/opcional
streamFormat Especifica el formato de los datos en el cuerpo de la solicitud. El valor debe ser uno de: CSV, TSV, SCsv, SOHsvPSV, , JSON, , MultiJSON, . Avro Para obtener más información, consulte Formatos de datos admitidos. Requerido
mappingName Nombre de la asignación de ingesta creada previamente definida en la tabla. Para obtener más información, consulte Asignaciones de datos. Aquí se describe la manera de administrar asignaciones creadas previamente en la tabla. Opcional, pero obligatorio si streamFormat es uno de JSON, MultiJSONo Avro

Por ejemplo, para ingerir datos con formato CSV en la tabla Logs de la base de datos Test, use:

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

Para ingerir datos con formato JSON con asignación mylogmappingcreada previamente, use:

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

Encabezados de solicitud

La tabla siguiente contiene los encabezados comunes para las operaciones de consulta y administración.

Encabezado estándar Descripción Obligatorio/opcional
Accept Establezca este valor en application/json. Opcionales
Accept-Encoding Las codificaciones admitidas son gzip y deflate. Opcionales
Authorization Consulte autenticación. Requerido
Connection Habilite Keep-Alive. Opcionales
Content-Length Especifique la longitud del cuerpo de la solicitud, cuando se conozca. Opcionales
Content-Encoding gzip Establézcalo en , pero el cuerpo debe ser gzip-compressed Opcionales
Expect Establézcalo en 100-Continue. Opcionales
Host Establezca en el nombre de dominio al que envió la solicitud (por ejemplo, help.kusto.windows.net). Requerido

La tabla siguiente contiene los encabezados personalizados comunes para las operaciones de consulta y administración. A menos que se indique lo contrario, los encabezados solo tienen fines de telemetría y no tienen ningún impacto en la funcionalidad.

Encabezado personalizado Descripción Obligatorio/opcional
x-ms-app Nombre (descriptivo) de la aplicación que realiza la solicitud. Opcionales
x-ms-user Nombre (descriptivo) del usuario que realiza la solicitud. Opcionales
x-ms-user-id Igual a x-ms-user. Opcionales
x-ms-client-request-id Identificador único de la solicitud. Opcionales
x-ms-client-version Identificador de versión (descriptivo) para el cliente que realiza la solicitud. Necesario en escenarios, donde se usa para identificar la solicitud, como cancelar una consulta en ejecución. Opcional/?Requerido

Cuerpo

El cuerpo es los datos reales que se van a ingerir. Los formatos de texto deben usar codificación UTF-8.

Ejemplos

En el ejemplo siguiente se muestra la solicitud HTTP POST para ingerir contenido JSON:

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

Encabezados de solicitud:

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

Cuerpo de la solicitud:

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

En el ejemplo siguiente se muestra la solicitud HTTP POST para ingerir los mismos datos comprimidos.

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

Encabezados de solicitud:

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

Cuerpo de la solicitud:

... binary data ...