다음을 통해 공유

First 함수(보고서 작성기 및 SSRS)

  • 아티클

지정된 식의 지정된 범위에서 첫 번째 값을 반환합니다.

참고

SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 Report Builder(SSRS)에서 보고서 디자인을 참조하세요.

구문

  
First(expression, scope)

매개 변수

expression
(Variant 또는 Binary) 집계를 수행할 식의 예는 =Fields!FieldName.Value와 같습니다.

범위
(String) 선택 사항입니다. 집계 함수를 적용할 보고서 항목을 포함하는 데이터 세트, 그룹 또는 데이터 영역의 이름입니다. scope 를 지정하지 않은 경우 현재 범위가 사용됩니다.

반환 형식

식 유형에 따라 결정됩니다.

설명

First 함수는 지정된 범위에 모든 정렬 및 필터링을 적용한 후 데이터 집합에서 첫 번째 값을 반환합니다.

First 함수는 그룹 필터 식에서 현재(기본) 범위 외에는 사용할 수 없습니다.

페이지의 첫 번째와 마지막 항목을 표시하는 사전 스타일의 머리글을 만들기 위해 페이지 머리글에 First를 사용하여 페이지에 대한 ReportItems 컬렉션의 첫 번째 값을 반환할 수도 있습니다.

scope 의 값은 문자열 상수여야 하고 식일 수 없습니다. 외부 집계나 다른 집계를 지정하지 않는 집계의 경우 scope 는 현재 범위나 포함하는 범위를 참조해야 합니다. 집계의 집계의 경우 중첩 집계는 자식 범위를 지정할 수 있습니다.

Expression 에는 다음 예외와 조건이 있는 중첩 집계 함수에 대한 호출이 포함될 수 있습니다.

  • 중첩 집계의Scope 는 외부 집계의 범위와 동일하거나 외부 집계의 범위에 포함되어야 합니다. 식에 있는 모든 고유 범위의 경우 한 범위는 다른 모든 범위에 대한 자식 관계에 있어야 합니다.

  • 중첩 집계의 Scope는 데이터 세트의 이름일 수 없습니다.

  • 식에는 , , LastPrevious또는 RunningValue 함수가 포함되어First서는 안 됩니다.

  • Expression 에는 recursive를 지정하는 중첩 집계가 포함되지 않아야 합니다.

자세한 내용은 집계 함수 참조(보고서 작성기 및 SSRS) 및 합계, 집계 및 기본 제공 컬렉션의 식 범위(보고서 작성기 및 SSRS)를 참조하세요.

재귀 집계에 대한 자세한 내용은 재귀 계층 구조 그룹 만들기(보고서 작성기 및 SSRS)를 참조하세요.

예제

다음 코드 예에서는 데이터 영역의 Category 그룹에서 첫 번째 제품 번호를 반환합니다.

=First(Fields!ProductNumber.Value, "Category")

참고 항목

보고서에 사용되는 식(보고서 작성기 및 SSRS)
식 예(보고서 작성기 및 SSRS)
식의 데이터 형식(보고서 작성기 및 SSRS)
합계, 집계 및 기본 제공 컬렉션의 식 범위(보고서 작성기 및 SSRS)