GitHub의 컨트리뷰션:

스칼라 ()

평가된 표현식의 스칼라 상수 값을 리턴합니다.

이 함수는 스테이징된 계산이 필요한 쿼리에 유용합니다. 예를 들어, 총 이벤트 수를 계산한 후 결과를 사용하여 모든 이벤트의 특정 백분율을 초과하는 그룹을 필터링하십시오.

두 명령문은 세미콜론으로 구분해야 합니다.

구문

toscalar(표현식)

인수

표현식: 스칼라 변환에 대해 평가될 표현식입니다.

리턴값

평가된 표현식의 스칼라 상수 값입니다. 결과가 표 형식인 경우 첫 번째 열과 첫 번째 행이 변환을 위해 사용됩니다.

한계

toscalar() 는 각 행에 함수를 적용하는 시나리오에 적용할 수 없습니다. 이는 함수가 쿼리 실행 중에 일정한 횟수만큼만 계산될 수 있기 때문입니다. 일반적으로 이 제한사항이 적용되면 다음 오류가 리턴됩니다. can't use '<column name>' as it is defined outside its row-context scope.

예

tscalar를 사용하는 이 예제는 단일 이벤트 수를 리턴합니다.

    events
        | project original_time
        | where original_time > ago(5d)
        | extend SingularCount = toscalar(events | where original_time > ago(5d) | count)
        | project SingularCount

결과

|original_time              |count() |
|---------------------------|--------|
|2023-07-19T11:43:28.722Z   |55601   |

유사한 결과가 요약 및 최대 기능을 사용할 수 있습니다.

    events
        | project original_time
        | where original_time > ago(5d)
        | summarize AggregatedCount=count()

결과

|count() |
|--------|
|55601   |