Definição do conjunto de consultas KQL

2025-03-22

Este artigo fornece um detalhamento da estrutura para itens de definição KQL Queryset (Real-Time Queryset).

Peças de definição

Esta tabela lista as partes de definição do conjunto de consultas KQL.

Caminho da parte de definição	tipo	Obrigatório	Descrição
`RealTimeQueryset.json`	RealTimeQueryset (JSON)	verdadeiro	Descreve o conteúdo da carga útil.
`.platform`	PlatformDetails (JSON)	falso	Descreve detalhes comuns do item

Exemplo de definição

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

RealTimeQueryset

A propriedade payload contém o conteúdo da definição, que é codificada em Base64. O conteúdo é um objeto JSON que descreve o Queryset. O objeto JSON contém um objeto raiz chamado queryset, que tem várias propriedades que definem o Queryset.

Propriedades do conjunto de consultas

Descreve os campos usados para construir o objeto Queryset.

Caminho da parte de definição	tipo	Obrigatório	Descrição
`version`	corda	verdadeiro	A versão do Queryset.
`dataSources`	DataSource (Matriz)	verdadeiro	A lista de fontes de dados usadas no Queryset.
`tabs`	Guia (Matriz)	verdadeiro	A lista de guias no Queryset.

Fonte de dados

Descreve os campos usados para construir o objeto DataSource.

Caminho da parte de definição	tipo	Obrigatório	Descrição
`id`	corda	verdadeiro	O identificador exclusivo da fonte de dados.
`clusterUri`	corda	verdadeiro	O URI da fonte de dados.
`type`	corda	verdadeiro	O tipo da fonte de dados. Valores válidos: `AzureDataExplorer`
`databaseName`	corda	verdadeiro	O nome do banco de dados na fonte de dados.

Tab

Descreve os campos usados para construir o objeto Tab.

Caminho da parte de definição	tipo	Obrigatório	Descrição
`id`	corda	verdadeiro	O identificador exclusivo da guia.
`content`	corda	verdadeiro	O conteúdo da guia, que é uma consulta KQL.
`title`	corda	verdadeiro	O título da guia.
`dataSourceId`	corda	verdadeiro	O identificador exclusivo da fonte de dados usada na guia.

Exemplo de RealTimeQueryset

O exemplo de carga útil a seguir é um objeto JSON que descreve um Queryset contendo uma única guia com a consulta StormEvents | count.

Este exemplo mostra o objeto JSON decodificado para a carga útil 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"
      }
    ]
  }
}

Partilhar via