Definizione del set di query KQL

Articolo
03/22/2025

Questo articolo fornisce una suddivisione della struttura per gli elementi di definizione KQL Queryset (Real-Time Queryset).

Parti di definizione

In questa tabella sono elencate le parti di definizione dell'oggetto Queryset KQL.

Percorso della parte di definizione	tipo	Obbligatorio	Descrizione
`RealTimeQueryset.json`	RealTimeQueryset (JSON)	vero	Descrive il contenuto del payload.
`.platform`	PlatformDetails (JSON)	falso	Descrive i dettagli comuni dell'elemento

Esempio di definizione

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

RealTimeQueryset

La proprietà payload contiene il contenuto della definizione, con codifica Base64. Il contenuto è un oggetto JSON che descrive l'oggetto Queryset. L'oggetto JSON contiene un oggetto radice denominato queryset, che ha diverse proprietà che definiscono l'oggetto Queryset.

Proprietà del set di query

Descrive i campi utilizzati per costruire l'oggetto Queryset.

Percorso della parte di definizione	tipo	Obbligatorio	Descrizione
`version`	corda	vero	Versione dell'oggetto Queryset.
`dataSources`	DataSource (matrice)	vero	Elenco di origini dati utilizzate nell'oggetto Queryset.
`tabs`	Scheda (matrice)	vero	Elenco di schede nell'oggetto Queryset.

DataSource

Descrive i campi utilizzati per costruire l'oggetto DataSource.

Percorso della parte di definizione	tipo	Obbligatorio	Descrizione
`id`	corda	vero	Identificatore univoco per l'origine dati.
`clusterUri`	corda	vero	URI dell'origine dati.
`type`	corda	vero	Tipo dell'origine dati. Valori validi: `AzureDataExplorer`
`databaseName`	corda	vero	Nome del database nell'origine dati.

Tab

Descrive i campi utilizzati per costruire l'oggetto Tab.

Percorso della parte di definizione	tipo	Obbligatorio	Descrizione
`id`	corda	vero	Identificatore univoco per la scheda.
`content`	corda	vero	Contenuto della scheda, ovvero una query KQL.
`title`	corda	vero	Titolo della scheda.
`dataSourceId`	corda	vero	Identificatore univoco dell'origine dati utilizzata nella scheda .

Esempio di RealTimeQueryset

Il payload di esempio seguente è un oggetto JSON che descrive un oggetto Queryset contenente una singola scheda con la query StormEvents | count.

Questo esempio mostra l'oggetto JSON decodificato per il payload 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"
      }
    ]
  }
}

Condividi tramite