보고서 작성기 함수 - 집계 함수 참조Report Builder Functions - Aggregate Functions Reference

보고서에 집계 값을 포함하려면 식에서 기본 제공 집계 함수를 사용할 수 있습니다.To include aggregated values in your report, you can use built-in aggregate functions in expressions. 숫자 필드에 대한 기본 집계 함수는 SUM입니다.The default aggregate function for numeric fields is SUM. 식을 편집하고 다른 기본 제공 집계 함수를 사용하거나 다른 범위를 지정할 수 있습니다.You can edit the expression and use a different built-in aggregate function or specify a different scope. 범위는 계산에 사용할 데이터 집합을 식별합니다.Scope identifies which set of data to use for the calculation.

보고서 처리기가 보고서 데이터와 보고서 레이아웃을 결합할 때 각 보고서 항목에 대한 식이 계산됩니다.As the report processor combines report data and the report layout, the expressions for each report item are evaluated. 보고서의 각 페이지를 볼 때 렌더링된 보고서 항목에 각 식의 결과가 표시됩니다.As you view each page of the report, you see the results for each expression in the rendered report items.

다음 표에서는 식에 포함할 수 있는 기본 제공 함수의 범주를 나열합니다.The following table lists categories of built-in functions that you can include in an expression:

참고

SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 페이지를 매긴 보고서 정의(.rdl) 파일을 만들고 수정할 수 있습니다.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다.Each authoring environment provides different ways to create, open, and save reports and related items.

기본 제공 집계 함수Built-in Aggregate Functions

다음 기본 제공 함수는 기본 범위 또는 명명된 범위에서 Null이 아닌 숫자 데이터의 집합에 대한 요약 값을 계산합니다.The following built-in functions calculate summary values for a set of non-null numeric data in the default scope or the named scope.

함수Function DescriptionDescription
AvgAvg 식으로 지정되어 정해진 범위에서 계산되는 Null이 아닌 모든 숫자 값의 평균을 반환합니다.Returns the average of all non-null numeric values specified by the expression, evaluated in the given scope.
CountCount 식으로 지정되어 정해진 범위의 컨텍스트에서 계산되는 Null이 아닌 값의 개수를 반환합니다.Returns a count of non-null values specified by the expression, evaluated in the context of the given scope.
CountDistinctCountDistinct 식으로 지정되어 정해진 범위의 컨텍스트에서 계산되는 Null이 아닌 모든 고유 값의 개수를 반환합니다.Returns a count of all distinct non-null values specified by the expression, evaluated in the context of the given scope.
MaxMax 특정 범위의 컨텍스트에서 식에 의해 지정된 Null이 아닌 모든 숫자 값의 최대값을 반환합니다.Returns the maximum value of all non-null numeric values specified by the expression, in the context of the given scope. 이 함수로 차트 축의 최대값을 지정하여 눈금을 제어할 수 있습니다.You can use this for specifying a chart axis maximum value to control the scale.
MinMin 지정된 범위의 컨텍스트에서 식으로 지정되는 Null이 아닌 모든 숫자 값의 최소값을 반환합니다.Returns the minimum value of all non-null numeric values specified by the expression, in the context of the given scope. 이 함수로 차트 축의 최소값을 지정하여 눈금을 제어할 수 있습니다.You can use this for specifying a chart axis minimum value to control the scale.
StDevStDev 식으로 지정되어 정해진 범위에서 계산되는 Null이 아닌 모든 숫자 값의 표준 편차를 반환합니다.Returns the standard deviation of all non-null numeric values specified by the expression, evaluated in the given scope.
StDevPStDevP 식으로 지정되어 정해진 범위의 컨텍스트에서 계산되는 Null이 아닌 모든 숫자 값의 모집단 표준 편차를 반환합니다.Returns the population standard deviation of all non-null numeric values specified by the expression, evaluated in the context of the given scope.
SumSum 식으로 지정되어 정해진 범위에서 계산되는 Null이 아닌 모든 숫자 값의 합계를 반환합니다.Returns the sum of all the non-null numeric values specified by the expression, evaluated in the given scope.
UnionUnion 식으로 지정되어 정해진 범위에서 계산되는 SqlGeometry 또는 SqlGeography 형식의 Null이 아닌 모든 공간 데이터 값의 합집합을 반환합니다.Returns the union of all the non-null spatial data values of type SqlGeometry or SqlGeography that are specified by the expression, evaluated in the given scope.
VarVar 식으로 지정되어 정해진 범위에서 계산되는 Null이 아닌 모든 숫자 값의 분산을 반환합니다.Returns the variance of all non-null numeric values specified by the expression, evaluated in the given scope.
VarPVarP 식으로 지정되어 정해진 범위의 컨텍스트에서 계산되는 Null이 아닌 모든 숫자 값의 모집단 분산을 반환합니다.Returns the population variance of all non-null numeric values specified by the expression, evaluated in the context of the given scope.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

기본 제공 필드, 컬렉션 및 집계 함수의 제한 사항Restrictions on Built-in Fields, Collections, and Aggregate Functions

다음 표에는 전역 기본 제공 컬렉션에 대한 참조가 포함된 식을 추가할 수 있는 보고서 위치에서의 제한 사항이 요약되어 있습니다.The following table summarizes restrictions in report locations on where you can add expressions that contain references to global built-in collections.

보고서의 위치Location in Report 필드Fields 매개 변수Parameters ReportItemsReportItems PageNumberPageNumber

TotalPagesTotalPages
DataSourceDataSource

DataSetDataSet
변수Variables RenderFormatRenderFormat
페이지 머리글Page Header

페이지 바닥글Page Footer
Yes Yes 최대 하나At most one

참고 1Note 1
Yes Yes Yes Yes
본문Body Yes

참고 2Note 2
Yes 현재 범위 또는 포함하는 범위의 항목만Only items in the currnet scope or a containing scope

참고 3Note 3
아니오No Yes Yes Yes
보고서 매개 변수Report Parameter 아니오No 목록 앞부분의 매개 변수만Only parameters earlier in the list

참고 4Note 4
아니오No 아니오No 아니오No 아니오No 아니오No
필드Field Yes Yes 아니오No 아니오No 아니오No 아니오No 아니오No
쿼리 매개 변수Query Parameter 아니오No Yes 아니오No 아니오No 아니오No 아니오No 아니오No
그룹 식Group Expression Yes Yes 아니오No 아니요No Yes 아니오No 아니오No
정렬 식Sort Expression Yes Yes 아니오No 아니요No Yes Yes

참고 5Note 5
아니오No
필터 식Filter Expression Yes Yes 아니오No 아니요No Yes Yes

참고 6Note 6
아니오No
코드Code 아니오No Yes

참고 7Note 7
아니오No 아니오No 아니오No 아니오No 아니오No
보고서 언어Report.Language 아니오No Yes 아니오No 아니오No 아니오No 아니오No 아니오No
변수Variables Yes Yes 아니오No 아니요No Yes 현재 범위 또는 포함하는 범위Current or containing scope 아니오No
집계Aggregates Yes Yes 페이지 머리글/페이지 바닥글에서만Only in page header/page footer 보고서 항목 집계에서만Only in report item aggregates Yes 아니오No 아니오No
조회 함수Lookup functions Yes Yes Yes 아니오No Yes 아니오No 아니오No
  • 참고 1.Note 1. ReportItems는 렌더링된 보고서 페이지에 있어야 하며, 그렇지 않은 경우 값이 null입니다.ReportItems must exist in the rendered report page, or their value is Null. 보고서 항목의 표시 유형이 False로 계산되는 식에 따라 달라지는 경우 해당 보고서 항목이 페이지에 없습니다.If the visibility of a report item depends on an expression that evaluates to False, the report item does not exist on the page.

  • 참고 2.Note 2. 필드 참조가 그룹 범위에서 사용되고 필드 참조가 그룹 식에 포함되어 있지 않은 경우 범위에 값이 하나만 있지 않으면 필드의 값이 정의되지 않습니다.If a field reference is used in a group scope, and the field reference is not included in the group expression, then the value for the field is undefined, unless there is only one value in the scope. 값을 지정하려면 First 또는 Last와 그룹 범위를 사용합니다.To specify a value, use First or Last and the group scope.

  • 참고 3.Note 3. ReportItems에 대한 참조를 포함하는 식은 동일한 그룹 범위나 포함하는 그룹 범위에서 다른 ReportItems의 값을 지정할 수 있습니다.Expressions that include a reference to ReportItems can specify values for other ReportItems in the same group scope or in a containing group scope.

  • 참고 4.Note 4. 이전 매개 변수의 속성 값이 null일 수 있습니다.Property values for earlier parameters might be null.

  • 참고 5.Note 5. 멤버 정렬에서만.In Member sorts only. 데이터 영역 정렬 식에서는 사용할 수 없습니다.Cannot use in data region sort expressions.

  • 고 6.Note 6. 멤버 필터에서만.In Member filters only. 데이터 영역 또는 데이터 집합 필터 식에서는 사용할 수 없습니다.Cannot use in data region or dataset filter expressions.

  • 참고 7.Note 7. 매개 변수 컬렉션은 코드 블록이 처리된 후까지 초기화되지 않으므로 메서드를 사용하여 초기화 시 매개 변수를 제어할 수 없습니다.The Parameters collection is not initialized until after the Code block is processed, so methods cannot be used to control parameters on initialization.

  • 참고 8.Note 8. Count 및 CountDistinct를 제외한 모든 집계의 데이터 형식은 모든 값에 대해 동일한 데이터 형식이거나 Null이어야 합니다.Data type for all aggregates except Count and CountDistinct must be the same data type, or null, for all values.

    맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

중첩 집계의 제한 사항Restrictions on Nested Aggregates

다음 표에는 다른 집계 함수를 중첩 집계로 지정할 수 있는 집계 함수의 제한 사항이 요약되어 있습니다.The following table summarizes restrictions on which aggregates functions can specify other aggregate functions as nested aggregates.

컨텍스트Context RunningValueRunningValue RowNumberRowNumber 첫째First

마지막Last
PreviousPrevious Sum 및 기타 미리 정렬 함수Sum and Other Presort functions ReportItem 집계ReportItem aggregates 조회 함수Lookup functions Aggregate 함수Aggregate Function
Running ValueRunning Value 아니오No 아니오No 아니오No 아니요No Yes 아니오No Yes 아니오No
첫째First

마지막Last
아니오No 아니오No 아니오No 아니요No Yes 아니오No 아니오No 아니오No
PreviousPrevious Yes Yes Yes 아니오No Yes 아니오No Yes 아니오No
Sum 및 기타 미리 정렬 함수Sum and other Presort functions 아니오No 아니오No 아니오No 아니요No Yes 아니오No Yes 아니오No
ReportItem 집계ReportItem aggregates 아니오No 아니오No 아니오No 아니오No 아니오No 아니오No 아니오No 아니오No
조회 함수Lookup functions Yes Yes

참고 1Note 1
Yes

참고 1Note 1
Yes

참고 1Note 1
Yes

참고 1Note 1
Yes

참고 1Note 1
아니오No 아니오No
Aggregate 함수Aggregate Function 아니오No 아니오No 아니오No 아니오No 아니오No 아니오No 아니오No 아니오No
  • 참고 1.Note 1. 집계 함수는 Lookup 함수가 집계에 포함되지 않은 경우 Lookup 함수의 Source 식 안에서만 허용됩니다.Aggregate functions are only allowed inside the Source expression of a Lookup function if the Lookup function is not contained in an aggregate. 집계 함수는 Lookup 함수의 Destination 또는 Result 식 안에서 허용되지 않습니다.Aggregate functions are not allowed inside the Destination or Result expressions of a Lookup function.

    맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

실행 값 계산Calculating Running Values

다음 기본 제공 함수는 데이터의 집합에 대한 실행 값을 계산합니다.The following built-in functions calculate running values for a set of data. RowNumber 는 포함하는 범위 내의 각 행에 대해 증가하는 개수의 실행 값을 반환한다는 점에서 RunningValue 와 비슷합니다.RowNumber is like RunningValue in that it returns the running value of a count that increments for each row within the containing scope. 이러한 함수의 범위 매개 변수는 개수 계산을 다시 시작하는 시점을 제어하는 포함하는 범위를 지정해야 합니다.The scope parameter for these functions must specify a containing scope, which controls when the count restarts.

함수Function DescriptionDescription
RowNumberRowNumber 지정한 범위에서 행 개수의 실행 개수를 반환합니다.Returns a running count of the number of rows for the specified scope. RowNumber 는 0이 아닌 1부터 계산을 다시 시작합니다.The RowNumber function restarts counting at 1, not 0.
RunningValueRunningValue 식으로 지정되어 정해진 범위에서 계산되는 Null이 아닌 모든 숫자 값의 실행 집계를 반환합니다.Returns a running aggregate of all non-null numeric values specified by the expression, evaluated for the given scope.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

행 개수 검색Retrieving Row Counts

다음 기본 제공 함수는 지정된 범위에서 행 개수를 계산합니다.The following built-in function calculates the number of rows in the given scope. 이 함수를 사용하여 Null 값을 가진 행을 포함한 모든 행의 개수를 계산할 수 있습니다.Use this function to count all rows, including rows with null values.

함수Function DescriptionDescription
CountRowsCountRows Null 값을 가진 행을 포함하여 지정된 범위의 행 수를 반환합니다.Returns the number of rows in the specified scope, including rows with null values.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

다른 데이터 집합에서 값 조회Looking Up Values from Another Dataset

다음 조회 함수는 지정된 데이터 집합에서 값을 검색합니다.The following lookup functions retrieve values from a specified dataset.

함수Function DescriptionDescription
Lookup 함수Lookup Function 데이터 집합에서 지정된 식에 대한 값을 반환합니다.Returns a value from a dataset for a specified expression.
LookupSet 함수LookupSet Function 데이터 집합에서 지정된 식에 대한 값 집합을 반환합니다.Returns a set of values from a dataset for a specified expression.
Multilookup 함수Multilookup Function 이름/값 쌍을 포함하는 데이터 집합에서 이름 집합과 처음 일치하는 값 집합을 반환합니다.Returns the set of first-match values for a set of names from a dataset that contains name/value pairs.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

정렬 종속 값 검색Retrieving Sort-Dependent Values

다음 기본 제공 함수는 지정된 범위 내의 첫 번째, 마지막 또는 이전 값을 반환합니다.The following built-in functions return the first, last, or previous value within a given scope. 이러한 함수는 데이터 값의 정렬 순서에 따라 달라집니다.These functions depend on the sort order of the data values. 예를 들어 이러한 함수를 사용하여 페이지의 첫 번째와 마지막 값을 찾아 사전 스타일의 페이지 머리글을 만들 수 있습니다.Use these functions, for example, to find the first and last values on a page to create a dictionary-style page header. 예를 들어 Previous 를 사용하여 특정 범위 내에서 한 행에 있는 값을 이전 행의 값과 비교하여 테이블에서 전년동기대비 백분율 값을 찾을 수 있습니다.Use Previous to compare a value in one row to the previous row's value within a specific scope, for example, to find percentage year over year values in a table.

함수Function DescriptionDescription
첫째First 지정된 식의 지정된 범위에서 첫 번째 값을 반환합니다.Returns the first value in the given scope of the specified expression.
마지막Last 지정된 식의 지정된 범위에서 마지막 값을 반환합니다.Returns the last value in the given scope of the specified expression.
PreviousPrevious 지정된 범위 내에서 항목의 이전 인스턴스에 대한 지정된 집계 값 또는 값을 반환합니다.Returns the value or the specified aggregate value for the previous instance of an item within the specified scope.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

서버 집계 검색Retrieving Server Aggregates

다음 기본 제공 함수는 데이터 공급자에서 사용자 지정 집계를 검색합니다.The following built-in function retrieves custom aggregates from the data provider. 예를 들어 Analysis ServicesAnalysis Services 데이터 원본 유형을 사용하면 데이터 원본 서버에서 계산된 집계를 검색하여 그룹 머리글에 사용할 수 있습니다.For example, using an Analysis ServicesAnalysis Services data source type, you can retrieve aggregates calculated on the data source server for use in a group header.

함수Function DescriptionDescription
집계Aggregate 데이터 공급자가 정의한 대로 지정한 식의 사용자 지정 집계를 반환합니다.Returns a custom aggregate of the specified expression, as defined by the data provider.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

범위 테스트Testing for Scope

다음 기본 제공 함수는 보고서 항목의 현재 컨텍스트를 테스트하여 특정 범위에 속하는지 확인합니다.The following built-in function tests the current context of a report item to see if it is a member of a specific scope.

함수Function DescriptionDescription
InScopeInScope 항목의 현재 인스턴스가 지정한 범위 내에 있는지 여부를 나타냅니다.Indicates whether the current instance of an item is within the specified scope.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

재귀 수준 검색Retrieving Recursive Level

다음 기본 제공 함수는 재귀 계층이 처리될 때 현재 수준을 검색합니다.The following built-in function retrieves the current level when a recursive hierarchy is processed. 이 함수의 결과를 입력란의 Padding 속성에 사용하여 재귀 그룹에 대한 시각적 계층의 들여쓰기 수준을 제어할 수 있습니다.Use the result of this function with the Padding property in a text box to control the indent level of a visual hierarchy for a recursive group. 자세한 내용은 재귀 계층 구조 그룹 생성(보고서 작성기 및 SSRS)을 참조하세요.For more information, see Creating Recursive Hierarchy Groups (Report Builder and SSRS).

함수Function DescriptionDescription
LevelLevel 재귀 계층의 현재 수준을 반환합니다.Returns the current level of depth in a recursive hierarchy.

맨 위 링크와 함께 사용되는 화살표 아이콘맨 위로 이동Arrow icon used with Back to Top linkBack to Top

관련 항목:See Also

보고서에 사용되는 식(보고서 작성기 및 SSRS) Expression Uses in Reports (Report Builder and SSRS)
식 예(보고서 작성기 및 SSRS) Expression Examples (Report Builder and SSRS)
합계, 집계 및 기본 제공 컬렉션의 식 범위(보고서 작성기 및 SSRS)Expression Scope for Totals, Aggregates, and Built-in Collections (Report Builder and SSRS)