render 연산자

  • 아티클

사용자 에이전트에게 쿼리 결과의 시각화를 렌더링하도록 지시합니다.

render 연산자는 쿼리의 마지막 연산자여야 하며 단일 테이블 형식 데이터 스트림 결과를 생성하는 쿼리에서만 사용할 수 있습니다. 렌더링 연산자는 데이터를 수정하지 않습니다. 주석("시각화")을 결과의 확장 속성에 삽입합니다. 주석에는 연산자에서 쿼리에 제공하는 정보가 포함됩니다. 시각화 정보의 해석은 사용자 에이전트를 통해 수행됩니다. Kusto와 같은 다른 에이전트. Explorer 또는 Azure Data Explorer 웹 UI는 다양한 시각화를 지원할 수 있습니다.

render 연산자의 데이터 모델은 다음 세 가지 종류의 열이 있는 것처럼 테이블 형식 데이터를 검토합니다.

  • x축 열(xcolumn 속성으로 표시됨)
  • 계열 열(속성으로 표시된 열 수)입니다 series . 각 레코드에 대해 이러한 열의 결합된 값은 단일 계열을 정의하고 차트에는 고유한 결합 값이 있는 만큼 계열이 있습니다.
  • y축 열(ycolumns 속성으로 표시되는 열 수). 각 레코드에 대해 계열에는 y축 열 수만큼 많은 측정값(차트의 "점")이 포함됩니다.

팁

  • where, summarize 및 top을 사용하여 표시되는 볼륨을 제한합니다.
  • 데이터를 정렬하여 x축의 순서를 정의합니다.
  • 사용자 에이전트는 쿼리에서 지정되지 않은 속성의 값을 자유롭게 "추측"합니다. 특히 결과의 스키마에 "관심 없는" 열이 포함되면 잘못된 추측으로 변환될 수 있습니다. 이러한 열이 발생하는 경우 해당 열을 프로젝션해 보세요.

참고

Azure Data Explorer 대시보드에서만 사용할 수 있는 몇 가지 시각화가 있습니다. 자세한 내용은 대시보드별 시각적 개체를 참조하세요.

Syntax

T|render시각화 [with(propertyName=propertyValue [, ...])]

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름 형식 필수 설명
T string ✔️ 입력 테이블 이름입니다.
시각화 string ✔️ 사용할 시각화 의 종류를 나타냅니다. 다음 목록에서 지원되는 값 중 하나여야 합니다.
propertyName, propertyValue string 키-값 속성 쌍의 쉼표로 구분된 목록입니다. 지원되는 속성을 참조하세요.

시각화

시각화 Description 그림
anomalychart timechart와 비슷하지만 series_decompose_anomalies 함수를 사용하여 변칙을 강조 표시합니다.
areachart 영역형 그래프입니다.
barchart 가로 스트립으로 표시됩니다.
card 첫 번째 결과 레코드는 스칼라 값 집합으로 처리되고 카드로 표시됩니다.
columnchart 가로 스트립 대신 세로 스트립이 있는 barchart와 같습니다.
ladderchart 마지막 두 열은 x축이고, 다른 열은 y축입니다.
linechart 선 그래프입니다.
piechart 첫 번째 열은 색깔 축이고 두 번째 열은 숫자입니다.
pivotchart 피벗 테이블 및 차트를 표시합니다. 사용자는 데이터, 열, 행 및 다양한 차트 종류를 대화형으로 선택할 수 있습니다.
scatterchart 점 그래프입니다.
stackedareachart 누적 영역형 그래프입니다.
table 기본값 - 결과가 테이블로 표시됩니다.
timechart 선 그래프입니다. 첫 번째 열은 x축이며 datetime이어야 합니다. 다른(숫자) 열은 y축입니다.
timepivot 이벤트 타임라인에 대한 대화형 탐색입니다(시간 축에서 피벗).
treemap 계층적 데이터를 중첩된 사각형 집합으로 표시합니다.

참고

사다리 차트, 피벗 차트, timepivot 및 트리맵 시각화는 Kusto에서 사용할 수 있습니다. Explorer Azure Data Explorer 웹 UI에서는 사용할 수 없습니다.

시각화 Description 그림
areachart 영역형 그래프입니다. 첫 번째 열은 x축이며 숫자 열이어야 합니다. 다른 숫자 열은 y축입니다.
barchart 첫 번째 열은 x 축이며 텍스트, 날짜/시간 또는 숫자일 수 있습니다. 다른 열은 숫자이며 가로 스트립으로 표시됩니다.
columnchart 가로 스트립 대신 세로 스트립이 있는 barchart와 같습니다.
piechart 첫 번째 열은 색깔 축이고 두 번째 열은 숫자입니다.
scatterchart 점 그래프입니다. 첫 번째 열은 x축이며 숫자 열이어야 합니다. 다른 숫자 열은 y축입니다.
table 기본값 - 결과가 테이블로 표시됩니다.
timechart 선 그래프입니다. 첫 번째 열은 x축이며 날짜/시간이어야 합니다. 다른(숫자) 열은 y축입니다. 숫자 열을 "그룹화"하고 차트에 다른 줄을 만드는 데 값이 사용되는 문자열 열이 하나 있습니다(추가 문자열 열은 무시됨).
시각화 Description 그림
anomalychart timechart와 비슷하지만 series_decompose_anomalies 함수를 사용하여 변칙을 강조 표시합니다.
areachart 영역형 그래프입니다.
barchart 가로 스트립으로 표시됩니다.
card 첫 번째 결과 레코드는 스칼라 값 집합으로 처리되고 카드로 표시됩니다.
columnchart 가로 스트립 대신 세로 스트립이 있는 barchart와 같습니다.
linechart 선 그래프입니다.
piechart 첫 번째 열은 색깔 축이고 두 번째 열은 숫자입니다.
scatterchart 점 그래프입니다.
stackedareachart 누적 영역형 그래프입니다.
table 기본값 - 결과가 테이블로 표시됩니다.
timechart 선 그래프입니다. 첫 번째 열은 x축이며 datetime이어야 합니다. 다른(숫자) 열은 y축입니다.

지원되는 속성

PropertyName/PropertyValue는 렌더링할 때 사용할 추가 정보를 나타냅니다. 모든 속성은 선택 사항입니다. 지원되는 속성은 다음과 같습니다.

PropertyName PropertyValue
accumulate 각 측정값이 모든 선행 작업에 추가되는지 여부입니다. (true 또는 false)
kind 시각화 종류에 대한 추가 상세 정보입니다. 자세한 내용은 속성을 참조 kind 하세요.
legend 범례를 표시하는지 여부입니다(visible 또는 hidden).
series 레코드가 속한 계열을 정의하는 결합된 레코드당 값이 있는 열의 쉼표로 구분된 목록입니다.
ymin Y축에 표시할 최솟값입니다.
ymax Y축에 표시할 최댓값입니다.
title 시각화의 제목입니다(string 형식).
xaxis x축의 크기를 조정하는 방법입니다(linear 또는 log).
xcolumn 결과에서 x축에 사용되는 열입니다.
xtitle x축의 제목입니다(string 형식).
yaxis y축의 크기를 조정하는 방법입니다(linear 또는 log).
ycolumns x 열의 값을 기준으로 제공된 값으로 구성되는 열의 쉼표로 구분된 목록입니다.
ysplit 여러 시각화를 분할하는 방법입니다. 자세한 내용은 속성을 참조 y-split 하세요.
ytitle y축의 제목입니다(string 형식).
anomalycolumns anomalychart에만 관련된 속성입니다. 쉼표로 구분된 열 목록- 변칙 계열로 간주되고 차트에 포인트로 표시됩니다.
PropertyName PropertyValue
kind 시각화 종류에 대한 추가 상세 정보입니다. 자세한 내용은 속성을 참조 kind 하세요.
series 레코드가 속한 계열을 정의하는 결합된 레코드당 값이 있는 열의 쉼표로 구분된 목록입니다.
title 시각화의 제목입니다(string 형식).

kind 속성

이 시각화는 속성을 제공하여 kind 더욱 정교해질 수 있습니다. 이 속성의 지원되는 값은 다음과 같습니다.

시각화 kind 설명
areachart default 각 "영역" 자체를 나타냅니다.
unstacked default와 동일합니다.
stacked "영역"을 오른쪽으로 쌓습니다.
stacked100 "영역"을 오른쪽으로 쌓고, 각 영역을 다른 영역과 같은 너비로 늘립니다.
barchart default 각 "가로 막대" 자체를 나타냅니다.
unstacked default와 동일합니다.
stacked "가로 막대"를 쌓습니다.
stacked100 "가로 막대"를 쌓고, 각 가로 막대를 다른 가로 막대와 같은 너비로 늘립니다.
columnchart default 각 "세로 막대" 자체를 나타냅니다.
unstacked default와 동일합니다.
stacked "세로 막대"를 켜켜이 쌓습니다.
stacked100 "세로 막대"를 쌓고, 각 세로 막대를 다른 세로 막대와 같은 높이로 늘립니다.
scatterchart map 필요한 열은 [경도, 위도] 또는 GeoJSON 점입니다. 계열 열은 선택 사항입니다. 자세한 내용은 지리 공간적 시각화를 참조하세요.
piechart map 필요한 열은 [경도, 위도] 또는 GeoJSON 점, 색 축 및 숫자입니다. Kusto 탐색기 데스크톱에서 지원됩니다. 자세한 내용은 지리 공간적 시각화를 참조하세요.

ysplit 속성

일부 시각화는 여러 y축 값으로 분할하도록 지원합니다.

ysplit 설명
none 모든 계열 데이터에 대해 단일 y축이 표시됩니다. (기본값)
axes 단일 차트가 여러 y축으로 표시됩니다(계열당 하나씩).
panels 각 ycolumn 값에 대해 하나의 차트가 렌더링됩니다(특정 제한까지).

연속 데이터를 렌더링하는 방법

값 시퀀스(예 linechart: , timechart및 areachart)를 렌더링하는 데 여러 시각화가 사용됩니다. 이러한 시각화에는 다음과 같은 개념적 모델이 있습니다.

  • 테이블의 한 열은 데이터의 x축을 나타냅니다. 이 열은 속성을 사용하여 xcolumn 명시적으로 정의할 수 있습니다. 정의되지 않은 경우 사용자 에이전트는 시각화에 적합한 첫 번째 열을 선택합니다.
    • 예를 들어 시각화에서 timechart 사용자 에이전트는 첫 번째 datetime 열을 사용합니다.
    • 이 열이 형식 dynamic 이고 배열을 보유하는 경우 배열의 개별 값은 x축의 값으로 처리됩니다.
  • 테이블의 하나 이상의 열은 x축에 따라 달라지는 하나 이상의 측정값을 나타냅니다. 이러한 열은 속성을 사용하여 ycolumns 명시적으로 정의할 수 있습니다. 정의되지 않은 경우 사용자 에이전트는 시각화에 적합한 모든 열을 선택합니다.
    • 예를 들어 시각화에서 timechart 사용자 에이전트는 달리 지정되지 않은 숫자 값이 있는 모든 열을 사용합니다.
    • x축이 배열인 경우 각 y축의 값은 길이가 비슷한 배열이어야 하며 각 y축은 단일 열에서 발생합니다.
  • 테이블의 열이 0개 이상은 측정값을 함께 그룹화한 고유한 차원 집합을 나타냅니다. 이러한 열은 속성으로 series 지정할 수 있습니다. 그렇지 않으면 지정되지 않은 열에서 사용자 에이전트가 자동으로 열을 선택합니다.

관련 콘텐츠

참고

render 연산자의 데이터 모델은 다음 세 가지 종류의 열이 있는 것처럼 테이블 형식 데이터를 검토합니다.

  • x축 열(xcolumn 속성으로 표시됨)
  • 계열 열(series 속성으로 표시되는 열 수).
  • y축 열(ycolumns 속성으로 표시되는 열 수). 각 레코드에 대해 계열에는 y축 열 수만큼 많은 측정값(차트의 "점")이 포함됩니다.

예제

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