operador render

  • Artigo

Instrui o agente do utilizador a compor uma visualização dos resultados da consulta.

O operador de composição tem de ser o último operador na consulta e só pode ser utilizado com consultas que produzam um único resultado de fluxo de dados tabular. O operador de composição não modifica os dados. Injeta uma anotação ("Visualização") nas propriedades expandidas 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 utilizador. Diferentes agentes, como o Kusto.Explorer ou o Azure Data Explorer IU da Web, podem suportar visualizações diferentes.

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

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

Dica

  • Utilize wheree summarizetop para limitar o volume que apresenta.
  • Ordene os dados para definir a ordem do eixo x.
  • Os agentes do utilizador são livres de "adivinhar" o valor das propriedades que não são especificadas pela consulta. Em particular, ter colunas "desinteressante" no esquema do resultado pode traduzir-se em estimativas erradas. Experimente projetar essas colunas quando isso acontecer.

Nota

Existem algumas visualizações que só estão disponíveis nos dashboards do Azure Data Explorer. Para obter mais informações, veja Elementos visuais específicos do dashboard.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

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

Visualização

visualização Description Ilustração
anomalychart Semelhante ao gráfico de tempo, mas realça anomalias com a função series_decompose_anomalies.
areachart Gráfico de área.
barchart apresentado como faixas horizontais.
card O primeiro registo de resultados é tratado como um conjunto de valores escalares e é apresentado como um cartão.
columnchart Como barchart com tiras verticais em vez de faixas horizontais.
ladderchart As duas últimas colunas são o eixo x, outras colunas são eixo y.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo de cores, a segunda coluna é numérica.
pivotchart Apresenta uma tabela dinâmica e um gráfico. O utilizador pode selecionar interativamente dados, colunas, linhas e vários tipos de gráfico.
scatterchart Gráfico de pontos.
stackedareachart Gráfico de área empilhada.
table Predefinição – os resultados são apresentados como uma tabela.
timechart Gráfico de linhas. A primeira coluna é o eixo x e tem de ser datetime. Outras colunas (numéricas) são eixos y.
timepivot Navegação interativa sobre a linha cronológica dos eventos (dinamizar no eixo temporal)
treemap Apresenta dados hierárquicos como um conjunto de retângulos aninhados.

Nota

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

Visualização Description 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, datetime ou numérico. Outras colunas são numéricas, apresentadas como faixas horizontais.
columnchart Como barchart com tiras verticais em vez de faixas horizontais.
piechart A primeira coluna é o eixo de 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 Predefinição – os resultados são apresentados 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. Existe uma coluna de cadeia cujos valores são utilizados para "agrupar" as colunas numéricas e criar linhas diferentes no gráfico (as colunas de cadeia adicionais são ignoradas).
visualização Description Ilustração
anomalychart Semelhante ao gráfico de tempo, mas realça anomalias com a função series_decompose_anomalies.
areachart Gráfico de área.
barchart apresentado como faixas horizontais.
card O primeiro registo de resultados é tratado como um conjunto de valores escalares e é apresentado como um cartão.
columnchart Como barchart com tiras verticais em vez de faixas horizontais.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo de cores, a segunda coluna é numérica.
scatterchart Gráfico de pontos.
stackedareachart Gráfico de área empilhada.
table Predefinição – os resultados são apresentados como uma tabela.
timechart Gráfico de linhas. A primeira coluna é o eixo x e tem de ser datetime. Outras colunas (numéricas) são eixos y.

Propriedades suportadas

PropertyName/PropertyValue indica informações adicionais a utilizar ao compor. Todas as propriedades são opcionais. As propriedades suportadas são:

PropertyName PropertyValue
accumulate Se o valor de cada medida é adicionado a todos os seus antecessores. (true ou false)
kind Elaboração adicional do tipo de visualização. Para obter mais informações, veja kind propriedade.
legend Quer apresente ou não uma legenda (visible ou hidden).
series Lista delimitada por vírgulas de colunas cujos valores combinados por registo definem a série à qual o registo pertence.
ymin O valor mínimo a apresentar no eixo Y.
ymax O valor máximo a apresentar no eixo Y.
title O título da visualização (do tipo string).
xaxis Como dimensionar o eixo x (linear ou log).
xcolumn Que coluna no resultado é utilizada 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 múltiplas visualizações. Para obter mais informações, veja 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 séries de anomalias e apresentadas como pontos no gráfico
PropertyName PropertyValue
kind Elaboração adicional do tipo de visualização. Para obter mais informações, veja kind propriedade.
series Lista delimitada por vírgulas de colunas cujos valores combinados por registo definem a série à qual o registo pertence.
title O título da visualização (do tipo string).

kind propriedade

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

Visualização kind Description
areachart default Cada "área" está por si só.
unstacked O mesmo que default.
stacked Empilhe "áreas" à direita.
stacked100 Empilhe "áreas" à direita e estique cada uma para a mesma largura que as outras.
barchart default Cada "bar" está sozinho.
unstacked O mesmo que default.
stacked Empilhe "barras".
stacked100 Empilhe "barras" e estique cada uma para a mesma largura que as outras.
columnchart default Cada "coluna" está por si só.
unstacked O mesmo que default.
stacked Empilhe "colunas" uma em cima da outra.
stacked100 Empilhe "colunas" e estique cada uma para a mesma altura que as outras.
scatterchart map As colunas esperadas são [Longitude, Latitude] ou Ponto GeoJSON. A coluna Série é opcional. Para obter mais informações, veja Visualizações geoespaciais.
piechart map As colunas esperadas são [Longitude, Latitude] ou Ponto GeoJSON, eixo de cor e numérico. Suportado no ambiente de trabalho do Kusto Explorer. Para obter mais informações, veja Visualizações geoespaciais.

ysplit propriedade

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

ysplit Description
none É apresentado um único eixo y para todos os dados da série. (Predefinição)
axes Um único gráfico é apresentado com vários eixos y (um por série).
panels É composto um gráfico para cada ycolumn valor (até algum limite).

Como compor dados contínuos

São utilizadas várias visualizações para compor sequências de valores, por exemplo, linechart, timecharte areachart. Estas visualizações têm o seguinte modelo conceptual:

  • Uma coluna na tabela representa o eixo x dos dados. Esta coluna pode ser explicitamente definida com a xcolumn propriedade . Se não estiver definido, o agente de utilizador escolhe a primeira coluna adequada para a visualização.
    • Por exemplo: na timechart visualização, o agente de utilizador utiliza a primeira datetime coluna.
    • Se esta coluna for do tipo dynamic e tiver 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 consoante o eixo x. Estas colunas podem ser explicitamente definidas com a ycolumns propriedade . Se não estiver definido, o agente de utilizador escolhe todas as colunas adequadas para a visualização.
    • Por exemplo: na timechart visualização, o agente de utilizador utiliza todas as colunas com um valor numérico que não foi especificado de outra forma.
    • Se o eixo x for uma matriz, os valores de cada eixo y também devem ser uma matriz de um comprimento semelhante, com cada eixo y a ocorrer numa única coluna.
  • Zero ou mais colunas na tabela representam um conjunto exclusivo de dimensões que agrupam as medidas. Estas colunas podem ser especificadas pela series propriedade ou o agente de utilizador irá selecioná-las automaticamente a partir das colunas que não são especificadas.

Conteúdo relacionado

Nota

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

  • A coluna do eixo x (indicada pela xcolumn propriedade).
  • As colunas da série (qualquer número de colunas indicadas pela series propriedade.)
  • As colunas do eixo y (qualquer número de colunas indicadas pela ycolumns propriedade). Para cada registo, a série tem tantas medidas ("pontos" no gráfico) como existem colunas de 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