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
피드백
https://aka.ms/ContentUserFeedback을 참조하세요.
출시 예정: 2024년 내내 콘텐츠 피드백 메커니즘인 GitHub 문제를 단계적으로 폐지하고 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은다음에 대한 사용자 의견 제출 및 보기