Query - Batch

Служба:
Log Analytics
Версия API:
v1

Выполнить партию аналитических запросов
Выполняет партию аналитических запросов для данных. Вот пример использования POST с аналитическим запросом.

POST {endpoint}/{apiVersion}/$batch

Параметры URI

Имя В Обязательно Тип Описание
apiVersion
 path True

string

Версия сервисного API.
endpoint
 path True

string (uri)

Конечная точка сервиса Log Analytics.

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

Имя Обязательно Тип Описание
requests True

BatchQueryRequest[]

Один запрос в партии.

Ответы

Имя Тип Описание
200 OK

BatchResponse

Запрос выполнен успешно.
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
https://api.loganalytics.io/.default

Примеры

A batch query

Образец запроса

POST {endpoint}/{apiVersion}/$batch

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

Пример ответа

Код состояния:
200 
{
  "responses": [
    {
      "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": "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-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"
              ]
            ]
          }
        ]
      },
      "id": "2",
      "status": 200
    }
  ]
}

Определения

Имя Описание
BatchQueryRequest

Один запрос в партии.
BatchQueryResponse

Содержит ответ на пакетный запрос и заголовки, id и статус запроса
BatchQueryResults

Содержит таблицы, столбцы и строки, полученные в результате запроса.
BatchRequest

Целый ряд запросов.
BatchResponse

Ответ на пакетный запрос.
Column

Столбец в таблице.
ColumnDataType

Тип данных столбца.
ErrorDetail

Сведения об ошибке.
ErrorInfo

Код и сообщение об ошибке.
ErrorResponse

Содержит сведения, когда код ответа указывает на ошибку.
QueryBody

Запрос Analytics. Узнайте больше о синтаксисе аналитических запросов
Table

Содержит столбцы и строки одной таблицы в ответе запроса.

BatchQueryRequest

Объект

Один запрос в партии.

Имя Тип Default value Описание
body

QueryBody

Запрос Analytics. Узнайте больше о синтаксисе аналитических запросов
headers

object

Заголовки запроса. Можно использовать заголовок Prefer, чтобы установить тайм-аут сервера и запросить статистику и информацию о визуализации.
id

string

Уникальный идентификатор, соответствующий каждому запросу в партии.
method

string

GET

Метод одного запроса в пакете по умолчанию GET
path

string

Путь запроса одного запроса в пакете.
workspace

string

Основной идентификатор рабочего пространства запроса. Это идентификатор рабочего пространства из blade Properties в портале Azure.

BatchQueryResponse

Объект

Содержит ответ на пакетный запрос и заголовки, id и статус запроса

Имя Тип Описание
body

BatchQueryResults

Содержит таблицы, столбцы и строки, полученные в результате запроса.
headers

object

Словарь строки <>
id

string

Уникальный идентификатор, соответствующий каждому запросу в партии.
status

integer (int32)

HTTP-код статуса ответа.

BatchQueryResults

Объект

Содержит таблицы, столбцы и строки, полученные в результате запроса.

Имя Тип Описание
error

ErrorInfo

Код и сообщение об ошибке.
render

Визуализационные данные в формате JSON.
statistics

Статистика представлена в формате JSON.
tables

Table[]

Результаты запроса в табличном формате.

BatchRequest

Объект

Целый ряд запросов.

Имя Тип Описание
requests

BatchQueryRequest[]

Один запрос в партии.

BatchResponse

Объект

Ответ на пакетный запрос.

Имя Тип Описание
responses

BatchQueryResponse[]

Массив ответов, соответствующих каждому отдельному запросу в пакете.

Column

Объект

Столбец в таблице.

Имя Тип Описание
name

string

Название этой колонки.
type

ColumnDataType

Тип данных этого столбца.

ColumnDataType

Перечисление

Тип данных столбца.

Значение Описание
bool

тип данных Boolean
datetime

Тип данных DateTime
dynamic

Динамический тип данных
int

Целочисленные типы данных
long

Длинный целочисленный тип данных
real

Тип данных с реальной/плавающей запятой
string

строковый тип данных
guid

Тип данных GUID
decimal

Тип десятичных данных
timespan

Тип данных временного промежутка

ErrorDetail

Объект

Сведения об ошибке.

Имя Тип Описание
additionalProperties

Дополнительные свойства, которые могут быть предоставлены объекту деталей ошибки
code

string

Код ошибки.
message

string

Удобочитаемое сообщение об ошибке.
resources

string[]

Указывает ресурсы, которые были ответственны за ошибку.
target

string

Указывает, какое свойство в запросе отвечает за ошибку.
value

string

Указывает, какое значение в 'target' ответственно за ошибку.

ErrorInfo

Объект

Код и сообщение об ошибке.

Имя Тип Описание
additionalProperties

Дополнительные свойства, которые могут быть указаны на объекте информации об ошибке
code

string

Машиночитаемый код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
innererror

ErrorInfo

Детали внутренних ошибок, если они есть.
message

string

Удобочитаемое сообщение об ошибке.

ErrorResponse

Объект

Содержит сведения, когда код ответа указывает на ошибку.

Имя Тип Описание
error

ErrorInfo

Сведения об ошибке.

QueryBody

Объект

Запрос Analytics. Узнайте больше о синтаксисе аналитических запросов

Имя Тип Описание
query

string

Выполняемый запрос.
timespan

string

Необязательно. Временной промежуток для запроса данных. Это значение ISO8601 периода времени. Этот временной интервал применяется в дополнение к тем, что указаны в выражении запроса.
workspaces

string[]

Список рабочих пространслей для запроса помимо основного рабочего пространства.

Table

Объект

Содержит столбцы и строки одной таблицы в ответе запроса.

Имя Тип Описание
columns

Column[]

Список столбцов в этой таблице.
name

string

Название таблицы.
rows

Rows[]

Полученные строки из этого запроса.