operador render

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

O render operador instrui o agente do usuário a visualizar os resultados da consulta. Ele deve ser o último operador em sua consulta e funciona apenas com consultas que produzem um único fluxo de dados tabulares.

O operador não modifica dados. Em vez disso, ele adiciona uma anotação "Visualização" às propriedades estendidas do resultado, contendo as instruções de visualização da consulta. Diferentes agentes de usuário, como o Kusto.Explorer ou Azure Data Explorer interface do usuário da Web, interpretam e dão suporte a visualizações diferentes com base nessas informações.

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 de série (qualquer número de colunas indicado 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.

Sintaxe

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatória 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 as propriedades suportadas.

Visualização

visualização Descrição Ilustração
anomalychart Semelhante ao gráfico de tempo, mas realça anomalias usando a função series_decompose_anomalies .
areachart Grafo de área.
barchart Exibido como faixas horizontais.
card O primeiro registro de resultado é 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 e outras colunas são eixo y.
linechart Gráfico de linhas.
piechart A primeira coluna é o eixo de cores e a segunda coluna é numérica.
pivotchart Exibe uma tabela dinâmica e um gráfico. Você pode selecionar interativamente dados, colunas, linhas e vários tipos de gráfico.
scatterchart Grafo de pontos.
stackedareachart Grafo 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 os eixos y.
timepivot Navegação interativa sobre a 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 Azure Data Explorer.

Visualização Descrição Ilustração
areachart Grafo de área. A primeira coluna é o eixo x e deve ser uma coluna 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érico. Outras colunas são numéricas e são exibidas como faixas horizontais.
columnchart Semelhante a barchart, com faixas verticais em vez de faixas horizontais.
piechart A primeira coluna é o eixo de cores e a segunda coluna é numérica.
scatterchart Grafo de pontos. A primeira coluna é o eixo x e deve ser uma coluna 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 linhas. 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 ao gráfico de tempo, mas realça anomalias usando a função series_decompose_anomalies .
areachart Grafo de área.
barchart Exibido como faixas horizontais.
card O primeiro registro de resultado é 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 linhas.
piechart A primeira coluna é o eixo de cores e 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 linhas. A primeira coluna é o eixo x e deve ser datetime. Outras colunas (numéricas) são os eixos y.

Propriedades aceitas

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 propriedade.
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 a visualização em vários valores de 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 sã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 propriedade.
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

Você pode elaborar ainda mais essa visualização fornecendo a kind propriedade. Os valores com suporte para esta 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. No máximo cinco painéis.

Como renderizar dados contínuos

Para renderizar sequências de valores, use várias visualizações, como linechart, timecharte areachart. Essas visualizações seguem o modelo conceitual:

  • Uma coluna na tabela representa o eixo x dos dados. Você pode definir explicitamente essa coluna usando a xcolumn propriedade. Se você não defini-la, o agente do usuário escolherá a primeira coluna que funciona 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 mantiver 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. Você pode definir explicitamente essas colunas usando a ycolumns propriedade. Se você não defini-lo, o agente do usuário escolherá todas as colunas que funcionam 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 você não especificou 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. Você pode especificar essas colunas usando a series propriedade ou o agente do usuário as escolhe automaticamente das 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 series propriedade).
  • 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
  • Last updated on