스트리밍 수집 HTTP 요청

버전 드롭다운 목록을 사용하여 서비스를 전환합니다. 탐색에 대해 자세히 알아봅니다.
적용 대상: ✅ Microsoft Fabric ✅ Azure Data Explorer

동사 및 리소스 요청

조치	HTTP 동사	HTTP 리소스
Ingest	POST	`/v1/rest/ingest/{database}/{table}?{additional parameters}`

요청 매개 변수

매개 변수	Description	필수/선택 사항
`{database}`	수집 요청에 대한 대상 데이터베이스의 이름	필수
`{table}`	수집 요청에 대한 대상 테이블의 이름	필수

추가 매개 변수

추가 매개 변수는 URL 쿼리 {name}={value} 쌍으로 형식이 지정되고 & 문자로 구분됩니다.

매개 변수	Description	필수/선택 사항
`streamFormat`	요청 본문에 있는 데이터의 형식을 지정합니다. 값은 다음 `CSVTSVSCsvSOHsvPSVJSONMultiJSON`중 `Avro`하나여야 합니다. 자세한 내용은 지원되는 데이터 형식을 참조하세요.	필수
`mappingName`	테이블에 정의된 미리 생성된 수집 매핑의 이름입니다. 자세한 내용은 데이터 매핑을 참조하세요. 테이블에서 미리 만든 매핑을 관리하는 방법은 여기에 설명되어 있습니다.	선택 사항이지만 다음 중 하나인 경우 `streamFormat` 필수입니다`JSON`.`MultiJSONAvro`

예를 들어 CSV 형식의 데이터를 데이터베이스Logs의 테이블 Test 로 수집하려면 다음을 사용합니다.

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

미리 만든 매핑 mylogmapping을 사용하여 JSON 형식 데이터를 수집하려면 다음을 사용합니다.

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 인코딩을 사용해야 합니다.

예시

다음 예제에서는 JSON 콘텐츠를 수집하기 위한 HTTP POST 요청을 보여줍니다.

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