Partilhar via

operador de renderização

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Instrui o agente do usuário a renderizar uma visualização dos resultados da consulta.

O operador de renderização deve ser o último operador na consulta e só pode ser usado com consultas que produzem um único resultado de fluxo de dados tabular. O operador de renderização não modifica dados. Ele injeta uma anotação ("Visualização") nas propriedades estendidas do resultado. A anotação contém as informações fornecidas pelo operador na consulta. A interpretação das informações de visualização é feita pelo agente do usuário. Agentes diferentes, como Kusto.Explorer ou a interface do usuário da Web do Azure Data Explorer, podem oferecer suporte a visualizações diferentes.

O modelo de dados do operador de renderização examina os dados tabulares como se tivesse três tipos de colunas:

  • A coluna do eixo x (indicada pela propriedade xcolumn).
  • As colunas de série (qualquer número de colunas indicado pela propriedade series.) Para cada registro, os valores combinados dessas colunas definem uma única série, e o gráfico tem tantas séries quantas forem valores combinados distintos.
  • As colunas do eixo y (qualquer número de colunas indicado pela propriedade ycolumns). Para cada registro, a série tem tantas medidas ("pontos" no gráfico) quanto colunas do eixo y.

Dica

  • Use where, summarize e top para limitar o volume exibido.
  • Classifique os dados para definir a ordem do eixo x.
  • Os agentes de usuário são livres para "adivinhar" o valor das propriedades que não são especificadas pela consulta. Em particular, ter colunas "desinteressantes" no esquema do resultado pode traduzir-se em adivinhar errado. Tente projetar essas colunas quando isso acontecer.

Observação

Há algumas visualizações que só estão disponíveis nos painéis do Azure Data Explorer. Para obter mais informações, consulte Visuais específicos do painel.

Sintaxe

T|rendervisualização [with(propertyName=propertyValue [, ...])]

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
T string ✔️ Nome da tabela de entrada.
visualização string ✔️ Indica o tipo de visualização usar. Deve ser um dos valores suportados na lista a seguir.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades suportadas.

Visualização

visualização Descrição Ilustração
anomalychart Semelhante ao timechart, mas destaca anomalias usando series_decompose_anomalies função.
areachart Gráfico de área.
barchart exibidos como faixas horizontais.
card O primeiro registro de resultado é tratado como um conjunto de valores escalares e é exibido como um cartão.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
ladderchart As duas últimas colunas são o eixo x, as outras colunas são o eixo y.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo das cores, a segunda coluna é numérica.
pivotchart Exibe uma tabela dinâmica e um gráfico. O usuário pode selecionar dados interativamente, colunas, linhas e vários tipos de gráficos.
scatterchart Gráfico de pontos.
stackedareachart Gráfico de área empilhada.
table Padrão - os resultados são mostrados como uma tabela.
timechart Gráfico de linhas. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são eixos y.
timepivot Navegação interativa sobre a linha do tempo dos eventos (pivotando no eixo do tempo)
treemap Exibe dados hierárquicos como um conjunto de retângulos aninhados.

Observação

As visualizações ladderchart, pivotchart, timepivot e treemap podem ser usadas no Kusto.Explorer, mas não estão disponíveis na interface do usuário da Web do Azure Data Explorer.

de visualização Descrição Ilustração
areachart Gráfico de área. A primeira coluna é o eixo x e deve ser uma coluna numérica. Outras colunas numéricas são eixos y.
barchart A primeira coluna é o eixo x e pode ser texto, data/hora ou numérico. Outras colunas são numéricas, exibidas como faixas horizontais.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
piechart A primeira coluna é o eixo das cores, a segunda coluna é numérica.
scatterchart Gráfico de pontos. A primeira coluna é o eixo x e deve ser uma coluna numérica. Outras colunas numéricas são eixos y.
table Padrão - os resultados são mostrados como uma tabela.
timechart Gráfico de linhas. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são eixos y. Há uma coluna de cadeia de caracteres cujos valores são usados para "agrupar" as colunas numéricas e criar linhas diferentes no gráfico (outras colunas de cadeia de caracteres são ignoradas).
visualização Descrição Ilustração
anomalychart Semelhante ao timechart, mas destaca anomalias usando series_decompose_anomalies função.
areachart Gráfico de área.
barchart exibidos como faixas horizontais.
card O primeiro registro de resultado é tratado como um conjunto de valores escalares e é exibido como um cartão.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo das cores, a segunda coluna é numérica.
scatterchart Gráfico de pontos.
stackedareachart Gráfico de área empilhada.
table Padrão - os resultados são mostrados como uma tabela.
timechart Gráfico de linhas. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são eixos y.

Propriedades suportadas

PropertyName/PropertyValue indicar informações adicionais a serem usadas durante a renderização. Todas as propriedades são opcionais. As propriedades suportadas são:

PropertyName PropertyValue
accumulate Se o valor de cada medida é adicionado a todas as suas antecessoras. (true ou false)
kind Elaboração adicional do tipo visualização. Para obter mais informações, consulte kind propriedade.
legend Exibir ou não uma legenda (visible ou hidden).
series Lista delimitada por vírgulas de colunas cujos valores combinados por registro definem a série à qual o registro pertence.
ymin O valor mínimo a ser exibido no eixo Y.
ymax O valor máximo a ser exibido no eixo Y.
title O título da visualização (do tipo string).
xaxis Como dimensionar o eixo x (linear ou log).
xcolumn Qual coluna no resultado é usada para o eixo x.
xtitle O título do eixo x (do tipo string).
yaxis Como dimensionar o eixo y (linear ou log).
ycolumns Lista delimitada por vírgulas de colunas que consistem nos valores fornecidos por valor da coluna x.
ysplit Como dividir a visualização em vários valores do eixo y. Para obter mais informações, consulte y-split propriedade.
ytitle O título do eixo y (do tipo string).
anomalycolumns Propriedade relevante apenas para anomalychart. Lista delimitada por vírgulas de colunas, que serão consideradas como séries de anomalias e exibidas como pontos no gráfico
PropertyName PropertyValue
kind Elaboração adicional do tipo visualização. Para obter mais informações, consulte kind propriedade.
series Lista delimitada por vírgulas de colunas cujos valores combinados por registro definem a série à qual o registro pertence.
title O título da visualização (do tipo string).

kind propriedade

Esta visualização pode ser mais elaborada fornecendo a propriedade kind. Os valores suportados desta propriedade são:

de visualização kind Descrição
areachart default Cada "área" fica por si só.
unstacked O mesmo que default.
stacked Empilhar "áreas" à direita.
stacked100 Empilhar "áreas" à direita e esticar cada uma com a mesma largura que as outras.
barchart default Cada "bar" fica por conta própria.
unstacked O mesmo que default.
stacked Pilha "barras".
stacked100 Empilhar "barras" e esticar cada uma para a mesma largura que as outras.
columnchart default Cada "coluna" fica por si só.
unstacked O mesmo que default.
stacked Empilhar "colunas" uma sobre a outra.
stacked100 Empilhar "colunas" e esticar cada uma até a mesma altura que as outras.
scatterchart map As colunas esperadas são [Longitude, Latitude] ou Ponto GeoJSON. A coluna da série é opcional. Para obter mais informações, consulte Visualizações geoespaciais.
piechart map As colunas esperadas são [Longitude, Latitude] ou ponto GeoJSON, eixo de cores e numérico. Suportado na área de trabalho do Kusto Explorer. Para obter mais informações, consulte Visualizações geoespaciais.

ysplit propriedade

Algumas visualizações suportam a divisão em vários valores de eixo y:

ysplit Descrição
none Um único eixo y é exibido para todos os dados da série. (Padrão)
axes Um único gráfico é exibido com vários eixos y (um por série).
panels Um gráfico é renderizado para cada ycolumn valor. Máximo de cinco painéis.

Como renderizar dados contínuos

Várias visualizações são usadas para renderizar sequências de valores, por exemplo, linechart, timecharte areachart. Essas visualizações têm o seguinte modelo conceitual:

  • Uma coluna na tabela representa o eixo x dos dados. Esta coluna pode ser definida explicitamente usando a propriedade xcolumn. Se não estiver definido, o agente do usuário selecionará a primeira coluna apropriada para a visualização.
    • Por exemplo: na visualização timechart, o agente do usuário usa a primeira coluna datetime.
    • Se esta coluna for do tipo dynamic e contiver uma matriz, os valores individuais na matriz serão tratados como os valores do eixo x.
  • Uma ou mais colunas na tabela representam uma ou mais medidas que variam pelo eixo x. Essas colunas podem ser definidas explicitamente usando a propriedade ycolumns. Se não estiver definido, o agente do usuário selecionará todas as colunas apropriadas para a visualização.
    • Por exemplo: na visualização timechart, o agente do usuário usa todas as colunas com um valor numérico que não foram especificadas de outra forma.
    • Se o eixo x for uma matriz, os valores de cada eixo y também devem ser uma matriz de comprimento semelhante, com cada eixo y ocorrendo em uma única coluna.
  • Zero ou mais colunas na tabela representam um conjunto exclusivo de dimensões que agrupam as medidas. Essas colunas podem ser especificadas pela propriedade series ou o agente do usuário as selecionará automaticamente das colunas que, de outra forma, não seriam especificadas.

Observação

O modelo de dados do operador de renderização examina os dados tabulares como se tivesse três tipos de colunas:

  • A coluna do eixo x (indicada pela propriedade xcolumn).
  • As colunas de série (qualquer número de colunas indicado pela propriedade series.)
  • As colunas do eixo y (qualquer número de colunas indicado pela propriedade ycolumns). Para cada registro, a série tem tantas medidas ("pontos" no gráfico) quanto colunas do eixo y.

Exemplo

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