Compartilhar via


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

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

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

Observação

Essa função é usada em conjunto com o operador summarize.

Sintaxe

buildschema ( DynamicExpr)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
DynamicExpr dynamic ✔️ Expressão usada para o cálculo de agregação.

Devoluções

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

Dica

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

Exemplo

O exemplo a seguir 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"]}
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"}}

Detalhamento de esquema

No esquema resultante:

  • O objeto raiz é um contêiner com quatro propriedades chamadas x, y, ze t.
  • O x de propriedade é tipo longo ou tipo cadeia de caracteres.
  • O y de propriedade é tipo duplo ou outro contêiner com uma propriedade w do tipo cadeia de caracteres.
  • A propriedade z é uma matriz, indicada pela palavra-chave indexer, em que cada item pode ser tipo longo ou tipo cadeia de caracteres.
  • A propriedade t é uma matriz, indicada pela palavra-chave indexer, em que cada item é uma cadeia de caracteres .
  • Cada propriedade é implicitamente opcional e qualquer matriz pode estar vazia.