KQL-querysetdefinitie

Artikel
2025-03-22

Dit artikel bevat een uitsplitsing van de structuur voor KQL Queryset (Real-Time Queryset) definitie-items.

Definitieonderdelen

Deze tabel bevat de KQL Queryset-definitieonderdelen.

Pad van definitieonderdeel	soort	Verplicht	Beschrijving
`RealTimeQueryset.json`	RealTimeQueryset (JSON)	waar	Beschrijft de inhoud van de nettolading.
`.platform`	PlatformDetails (JSON)	onwaar	Beschrijft algemene details van het item

Definitievoorbeeld

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

RealTimeQueryset

De eigenschap payload bevat de inhoud van de definitie, die base64-gecodeerd is. De inhoud is een JSON-object dat de Queryset beschrijft. Het JSON-object bevat een hoofdobject met de naam queryset, met verschillende eigenschappen die de Queryset definiëren.

Eigenschappen van queryset

Beschrijft de velden die worden gebruikt om het Queryset-object samen te stellen.

Pad van definitieonderdeel	soort	Verplicht	Beschrijving
`version`	touw	waar	De versie van de Queryset.
`dataSources`	Gegevensbron (matrix)	waar	De lijst met gegevensbronnen die worden gebruikt in de Queryset.
`tabs`	Tab (matrix)	waar	De lijst met tabbladen in de queryset.

Gegevensbron

Beschrijft de velden die worden gebruikt om het DataSource-object samen te stellen.

Pad van definitieonderdeel	soort	Verplicht	Beschrijving
`id`	touw	waar	De unieke id voor de gegevensbron.
`clusterUri`	touw	waar	De URI van de gegevensbron.
`type`	touw	waar	Het type gegevensbron. Geldige waarden: `AzureDataExplorer`
`databaseName`	touw	waar	De naam van de database in de gegevensbron.

Tabblad

Beschrijft de velden die worden gebruikt om het Tab-object samen te stellen.

Pad van definitieonderdeel	soort	Verplicht	Beschrijving
`id`	touw	waar	De unieke id voor het tabblad.
`content`	touw	waar	De inhoud van het tabblad, een KQL-query.
`title`	touw	waar	De titel van het tabblad.
`dataSourceId`	touw	waar	De unieke id van de gegevensbron die op het tabblad wordt gebruikt.

Voorbeeld van RealTimeQueryset

De volgende voorbeeldpayload is een JSON-object dat een Queryset beschrijft die één tabblad bevat met de query StormEvents | count.

In dit voorbeeld ziet u het gedecodeerde JSON-object voor de RealTimeQueryset nettolading.

{
  "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"
      }
    ]
  }
}

Delen via