Definición del conjunto de consultas KQL

En este artículo se proporciona un desglose de la estructura de los elementos de definición del conjunto de consultas KQL (Real-Time Queryset).

Elementos de definición

En esta tabla se enumeran los elementos de definición del conjunto de consultas KQL.

Ruta de acceso del elemento de definición	tipo	Obligatorio	Descripción
RealTimeQueryset.json	RealTimeQueryset (JSON)	cierto	Describe el contenido de la carga útil.
.platform	PlatformDetails (JSON)	falso	Describe los detalles comunes del elemento.

Ejemplo de definición

{
  "parts": [
    {
      "path": "RealTimeQueryset.json",
      "payload": "ewogICAgInF1ZXJ5c2V0IjogewogICAgICAgICJ2ZXJzaW9uIjogIjEuMC4wIiwKICAgICAgICAiZGF0YVNvdXJjZXMiOiBbewogICAgICAgICAgICAgICAgImlkIjogImMyNDM0YmY4LTI1YmItNGFhMC04NzQ2LWRiNDcwNTMzYWRhZiIsCiAgICAgICAgICAgICAgICAiY2x1c3RlclVyaSI6ICJodHRwczovL2hlbHAua3VzdG8ud2luZG93cy5uZXQvIiwKICAgICAgICAgICAgICAgICJ0eXBlIjogIkF6dXJlRGF0YUV4cGxvcmVyIiwKICAgICAgICAgICAgICAgICJkYXRhYmFzZU5hbWUiOiAiU2FtcGxlcyIKICAgICAgICAgICAgfQogICAgICAgIF0sCiAgICAgICAgInRhYnMiOiBbewogICAgICAgICAgICAgICAgImlkIjogImNjZDdiOTBjLTUxZmUtNDI5Zi1hODUzLTM4NWIwMmJkNzRjOSIsCiAgICAgICAgICAgICAgICAiY29udGVudCI6ICJTdG9ybUV2ZW50c1xcXFxufCBjb3VudCIsCiAgICAgICAgICAgICAgICAidGl0bGUiOiAiVGFiMU5hbWUiLAogICAgICAgICAgICAgICAgImRhdGFTb3VyY2VJZCI6ICJjMjQzNGJmOC0yNWJiLTRhYTAtODc0Ni1kYjQ3MDUzM2FkYWYiCiAgICAgICAgICAgIH0KICAgICAgICBdCiAgICB9Cn0=",
      "payloadType": "InlineBase64"
    },
    {
      "path": ".platform",
      "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
      "payloadType": "InlineBase64"
    }
  ]
}

RealTimeQueryset

La propiedad payload contiene el contenido de la definición, que está codificado en Base64. El contenido es un objeto JSON que describe el conjunto de consultas. El objeto JSON contiene un objeto raíz denominado queryset, que tiene varias propiedades que definen el conjunto de consultas.

Propiedades del conjunto de consultas

Describe los campos usados para construir el objeto Queryset.

Ruta de acceso del elemento de definición	tipo	Obligatorio	Descripción
version	cuerda / cadena	cierto	Versión del conjunto de consultas.
dataSources	Origen de datos (matriz)	cierto	Lista de orígenes de datos usados en el conjunto de consultas.
tabs	Pestaña (matriz)	cierto	Lista de pestañas del conjunto de consultas.

DataSource

Describe los campos usados para construir el objeto DataSource.

Ruta de acceso del elemento de definición	tipo	Obligatorio	Descripción
id	cuerda / cadena	cierto	Identificador único del origen de datos.
clusterUri	cuerda / cadena	cierto	URI del origen de datos.
type	cuerda / cadena	cierto	Tipo del origen de datos. Valores válidos: AzureDataExplorer
databaseName	cuerda / cadena	cierto	Nombre de la base de datos en el origen de datos.

Pestaña

Describe los campos usados para construir el objeto Tab.

Ruta de acceso del elemento de definición	tipo	Obligatorio	Descripción
id	cuerda / cadena	cierto	Identificador único de la pestaña.
content	cuerda / cadena	cierto	Contenido de la pestaña, que es una consulta KQL.
title	cuerda / cadena	cierto	Título de la pestaña.
dataSourceId	cuerda / cadena	cierto	Identificador único del origen de datos usado en la pestaña .

Ejemplo de RealTimeQueryset

La carga de ejemplo siguiente es un objeto JSON que describe un conjunto de consultas que contiene una sola pestaña con la consulta StormEvents | count.

En este ejemplo se muestra el objeto JSON descodificado para la carga de RealTimeQueryset.

{
  "queryset": {
    "version": "1.0.0",
    "dataSources": [
      {
        "id": "c2434bf8-25bb-4aa0-8746-db470533adaf",
        "clusterUri": "https://help.kusto.windows.net/",
        "type": "AzureDataExplorer",
        "databaseName": "Samples"
      }
    ],
    "tabs": [
      {
        "id": "ccd7b90c-51fe-429f-a853-385b02bd74c9",
        "content": "StormEvents\\\\n| count",
        "title": "Tab1Name",
        "dataSourceId": "c2434bf8-25bb-4aa0-8746-db470533adaf"
      }
    ]
  }
}