Share via

buildschema() (função de agregação)

  • Artigo

Cria o esquema mínimo que admite todos os valores de DynamicExpr.

Nota

Esta função é utilizada em conjunto com o operador de resumo.

Syntax

buildschema(DynamicExpr)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
DynamicExpr dynamic ✔️ Expressão utilizada para o cálculo de agregação.

Devoluções

Devolve o esquema mínimo que admite todos os valores de DynamicExpr.

Dica

Se a entrada for uma cadeia JSON, utilize a função parse_json() para converter o JSON num valor dinâmico . Caso contrário, poderá ocorrer um erro.

Exemplo

O exemplo seguinte cria um esquema com base em:

  • {"x":1, "y":3.5}
  • {"x":"somevalue", "z":[1, 2, 3]}
  • {"y":{"w":"zzz"}, "t":["aa", "bb"], "z":["foo"]}

Executar a consulta

datatable(value: dynamic) [
    dynamic({"x":1, "y":3.5}),
    dynamic({"x":"somevalue", "z":[1, 2, 3]}),
    dynamic({"y":{"w":"zzz"}, "t":["aa", "bb"], "z":["foo"]})
]
| summarize buildschema(value)

Resultados

schema_value
{"x":["long","string"],"y":["double",{"w":"string"}],"z":{"indexer:"["long","string"]},"t":{"indexer":"string"}}

O esquema resultante diz-nos que:

  • O objeto raiz é um contentor com quatro propriedades denominadas x, y, z e t.
  • A propriedade denominada x é do tipo long ou da cadeia de tipo.
  • A propriedade denominada y ii do tipo duplo ou outro contentor com uma propriedade denominada w cadeia de tipo.
  • A indexer palavra-chave indica que z e t são matrizes.
  • Cada item na matriz z é do tipo de cadeia de carateres longo ou do tipo.
  • t é uma matriz de cadeias.
  • Cada propriedade é implicitamente opcional e qualquer matriz pode estar vazia.

Modelo de esquema

A sintaxe do esquema devolvido é:

Contentor ::= "{" Named-type* '}'; Tipo com nome: := (nome | ""indexer") Tipo ":"; Tipo ::= Tipo primitivo | Tipo de união | Contentor; Union-type ::= '[' Type* ']'; Tipo primitivo ::= "long" | "cadeia" | ...;

Os valores são equivalentes a um subconjunto de anotações do tipo TypeScript, codificadas como um valor dinâmico kusto. Em TypeScript, o esquema de exemplo seria:

var someobject:
{
    x?: (number | string),
    y?: (number | { w?: string}),
    z?: { [n:number] : (long | string)},
    t?: { [n:number]: string }
}