다음을 통해 공유

Query - Batch

  • 참조
서비스:
Log Analytics
API 버전:
2022-10-27_Preview

분석 쿼리 일괄 처리 실행
데이터에 대한 분석 쿼리의 일괄 처리를 실행합니다. 다음은 Analytics 쿼리와 함께 POST를 사용하는 예제입니다.

POST https://api.loganalytics.io/v1/$batch

요청 본문

Name 필수 형식 Description
requests True

batchQueryRequest[]

일괄 처리의 단일 요청입니다.

응답

Name 형식 Description
200 OK

batchResponse

OK. API 호출이 성공하고 분석 쿼리 결과가 응답 페이로드에 있습니다.
Other Status Codes

errorResponse

오류 응답 개체입니다.

보안

oauth2

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

metadataPost

샘플 요청

POST https://api.loganalytics.io/v1/$batch

{
  "requests": [
    {
      "id": "1",
      "body": {
        "query": "AppRequests | take 2"
      },
      "path": "/query",
      "method": "POST",
      "workspace": "d2d0e126-fa1e-4b0a-b647-250cdd471e68"
    },
    {
      "id": "2",
      "body": {
        "query": "AppRequests | take 3"
      },
      "path": "/query",
      "method": "POST",
      "workspace": "d2d0e126-fa1e-4b0a-b647-250cdd471e68"
    }
  ]
}

샘플 응답

상태 코드:
200 
{
  "responses": [
    {
      "id": "1",
      "status": 200,
      "body": {
        "tables": [
          {
            "name": "PrimaryResult",
            "columns": [
              {
                "name": "TenantId",
                "type": "string"
              },
              {
                "name": "TimeGenerated",
                "type": "datetime"
              },
              {
                "name": "Id",
                "type": "string"
              },
              {
                "name": "Source",
                "type": "string"
              },
              {
                "name": "Name",
                "type": "string"
              },
              {
                "name": "Url",
                "type": "string"
              },
              {
                "name": "Success",
                "type": "bool"
              },
              {
                "name": "ResultCode",
                "type": "string"
              },
              {
                "name": "DurationMs",
                "type": "real"
              },
              {
                "name": "PerformanceBucket",
                "type": "string"
              },
              {
                "name": "Properties",
                "type": "dynamic"
              },
              {
                "name": "Measurements",
                "type": "dynamic"
              },
              {
                "name": "OperationName",
                "type": "string"
              },
              {
                "name": "OperationId",
                "type": "string"
              },
              {
                "name": "OperationLinks",
                "type": "dynamic"
              },
              {
                "name": "ParentId",
                "type": "string"
              },
              {
                "name": "SyntheticSource",
                "type": "string"
              },
              {
                "name": "SessionId",
                "type": "string"
              },
              {
                "name": "UserId",
                "type": "string"
              },
              {
                "name": "UserAuthenticatedId",
                "type": "string"
              },
              {
                "name": "UserAccountId",
                "type": "string"
              },
              {
                "name": "AppVersion",
                "type": "string"
              },
              {
                "name": "AppRoleName",
                "type": "string"
              },
              {
                "name": "AppRoleInstance",
                "type": "string"
              },
              {
                "name": "ClientType",
                "type": "string"
              },
              {
                "name": "ClientModel",
                "type": "string"
              },
              {
                "name": "ClientOS",
                "type": "string"
              },
              {
                "name": "ClientIP",
                "type": "string"
              },
              {
                "name": "ClientCity",
                "type": "string"
              },
              {
                "name": "ClientStateOrProvince",
                "type": "string"
              },
              {
                "name": "ClientCountryOrRegion",
                "type": "string"
              },
              {
                "name": "ClientBrowser",
                "type": "string"
              },
              {
                "name": "ResourceGUID",
                "type": "string"
              },
              {
                "name": "IKey",
                "type": "string"
              },
              {
                "name": "SDKVersion",
                "type": "string"
              },
              {
                "name": "ItemCount",
                "type": "int"
              },
              {
                "name": "ReferencedItemId",
                "type": "string"
              },
              {
                "name": "ReferencedType",
                "type": "string"
              },
              {
                "name": "SourceSystem",
                "type": "string"
              },
              {
                "name": "Type",
                "type": "string"
              },
              {
                "name": "_ResourceId",
                "type": "string"
              }
            ],
            "rows": [
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T00:18:13.317Z",
                "a3273b160f86b5c4",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622593091\"}",
                null,
                "ServiceBus.process",
                "e5d21caf619d4ef564a4b5920cadce47",
                null,
                "c6864f9d3649f302",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ],
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T00:19:13.44Z",
                "bebb49e7a1344c07",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622593091\"}",
                null,
                "ServiceBus.process",
                "d76c6dec50d2c12267d7d3a246a0c237",
                null,
                "b68fff4775c77214",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ]
            ]
          }
        ]
      }
    },
    {
      "id": "2",
      "status": 200,
      "body": {
        "tables": [
          {
            "name": "PrimaryResult",
            "columns": [
              {
                "name": "TenantId",
                "type": "string"
              },
              {
                "name": "TimeGenerated",
                "type": "datetime"
              },
              {
                "name": "Id",
                "type": "string"
              },
              {
                "name": "Source",
                "type": "string"
              },
              {
                "name": "Name",
                "type": "string"
              },
              {
                "name": "Url",
                "type": "string"
              },
              {
                "name": "Success",
                "type": "bool"
              },
              {
                "name": "ResultCode",
                "type": "string"
              },
              {
                "name": "DurationMs",
                "type": "real"
              },
              {
                "name": "PerformanceBucket",
                "type": "string"
              },
              {
                "name": "Properties",
                "type": "dynamic"
              },
              {
                "name": "Measurements",
                "type": "dynamic"
              },
              {
                "name": "OperationName",
                "type": "string"
              },
              {
                "name": "OperationId",
                "type": "string"
              },
              {
                "name": "OperationLinks",
                "type": "dynamic"
              },
              {
                "name": "ParentId",
                "type": "string"
              },
              {
                "name": "SyntheticSource",
                "type": "string"
              },
              {
                "name": "SessionId",
                "type": "string"
              },
              {
                "name": "UserId",
                "type": "string"
              },
              {
                "name": "UserAuthenticatedId",
                "type": "string"
              },
              {
                "name": "UserAccountId",
                "type": "string"
              },
              {
                "name": "AppVersion",
                "type": "string"
              },
              {
                "name": "AppRoleName",
                "type": "string"
              },
              {
                "name": "AppRoleInstance",
                "type": "string"
              },
              {
                "name": "ClientType",
                "type": "string"
              },
              {
                "name": "ClientModel",
                "type": "string"
              },
              {
                "name": "ClientOS",
                "type": "string"
              },
              {
                "name": "ClientIP",
                "type": "string"
              },
              {
                "name": "ClientCity",
                "type": "string"
              },
              {
                "name": "ClientStateOrProvince",
                "type": "string"
              },
              {
                "name": "ClientCountryOrRegion",
                "type": "string"
              },
              {
                "name": "ClientBrowser",
                "type": "string"
              },
              {
                "name": "ResourceGUID",
                "type": "string"
              },
              {
                "name": "IKey",
                "type": "string"
              },
              {
                "name": "SDKVersion",
                "type": "string"
              },
              {
                "name": "ItemCount",
                "type": "int"
              },
              {
                "name": "ReferencedItemId",
                "type": "string"
              },
              {
                "name": "ReferencedType",
                "type": "string"
              },
              {
                "name": "SourceSystem",
                "type": "string"
              },
              {
                "name": "Type",
                "type": "string"
              },
              {
                "name": "_ResourceId",
                "type": "string"
              }
            ],
            "rows": [
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T16:31:25.383Z",
                "08bf242cdc68504c",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622651483\"}",
                null,
                "ServiceBus.process",
                "65d9eb1ccf85b1b7ed1e2ea6bb72f563",
                null,
                "146140ce8493a6ed",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ],
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T16:32:25.492Z",
                "9f4cd78c10d57b4f",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622651483\"}",
                null,
                "ServiceBus.process",
                "ae054fe7b7ac3adf8b841ebbe1ecb912",
                null,
                "14eab103a1969665",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ],
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T16:33:25.585Z",
                "ea7e09d4baa4e4ce",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622651483\"}",
                null,
                "ServiceBus.process",
                "ba6162e3ccd803086944750b82600a3a",
                null,
                "b60455183860caaf",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ]
            ]
          }
        ]
      }
    }
  ]
}

정의

Name Description
batchQueryRequest

일괄 처리의 단일 요청입니다.
batchQueryResponse
batchQueryResults

일괄 처리의 단일 쿼리에 대한 쿼리 응답입니다.
batchRequest

요청의 배열입니다.
batchResponse

일괄 처리 쿼리에 대한 응답입니다.
column

테이블 열입니다.
errorDetail

오류 세부 정보입니다.
errorInfo

오류에 대한 코드 및 메시지입니다.
errorResponse

오류 세부 정보입니다.
logsColumnType

이 열의 데이터 형식입니다.
methodType
path
queryBody

분석 쿼리입니다. Analytics 쿼리 구문에 대해 자세히 알아보기
Render

JSON 형식의 시각화 데이터입니다.
Statistics

JSON 형식으로 표시된 통계입니다.
table

쿼리 응답 테이블입니다.

batchQueryRequest

일괄 처리의 단일 요청입니다.

Name 형식 Description
body

queryBody

분석 쿼리입니다. Analytics 쿼리 구문에 대해 자세히 알아보기
headers

object

id

string

오류 세부 정보입니다.
method

methodType

path

path

workspace

string

쿼리에 포함할 작업 영역 ID

batchQueryResponse

Name 형식 Description
body

batchQueryResults

일괄 처리의 단일 쿼리에 대한 쿼리 응답입니다.
쿼리에서 생성된 테이블, 열 & 행을 포함합니다.
headers

object

id

string

status

integer

batchQueryResults

일괄 처리의 단일 쿼리에 대한 쿼리 응답입니다.

Name 형식 Description
error

errorInfo

오류에 대한 코드 및 메시지입니다.
render

Render

JSON 형식의 시각화 데이터입니다.
statistics

Statistics

JSON 형식으로 표시된 통계입니다.
tables

table[]

테이블, 열 및 행 목록입니다.

batchRequest

요청의 배열입니다.

Name 형식 Description
requests

batchQueryRequest[]

일괄 처리의 단일 요청입니다.

batchResponse

일괄 처리 쿼리에 대한 응답입니다.

Name 형식 Description
responses

batchQueryResponse[]

일괄 처리의 각 개별 요청에 해당하는 응답 배열입니다.

column

테이블 열입니다.

Name 형식 Description
name

string

이 열의 이름입니다.
type

logsColumnType

이 열의 데이터 형식입니다.

errorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalProperties

object

오류 세부 정보 개체에 제공할 수 있는 추가 속성
code

string

오류의 코드입니다.
message

string

사람이 읽을 수 있는 오류 메시지입니다.
resources

string[]

오류를 담당한 리소스를 나타냅니다.
target

string

요청에서 오류를 담당하는 속성을 나타냅니다.
value

string

오류를 담당하는 '대상'의 값을 나타냅니다.

errorInfo

오류에 대한 코드 및 메시지입니다.

Name 형식 Description
additionalProperties

object

오류 정보 개체에 제공할 수 있는 추가 속성
code

string

컴퓨터에서 읽을 수 있는 오류 코드입니다.
details

errorDetail[]

오류 세부 정보입니다.
innererror

errorInfo

오류에 대한 코드 및 메시지입니다.
내부 오류 세부 정보(있는 경우)
message

string

사람이 읽을 수 있는 오류 메시지입니다.

errorResponse

오류 세부 정보입니다.

Name 형식 Description
error

errorInfo

오류에 대한 코드 및 메시지입니다.
오류 세부 정보입니다.

logsColumnType

이 열의 데이터 형식입니다.

Name 형식 Description
bool

string

datetime

string

decimal

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

timespan

string

methodType

Name 형식 Description
POST

string

path

Name 형식 Description
/query

string

queryBody

분석 쿼리입니다. Analytics 쿼리 구문에 대해 자세히 알아보기

Name 형식 Description
query

string

실행할 쿼리입니다.
timespan

string

선택 사항입니다. 데이터를 쿼리할 시간 범위입니다. 이는 ISO8601 기간 값입니다. 이 시간 범위는 쿼리 식에 지정된 시간 범위 외에 적용됩니다.
workspaces

string[]

쿼리에 포함된 작업 영역 목록입니다.

Render

JSON 형식의 시각화 데이터입니다.

Statistics

JSON 형식으로 표시된 통계입니다.

table

쿼리 응답 테이블입니다.

Name 형식 Description
columns

column[]

이 테이블의 열 목록입니다.
name

string

테이블의 이름입니다.
rows

object[]

이 쿼리의 결과 행입니다.