Operador render

Cambie los servicios mediante la lista desplegable Versión . Más información sobre la navegación.
Se aplica a: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

El render operador indica al agente de usuario que visualice los resultados de la consulta. Debe ser el último operador de la consulta y solo funciona con consultas que generan un único flujo de datos tabular.

El operador no modifica los datos. En su lugar, agrega una anotación "Visualización" a las propiedades extendidas del resultado, que contiene las instrucciones de visualización de la consulta. Diferentes agentes de usuario, como Kusto.Explorer o Azure Data Explorer interfaz de usuario web, interpretan y admiten diferentes visualizaciones basadas en esta información.

El modelo de datos del operador render examina los datos tabulares como si se tratase de tres tipos de columnas:

  • Columna del eje X (indicada por la propiedad xcolumn).
  • Columnas de serie (cualquier número de columnas indicadas por la series propiedad). Para cada registro, los valores combinados de estas columnas definen una sola serie y el gráfico tiene tantas series como valores combinados distintos.
  • Columnas del eje Y (cualquier número de columnas indicado por la propiedad ycolumns). Para cada registro, la serie tiene tantas medidas ("puntos" en el gráfico) como columnas del eje Y.

Sugerencia

  • Use where, summarize y top para limitar el volumen que se muestra.
  • Ordene los datos para definir el orden del eje X.
  • Los agentes de usuario pueden "adivinar" el valor de las propiedades que no se especifican en la consulta. En concreto, tener columnas "de poco interés" en el esquema del resultado podría traducirse en una interpretación incorrecta. Pruebe a excluir esas columnas cuando esto suceda.

Nota:

Hay algunas visualizaciones que solo están disponibles en los paneles de Azure Data Explorer. Para obtener más información, consulte Objetos visuales específicos del panel.

Sintaxis

Visualización de T|render

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

Parámetros

Nombre Type Obligatorio Descripción
T string ✔️ Nombre de la tabla de entrada.
visualización string ✔️ Indica el tipo de visualización que se va a usar. Debe ser uno de los valores admitidos en la lista siguiente.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.

Visualización

visualización Descripción Ilustración
anomalychart Similar al gráfico de tiempo, pero resalta las anomalías mediante la función series_decompose_anomalies .
areachart Gráfico de áreas.
barchart Se muestra como franjas horizontales.
card El primer registro de resultados es un conjunto de valores escalares y se muestra como una tarjeta.
columnchart Como barchart, con bandas verticales en lugar de bandas horizontales.
ladderchart Las dos últimas columnas son el eje X y otras columnas son eje Y.
linechart Gráfico de líneas.
piechart La primera columna es el eje de colores y la segunda columna es numérica.
pivotchart Muestra una tabla dinámica y un gráfico. Puede seleccionar de forma interactiva datos, columnas, filas y varios tipos de gráficos.
scatterchart Gráfico de puntos.
stackedareachart Gráfico de áreas apiladas.
table De manera predeterminada, los resultados se muestran como tabla.
timechart Gráfico de líneas. La primera columna es el eje X y debe ser datetime. Las otras columnas (numéricas) son los ejes Y.
timepivot Navegación interactiva sobre la línea de tiempo de los eventos (dinamización en el eje de tiempo).
treemap Muestra datos jerárquicos como un conjunto de rectángulos anidados.

Nota:

Las visualizaciones de gráfico dinámico, gráfico dinámico, gráfico dinámico y gráfico de rectángulos se pueden usar en Kusto.Explorer, pero no están disponibles en la interfaz de usuario web de Azure Data Explorer.

Visualización Descripción Ilustración
areachart Gráfico de áreas. La primera columna es el eje X y debe ser una columna numérica. Las otras columnas numéricas son los ejes Y.
barchart La primera columna es el eje X y puede ser texto, fecha y hora o numérico. Otras columnas son numéricas y se muestran como franjas horizontales.
columnchart Como barchart, con bandas verticales en lugar de bandas horizontales.
piechart La primera columna es el eje de colores y la segunda columna es numérica.
scatterchart Gráfico de puntos. La primera columna es el eje X y debe ser una columna numérica. Las otras columnas numéricas son los ejes Y.
table De manera predeterminada, los resultados se muestran como tabla.
timechart Gráfico de líneas. La primera columna es el eje X y debe ser datetime. Las otras columnas (numéricas) son los ejes Y. Hay una columna de cadena cuyos valores se usan para "agrupar" las columnas numéricas y crear líneas diferentes en el gráfico (se omiten más columnas de cadena).
visualización Descripción Ilustración
anomalychart Similar al gráfico de tiempo, pero resalta las anomalías mediante la función series_decompose_anomalies .
areachart Gráfico de áreas.
barchart Se muestra como franjas horizontales.
card El primer registro de resultados es un conjunto de valores escalares y se muestra como una tarjeta.
columnchart Como barchart, con bandas verticales en lugar de bandas horizontales.
linechart Gráfico de líneas.
piechart La primera columna es el eje de colores y la segunda columna es numérica.
scatterchart Gráfico de puntos.
stackedareachart Gráfico de áreas apiladas.
table De manera predeterminada, los resultados se muestran como tabla.
timechart Gráfico de líneas. La primera columna es el eje X y debe ser datetime. Las otras columnas (numéricas) son los ejes Y.

Propiedades admitidas

PropertyName/PropertyValue indican información adicional para usar durante la representación. Todas las propiedades son opcionales. Las propiedades que se admiten son:

PropertyName PropertyValue
accumulate Indica si el valor de cada medida se agrega a todos sus predecesores. (true o false)
kind Más información sobre el tipo de visualización. Para obtener más información, consulte la kind propiedad .
legend Indica si se va a mostrar una leyenda o no (visible o hidden).
series Lista delimitada por comas de columnas cuyos valores por registro combinados definen la serie a la que pertenece el registro.
ymin Valor mínimo que se va a mostrar en el eje Y.
ymax Valor máximo que se va a mostrar en el eje Y.
title Título de la visualización (de tipo string).
xaxis Cómo se escala el eje X (linear o log).
xcolumn Qué columna del resultado se usa para el eje X.
xtitle Título del eje X (de tipo string).
yaxis Cómo se escala el eje Y (linear o log).
ycolumns Lista delimitada por comas de las columnas que se componen de los valores proporcionados por valor de la columna X.
ysplit Cómo dividir la visualización en varios valores del eje Y. Para obtener más información, consulte la y-split propiedad .
ytitle Título del eje Y (de tipo string).
anomalycolumns Propiedad pertinente solo para anomalychart. Lista delimitada por comas de columnas, que se consideran series de anomalías y se muestran como puntos en el gráfico
PropertyName PropertyValue
kind Más información sobre el tipo de visualización. Para obtener más información, consulte la kind propiedad .
series Lista delimitada por comas de columnas cuyos valores por registro combinados definen la serie a la que pertenece el registro.
title Título de la visualización (de tipo string).

Propiedad kind

Puede elaborar aún más esta visualización proporcionando la kind propiedad . Los valores admitidos para esta propiedad son:

Visualización kind Descripción
areachart default Cada "área" es independiente.
unstacked Igual que default.
stacked Apilar "áreas" a la derecha.
stacked100 Apilar "áreas" a la derecha y ajustar cada una de ellas al mismo ancho que las demás.
barchart default Cada "barra" es independiente.
unstacked Igual que default.
stacked Apilar "barras".
stacked100 Apilar "barras" y ajustar cada una al mismo ancho que las demás.
columnchart default Cada "columna" es independiente.
unstacked Igual que default.
stacked Apilar "columnas" una encima de la otra.
stacked100 Apilar "columnas" y ajustar cada una con el mismo alto que las demás.
scatterchart map Las columnas esperadas son [longitud, latitud] o punto de GeoJSON. La columna de la serie es opcional. Para obtener más información, consulte Visualizaciones geoespaciales.
piechart map Las columnas esperadas son [longitud, latitud] o punto de GeoJSON, eje de color y numérica. Se admite en Kusto Explorer de escritorio. Para obtener más información, consulte Visualizaciones geoespaciales.

Propiedad ysplit

Algunas visualizaciones admiten la división en varios valores del eje Y:

ysplit Descripción
none Se muestra un solo eje Y para todos los datos de la serie. (Es el valor predeterminado).
axes Se muestra un solo gráfico con varios ejes Y (uno por serie).
panels Se representa un gráfico para cada valor de ycolumn. Máximo de cinco paneles.

Representación de datos continuos

Para representar secuencias de valores, use varias visualizaciones, como linechart, timecharty areachart. Estas visualizaciones siguen el modelo conceptual:

  • Una columna de la tabla representa el eje X de los datos. Puede definir explícitamente esta columna mediante la xcolumn propiedad . Si no lo define, el agente de usuario elige la primera columna que funciona para la visualización.
    • Por ejemplo, en la timechart visualización, el agente de usuario usa la primera datetime columna.
    • Si esta columna es de tipo dynamic y contiene una matriz, los valores individuales de la matriz se tratan como los valores del eje X.
  • Una o varias columnas de la tabla representan una o varias medidas que varían según el eje X. Puede definir explícitamente estas columnas mediante la ycolumns propiedad . Si no lo define, el agente de usuario elige todas las columnas que funcionan para la visualización.
    • Por ejemplo, en la timechart visualización, el agente de usuario usa todas las columnas con un valor numérico que no especificó de lo contrario.
    • Si el eje X es una matriz, los valores de cada eje Y también deben ser una matriz de una longitud similar, con cada eje Y que se produce en una sola columna.
  • Cero o más columnas de la tabla representan un conjunto único de dimensiones que agrupan las medidas. Puede especificar estas columnas mediante la series propiedad o el agente de usuario las selecciona automáticamente de las columnas que, de lo contrario, no se especifican.

Contenido relacionado

Nota:

El modelo de datos del operador render examina los datos tabulares como si se tratase de tres tipos de columnas:

  • Columna del eje X (indicada por la propiedad xcolumn).
  • Columnas de serie (cualquier número de columnas indicadas por la series propiedad ).
  • Columnas del eje Y (cualquier número de columnas indicado por la propiedad ycolumns). Para cada registro, la serie tiene tantas medidas ("puntos" en el gráfico) como columnas del eje Y.

Ejemplo

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart
  • Last updated on