operador render

  • Artigo

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

O operador render 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 os 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 interface do usuário da Web do Azure Data Explorer pode dar suporte a visualizações diferentes.

O modelo de dados do operador render examina os dados tabulares como se houvesse três tipos de colunas:

  • A coluna do eixo x (indicada pela propriedade xcolumn).
  • As colunas da série (qualquer número de colunas indicadas pela series propriedade .) Para cada registro, os valores combinados dessas 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 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 fazer com que eles não adivinhem corretamente. Experimente 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.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
T string ✔️ Nome da tabela de entrada.
Visualização string ✔️ Indica o tipo de visualização a ser usada. Deve ser um dos valores com suporte na lista a seguir.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades com suporte.

Visualização

Visualização Descrição Ilustração
anomalychart Semelhante à timechart, mas destaca anomalias usando a função series_decompose_anomalies.
areachart Grafo de área.
barchart exibido como faixas horizontais.
card O primeiro registro de resultado é tratado como um conjunto de valores escalares e mostrado como um cartão.
columnchart Semelhante a barchart, com faixas 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 linha.
piechart a primeira coluna é a cor do eixo, a segunda coluna é numérica.
pivotchart Exibe uma tabela dinâmica e um gráfico. O usuário pode selecionar dados, colunas, linhas e vários tipos de gráfico interativamente.
scatterchart Grafo de pontos.
stackedareachart Grafo de área empilhada.
table Padrão – Os resultados são mostrados como uma tabela.
timechart gráfico de linha. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são os eixos y.
timepivot Navegação interativa pela linha de tempo de eventos (dinamização no eixo de tempo)
treemap Exibe dados hierárquicos como um conjunto de retângulos aninhados.

Observação

As visualizações de gráfico de escada, gráfico dinâmico, timepivot e mapa de árvore podem ser usadas no Kusto. Explorer mas não estão disponíveis na interface do usuário da Web do Azure Data Explorer.

Visualização Descrição Ilustração
areachart Grafo de área. A primeira coluna é o eixo x e precisa ser numérica. Outras colunas numéricas são os eixos y.
barchart A primeira coluna é o eixo x e pode ser texto, datetime ou numérica. Outras colunas são numéricas, exibidas como faixas horizontais.
columnchart Semelhante a barchart, com faixas verticais em vez de faixas horizontais.
piechart a primeira coluna é a cor do eixo, a segunda coluna é numérica.
scatterchart Grafo de pontos. A primeira coluna é o eixo x e precisa ser numérica. Outras colunas numéricas são os eixos y.
table Padrão – Os resultados são mostrados como uma tabela.
timechart gráfico de linha. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são os 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 à timechart, mas destaca anomalias usando a função series_decompose_anomalies.
areachart Grafo de área.
barchart exibido como faixas horizontais.
card O primeiro registro de resultado é tratado como um conjunto de valores escalares e mostrado como um cartão.
columnchart Semelhante a barchart, com faixas verticais em vez de faixas horizontais.
linechart gráfico de linha.
piechart a primeira coluna é a cor do eixo, a segunda coluna é numérica.
scatterchart Grafo de pontos.
stackedareachart Grafo de área empilhada.
table Padrão – Os resultados são mostrados como uma tabela.
timechart gráfico de linha. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são os eixos y.

Propriedades com suporte

PropertyName/PropertyValue indicam as informações adicionais a serem usadas ao renderizar. Todas as propriedades são opcionais. As propriedades compatíveis são:

PropertyName PropertyValue
accumulate Se o valor de cada medida é adicionado a todos os seus predecessores ou não. (true ou false)
kind Maior elaboração do tipo de visualização. Para obter mais informações, consulte kind property.
legend Se uma legenda será exibida ou não (visible ou hidden).
series Lista delimitada por vírgula de colunas cujos valores por registro combinados 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írgula de colunas formadas pelos valores fornecidos por valor da coluna x.
ysplit Como dividir várias visualizações. Para obter mais informações, consulte y-split property.
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 Maior elaboração do tipo de visualização. Para obter mais informações, consulte kind property.
series Lista delimitada por vírgula de colunas cujos valores por registro combinados definem a série à qual o registro pertence.
title O título da visualização (do tipo string).

Propriedade kind

Essa visualização pode ser ainda mais elaborada fornecendo a kind propriedade . Os valores com suporte dessa propriedade são:

Visualização kind Descrição
areachart default Cada "área" é independente.
unstacked Mesmo que default.
stacked Empilhe as "áreas" à direita.
stacked100 Empilhe as "áreas" à direita e alongue cada uma com a mesma largura que as outras.
barchart default Cada "barra" é independente.
unstacked Mesmo que default.
stacked Empilhe as "barras".
stacked100 Empilhe as "barras" e alongue cada uma com a mesma largura que as outras.
columnchart default Cada "coluna" é independente.
unstacked Mesmo que default.
stacked Empilhe as "colunas" uma acima da outra.
stacked100 Empilhe as "colunas" e alongue cada uma com 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, com eixo colorido e numéricas. Compatível com a área de trabalho do Azure Data Explorer. Para obter mais informações, consulte Visualizações geoespaciais.

Propriedade ysplit

Algumas visualizações são compatíveis com divisão em vários valores do eixo y:

ysplit Descrição
none Um único eixo y é exibido para todos os dados de 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 valor ycolumn (até certo limite).

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. Essa coluna pode ser definida explicitamente usando a xcolumn propriedade . Se não estiver definido, o agente de usuário escolherá a primeira coluna apropriada para a visualização.
    • Por exemplo: na timechart visualização, o agente do usuário usa a primeira datetime coluna.
    • Se essa 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 de acordo com o eixo x. Essas colunas podem ser definidas explicitamente usando a ycolumns propriedade . Se não estiver definido, o agente de usuário escolherá todas as colunas apropriadas para a visualização.
    • Por exemplo: na timechart visualização, o agente do usuário usa 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 deverão 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 series propriedade ou o agente do usuário as escolherá automaticamente nas colunas que não são especificadas de outra forma.

Conteúdo relacionado

Observação

O modelo de dados do operador render examina os dados tabulares como se houvesse três tipos de colunas:

  • A coluna do eixo x (indicada pela propriedade xcolumn).
  • As colunas da série (qualquer número de colunas indicadas pela propriedade series).
  • As colunas do eixo y (qualquer número de colunas indicadas 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