operador de renderização

Alterne entre serviços usando a lista suspensa Version. Saiba mais sobre navegação.
Aplica a: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

O render operador instrui o agente de utilizador a visualizar os resultados da consulta. Deve ser o último operador da sua consulta e funciona apenas com consultas que produzem um único fluxo de dados tabulares.

O operador não modifica dados. Em vez disso, adiciona uma anotação "Visualização" às propriedades estendidas do resultado, contendo as instruções de visualização da sua consulta. Diferentes agentes de utilizador, como o Kusto.Explorer ou a interface web do Azure Data Explorer, interpretam e suportam diferentes visualizações com base nesta informaçã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.) 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.
propriedadeNome, propriedadeValor 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 a função series_decompose_anomalies .
areachart Gráfico de área.
barchart Exibido como tiras horizontais.
card O primeiro registo de resultado é um conjunto de valores escalares e aparece como uma carta.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
ladderchart As duas últimas colunas são o eixo x, e as outras colunas são o eixo y.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo de cor, e a segunda coluna é numérica.
pivotchart Exibe uma tabela dinâmica e um gráfico. Você 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 data-hora. Outras colunas (numéricas) são eixos y.
timepivot Navegação interativa ao longo da linha temporal dos eventos (pivotando no eixo temporal).
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 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érica. As outras colunas são numéricas e apresentam-se como faixas horizontais.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
piechart A primeira coluna é o eixo de cor, e 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 a data-hora. 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 a função series_decompose_anomalies .
areachart Gráfico de área.
barchart Exibido como tiras horizontais.
card O primeiro registo de resultado é um conjunto de valores escalares e aparece como uma carta.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo de cor, e 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 data-hora. 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, consideradas como séries de anomalias e apresentadas 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

Pode desenvolver ainda mais esta visualização fornecendo a kind propriedade. Os valores suportados para esta 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

Para renderizar sequências de valores, use várias visualizações, como linechart, timechart, e areachart. Estas visualizações seguem o modelo conceptual:

  • Uma coluna na tabela representa o eixo x dos dados. Pode definir explicitamente esta coluna usando a xcolumn propriedade. Se não o definires, o agente do utilizador escolhe a primeira coluna que funciona para a visualização.
    • Por exemplo, na timechart visualização, o agente de utilizador usa a primeira datetime coluna.
    • Se esta coluna for do tipo dynamic e contiver um array, os valores individuais no array são tratados como valores do eixo x.
  • Uma ou mais colunas na tabela representam uma ou mais medidas que variam pelo eixo x. Pode definir explicitamente estas colunas usando a ycolumns propriedade. Se não o definires, o agente de utilizador escolhe todas as colunas que funcionam para a visualização.
    • Por exemplo, na timechart visualização, o user agent usa todas as colunas com um valor numérico que não especificaste 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. Pode especificar estas colunas usando a propriedade series , ou o agente de utilizador escolhe-as automaticamente entre as colunas que de outra forma não estão especificadas.

Conteúdo relacionado

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 da série (qualquer número de colunas indicado pela series propriedade).
  • 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
  • Last updated on