다음을 통해 공유


TopOne(Azure Stream Analytics)

상위 순위 레코드를 반환합니다. 여기서 순위는 지정된 순서에 따라 창에서 이벤트의 순위 위치를 정의합니다. 순서/순위 지정은 이벤트 열을 기반으로 수행되며 ORDER BY 절로 지정할 수 있습니다.

Syntax

-- Aggregate Function Syntax
TopOne( [ <scalar_expression> ] ) OVER (ORDER BY (<column name> [ASC |DESC])+)  

-- Analytic Function Syntax
TopOne( [ <scalar_expression> ] ) OVER ([<PARTITION BY clause>] ORDER BY (<column name> [ASC |DESC])+ <LIMIT DURATION clause> [<WHEN clause>])  

인수

<scalar_expression>

TopOne은 상위 이벤트에 대한 프로젝션을 지정할 수 있는 선택적 스칼라 식을 사용합니다. 매개 변수가 없으면 전체 이벤트 레코드가 반환됩니다.

<Column_name>

순서 지정이 수행될 입력 이벤트의 열 이름을 지정합니다. bigint, float 및 datetime 형식별 순서만 허용됩니다.

OVER ([<PARTITION BY 절><LIMIT DURATION 절> [<WHEN 절>]]

TopOne이 적용되는 행 그룹을 결정합니다. PARTITION BY 절은 동일한 파티션 키를 가진 행이 함께 그룹화되도록 지정합니다. LIMIT DURATION 절은 그룹에 포함된 기록의 양을 지정합니다. 선택적 WHEN 절은 그룹에 포함할 행에 대한 부울 조건을 지정합니다. 사용량에 대한 자세한 내용은 OVER 절 을 참조하세요.

반환 형식

매개 변수로 <scalar_expression> 프로젝트된 값 또는 매개 변수가 제공되지 않은 경우 레코드 값입니다.

SELECT   
    TopOne() OVER (ORDER BY value DESC) as topEvent  
FROM input  
GROUP BY Tumbling(second, 10)  
  
SELECT   
    TopOne(x * y) OVER (ORDER BY value DESC) as topEvent  
FROM input  
GROUP BY Tumbling(second, 10)