보고서 작성기 함수 - Lookup 함수Report Builder Functions - Lookup Function

이름/값 쌍을 포함하는 데이터 집합에서 지정된 이름과 일치하는 첫 번째 값을 반환합니다.Returns the first matching value for the specified name from a dataset that contains name/value pairs.

참고

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.

구문Syntax


Lookup(source_expression, destination_expression, result_expression, dataset)  

매개 변수Parameters

source_expressionsource_expression
(Variant) 현재 범위에서 평가되고, 조회할 키 또는 이름을 지정하는 식입니다.(Variant) An expression that is evaluated in the current scope and that specifies the name or key to look up. =Fields!ProdID.Value)을 입력합니다.For example, =Fields!ProdID.Value.

destination_expressiondestination_expression
(Variant) 데이터 집합의 각 행에 대해 평가되고, 일치시킬 키 또는 이름을 지정하는 식입니다.(Variant) An expression that is evaluated for each row in a dataset and that specifies the name or key to match on. =Fields!ProductID.Value)을 입력합니다.For example, =Fields!ProductID.Value.

result_expressionresult_expression
(Variant) source_expression = destination_expression인 데이터 집합의 행에 대해 계산되고 검색할 값을 지정하는 식입니다.(Variant) An expression that is evaluated for the row in the dataset where source_expression = destination_expression, and that specifies the value to retrieve. =Fields!ProductName.Value)을 입력합니다.For example, =Fields!ProductName.Value.

데이터 집합(dataset)dataset
보고서의 데이터 집합 이름을 지정하는 상수입니다.A constant that specifies the name of a dataset in the report. 예를 들면 "Products"입니다.For example, "Products".

반환 값Return

Variant를 반환하거나, 일치하는 항목이 없으면 Nothing 을 반환합니다.Returns a Variant, or Nothing if there is no match.

주의Remarks

Lookup 을 사용하여 일 대 일 관계의 이름/값 쌍에 대한 지정된 데이터 집합에서 값을 검색할 수 있습니다.Use Lookup to retrieve the value from the specified dataset for a name/value pair where there is a 1-to-1 relationship. 예를 들어 테이블에 있는 ID 필드의 경우 Lookup 을 사용하여 데이터 영역에 바인딩되지 않은 데이터 집합에서 해당하는 이름 필드를 검색할 수 있습니다.For example, for an ID field in a table, you can use Lookup to retrieve the corresponding Name field from a dataset that is not bound to the data region.

Lookup 은 다음을 수행합니다.Lookup does the following:

  • 현재 범위에서 원본 식을 평가합니다.Evaluates the source expression in the current scope.

  • 지정된 데이터 집합의 데이터 정렬을 기반으로 필터가 적용된 후 지정된 데이터 집합의 각 행에 대해 대상 식을 평가합니다.Evaluates the destination expression for each row of the specified dataset after filters have been applied, based on the collation of the specified dataset.

  • 원본 식과 대상 식의 첫 번째 일치 항목이 발견되면 데이터 집합의 해당 행에 대해 결과 식을 평가합니다.On the first match of source expression and destination expression, evaluates the result expression for that row in the dataset.

  • 결과 식 값을 반환합니다.Returns the result expression value.

    일 대 다 관계가 있는 경우 단일 이름 또는 키 필드에 대해 여러 값을 검색하려면 LookupSet 함수(보고서 작성기 및 SSRS)를 사용합니다.To retrieve multiple values for a single name or key field where there is a 1-to-many relationship, use LookupSet Function (Report Builder and SSRS). 값 집합에 대한 Lookup을 호출하려면 Multilookup 함수(보고서 작성기 및 SSRS)를 사용합니다.To call Lookup for a set of values, use Multilookup Function (Report Builder and SSRS).

    다음과 같은 제한 사항이 있습니다.The following restrictions apply:

  • Lookup 은 모든 필터 식이 적용된 후 평가됩니다.Lookup is evaluated after all filter expressions are applied.

  • 조회 수준이 하나만 지원됩니다.Only one level of lookup is supported. 원본, 대상 또는 결과 식에는 조회 함수에 대한 참조가 포함될 수 없습니다.A source, destination, or result expression cannot include a reference to a lookup function.

  • 원본 식과 대상 식의 데이터 형식이 같아야 합니다.Source and destination expressions must evaluate to the same data type. 반환 형식은 평가된 결과 식의 데이터 형식과 같습니다.The return type is the same as the data type of the evaluated result expression.

  • 원본, 대상 및 결과 식에는 보고서 또는 그룹 변수에 대한 참조가 포함될 수 없습니다.Source, destination, and result expressions cannot include references to report or group variables.

  • Lookup 은 다음 보고서 항목에 대한 식으로 사용할 수 없습니다.Lookup cannot be used as an expression for the following report items:

    • 데이터 원본에 대한 동적 연결 문자열Dynamic connection strings for a data source.

    • 데이터 집합의 계산된 필드Calculated fields in a dataset.

    • 데이터 집합의 쿼리 매개 변수Query parameters in a dataset.

    • 데이터 집합의 필터Filters in a dataset.

    • 보고서 매개 변수Report parameters.

    • Report.Language 속성입니다.The Report.Language property.

    자세한 내용은 집계 함수 참조(보고서 작성기 및 SSRS)합계, 집계 및 기본 제공 컬렉션의 식 범위(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Aggregate Functions Reference (Report Builder and SSRS) and Expression Scope for Totals, Aggregates, and Built-in Collections (Report Builder and SSRS).

예제Example

다음 예에서는 제품 식별자 ProductID에 대한 필드를 포함하는 데이터 집합에 테이블이 바인딩되어 있다고 가정합니다.In the following example, assume that a table is bound to a dataset that includes a field for the product identifier ProductID. "Product"라는 별도의 데이터 집합에는 해당하는 제품 식별자 ID와 제품 이름 Name이 포함되어 있습니다.A separate dataset called "Product" contains the corresponding product identifier ID and the product name Name.

다음 식에서 Lookup 은 ProductID 값을 "Product" 데이터 집합의 각 행에 있는 ID와 비교한 다음, 일치하는 항목이 있으면 해당 행의 Name 필드 값을 반환합니다.In the following expression, Lookup compares the value of ProductID to ID in each row of the dataset called "Product" and, when a match is found, returns the value of the Name field for that row.

=Lookup(Fields!ProductID.Value, Fields!ID.Value, Fields!Name.Value, "Product")  

관련 항목:See Also

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