Compartir a través de


buildschema() (función de agregación)

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Compila el esquema mínimo que admite todos los valores de DynamicExpr.

Nota:

Esta función se usa junto con el operador summarize.

Sintaxis

buildschema ( DynamicExpr)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Obligatorio Descripción
DynamicExpr dynamic ✔️ Expresión usada para el cálculo de agregaciones.

Devoluciones

Devuelve el esquema mínimo que admite todos los valores de DynamicExpr.

Sugerencia

Si la entrada es una cadena JSON, use la función parse_json() para convertir el JSON en un valor dinámico . De lo contrario, podría producirse un error.

Ejemplos

En el ejemplo siguiente se compila un esquema basado en:

  • {"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)

Salida

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

Desglose del esquema

En el esquema resultante:

  • El objeto raíz es un contenedor con cuatro propiedades denominadas x, y, zy t.
  • El x de propiedad es de tipo largo o tipo cadena.
  • El y de propiedad es de tipo doble u otro contenedor con una propiedad w de tipo cadena.
  • La propiedad z es una matriz, indicada por la palabra clave indexer, donde cada elemento puede ser de tipo largo o tipo cadena.
  • La propiedad t es una matriz, indicada por la palabra clave indexer, donde cada elemento es una cadena .
  • Cada propiedad es implícitamente opcional y cualquier matriz puede estar vacía.