데이터 집합 필드 컬렉션(보고서 작성기 및 SSRS)Dataset Fields Collection (Report Builder and SSRS)

데이터 집합 필드는 데이터 연결의 데이터를 나타냅니다.Dataset fields represent the data from a data connection. 필드는 숫자 데이터나 숫자가 아닌 데이터를 나타낼 수 있습니다.A field can represent either numeric or non-numeric data. 예로는 판매액, 총 판매액, 고객 이름, 데이터베이스 식별자, URL, 이미지, 공간 데이터, 전자 메일 주소 등이 있습니다.Examples include sales amounts, total sales, customer names, database identifiers, URLs, images, spatial data, and e-mail addresses. 디자인 화면에서 필드는 입력란, 테이블 및 차트와 같은 보고서 항목에서 식으로 나타납니다.On the design surface, fields appear as expressions in report items such as text boxes, tables, and charts.

보고서에는 데이터 집합 필드, 데이터 집합 계산 필드 및 기본 제공 필드 등 세 가지 유형의 필드가 있고 보고서 데이터 창에 표시됩니다.A report has three types of fields and displays them in the Report Data pane: dataset fields, dataset calculated fields, and built-in fields.

  • 데이터 집합 필드.Dataset fields. 데이터 집합 쿼리가 데이터 원본에 대해 실행될 때 반환될 필드의 컬렉션을 나타내는 메타데이터입니다.The metadata that represents the collection of fields that will be returned when the dataset query runs on the data source.

  • 데이터 집합 계산 필드.Dataset calculated fields. 데이터 집합에 대해 만드는 추가 필드입니다.Additional fields that you create for the dataset. 각 계산 필드는 사용자가 정의하는 식을 계산하여 만들어집니다.Each calculated field is created by evaluating an expression that you define.

  • 기본 제공 필드.Built-in fields. 보고서를 처리할 때 보고서 이름 또는 시간과 같은 보고서 정보를 제공하는 보고서 작성기에서 제공하는 필드의 컬렉션을 나타내는 메타데이터입니다.The metadata that represents a collection of fields provided by Report Builder that provide report information such as the report name or the time when the report was processed. 자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Built-in Globals and Users References (Report Builder and SSRS).

    데이터 집합 필드 이름은 보고서 데이터 집합 정의의 일부로 저장됩니다.Dataset field names are saved as part of the report dataset definition. 자세한 내용은 보고서 포함된 데이터 집합 및 공유 데이터 집합(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Report Embedded Datasets and Shared Datasets (Report Builder and SSRS).

참고

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.

데이터 집합 필드 및 쿼리Dataset Fields and Queries

데이터 집합 필드는 데이터 집합 쿼리 명령 및 사용자가 정의하는 계산 필드로 지정됩니다.Dataset fields are specified by the dataset query command and by any calculated fields that you define. 보고서에 표시되는 필드의 컬렉션은 사용하는 데이터 집합의 유형에 따라 다릅니다.The collection of fields that you see in your report depends on the type of dataset you have:

  • 공유 데이터 집합.Shared dataset. 필드 컬렉션은 보고서에 공유 데이터 집합을 직접 추가했을 때나 공유 데이터 집합이 포함된 보고서 파트를 추가했을 때 공유 데이터 집합 정의의 쿼리에 대한 필드의 목록입니다.The field collection is the list of fields for the query in the shared dataset definition at the time that you directly added the shared dataset to your report, or when you added a report part that included the shared dataset. 공유 데이터 집합 정의가 보고서 서버에서 변경될 때 로컬 필드 컬렉션은 변경되지 않습니다.The local field collection does not change when the shared dataset definition changes on the report server. 로컬 필드 컬렉션을 업데이트하려면 로컬 공유 데이터 집합의 목록을 새로 고쳐야 합니다.To update the local field collection, you must refresh the list for the local shared dataset.

  • 포함된 데이터 집합.Embedded dataset. 필드 컬렉션은 데이터 원본에 대해 현재 쿼리를 실행할 때 반환되는 필드의 목록입니다.The field collection is the list of fields that is returned from running the current query against the data source.

    자세한 내용은 보고서 데이터 창에서 필드 추가, 편집, 새로 고침(보고서 작성기 및 SSRS)을 참조하세요.For more information see, Add, Edit, Refresh Fields in the Report Data Pane (Report Builder and SSRS)

계산 필드Calculated Fields

식을 만들어 계산 필드를 직접 지정합니다.You specify a calculated field manually by creating an expression. 계산 필드를 사용하면 데이터 원본에 없는 새 값을 만들 수 있습니다.Calculated fields can be used to create new values that do not exist on the data source. 예를 들어 계산 필드는 새 값, 필드 값 집합에 대한 사용자 지정 정렬 순서 또는 다른 데이터 형식으로 변환되는 기존 필드를 나타낼 수 있습니다.For example, a calculated field can represent a new value, a custom sort order for a set of field values, or an existing field that is converted to a different data type.

계산 필드는 보고서에 로컬이며 공유 데이터 집합의 일부로 저장될 수 없습니다.Calculated fields are local to a report and cannot be saved as part of a shared dataset.

자세한 내용은 보고서 데이터 창에서 필드 추가, 편집, 새로 고침(보고서 작성기 및 SSRS)을 참조하세요.For more information, see Add, Edit, Refresh Fields in the Report Data Pane (Report Builder and SSRS).

엔터티 및 엔터티 필드Entities and Entity Fields

보고서 모델 데이터 원본으로 작업하는 경우 엔터티 및 엔터티 필드를 보고서 데이터로 지정합니다.If you are working with a report model data source, you specify the entities and entity fields as your report data. 보고서 모델의 쿼리 디자이너에서 대화형으로 관련 엔터티를 탐색 및 선택하고 보고서 데이터 집합에 포함할 필드를 선택할 수 있습니다.In the query designer for a report model, you can interactively explore and select related entities and choose the fields that you want to include in your report dataset. 쿼리 디자인을 마친 후 보고서 데이터 창에서 엔터티 식별자와 엔터티 필드의 컬렉션을 볼 수 있습니다.After you finish designing the query, you can see the collection of entity identifiers and entity fields in the Report Data pane. 엔터티 식별자는 보고서 모델에서 자동으로 생성되며 일반적으로 최종 사용자에게 표시되지 않습니다.Entity identifiers are generated automatically by the report model and are typically not displayed for the end user.

확장 필드 속성 사용Using Extended Field Properties

다차원 쿼리를 지원하는 SQL ServerSQL Server Analysis ServicesAnalysis Services와 같은 데이터 원본은 필드의 필드 속성을 지원합니다.Data sources that support multidimensional queries, such as SQL ServerSQL Server Analysis ServicesAnalysis Services, support field properties on fields. 필드 속성은 쿼리의 결과 집합에 나타나지만 보고서 데이터 창에 표시되지 않습니다.Field properties appear in the result set for a query, but are not visible in the Report Data pane. 보고서에서 이 필드 속성을 계속 사용할 수 있습니다.They are still available to use in your report. 필드의 속성을 참조하려면 필드를 보고서로 끌고 기본 속성 Value 를 원하는 속성의 필드 이름으로 변경합니다.To refer to a property for a field, drag the field onto the report, and change the default property Value to the field name of the property you want. 예를 들어 Analysis ServicesAnalysis Services 큐브에서 큐브 셀의 값에 대한 서식을 정의할 수 있습니다.For example, in an Analysis ServicesAnalysis Services cube, you can define formats for values in the cube cells. 서식이 지정된 값은 필드 속성 FormattedValue를 통해 사용할 수 있습니다.The formatted value is available by using the field property FormattedValue. 값을 사용하고 입력란의 서식 속성을 설정하는 대신 값을 직접 사용하려면 필드를 입력란으로 끌고 기본 식 =Fields!FieldName.Value=Fields!FieldName.FormattedValue로 변경합니다.To use the value directly instead of using a value and setting the format property of the text box, drag the field to the text box and change the default expression =Fields!FieldName.Value to =Fields!FieldName.FormattedValue.

참고

모든 데이터 원본에 대해 모든 Field 속성을 사용할 수 있는 것은 아닙니다.Not all Field properties can be used for all data sources. ValueIsMissing 속성은 모든 데이터 원본에 대해 정의됩니다.The Value and IsMissing properties are defined for all data sources. 미리 정의된 다른 속성(다차원 데이터 원본에 대한 Key, UniqueNameParentUniqueName )은 데이터 원본에서 제공하는 경우에만 지원됩니다.Other predefined properties (such as Key, UniqueName, and ParentUniqueName for multidimensional data sources) are supported only if the data source provides those properties. 일부 데이터 공급자는 사용자 지정 속성을 지원합니다.Custom properties are supported by some data providers. 자세한 내용은 보고서 포함된 데이터 집합 및 공유 데이터 집합(보고서 작성기 및 SSRS)를 참조하세요.For more information, see specific topics about extended field properties for your data source type in Report Embedded Datasets and Shared Datasets (Report Builder and SSRS). 예를 들어, SQL ServerSQL Server Analysis ServicesAnalysis Services 데이터 원본에 대한 자세한 내용은 Analysis Services 데이터베이스에 대한 확장 필드 속성(SSRS)을 참조하세요.For example, for a SQL ServerSQL Server Analysis ServicesAnalysis Services data source, see Extended Field Properties for an Analysis Services Database (SSRS).

필드에 대한 기본 식 이해Understanding Default Expressions for Fields

입력란은 보고서 본문의 입력란 보고서 항목 또는 테이블릭스 데이터 영역에 있는 셀의 입력란일 수 있습니다.A text box can be a text box report item in the report body, or a text box in a cell in a tablix data region. 입력란에 필드를 연결할 때 입력란 위치에서 필드 참조에 대한 기본 식을 결정합니다.When you link a field with a text box, the location of the text box determines the default expression for the field reference. 보고서 본문에서 입력란 값 식은 집계 및 데이터 집합을 지정해야 합니다.In the report body, a text box value expression must specify an aggregate and a dataset. 보고서에 하나의 데이터 집합만 존재하는 경우 이 기본 식이 생성됩니다.If only one dataset exists in the report, this default expression is created for you. 숫자 값을 나타내는 필드의 경우 기본 집계 함수는 Sum입니다.For a field that represents a numeric value, the default aggregate function is Sum. 숫자가 아닌 값을 나타내는 필드의 경우 기본 집계는 First입니다.For a field that represents a non-numeric value, the default aggregate is First.

테이블릭스 데이터 영역에서 기본 필드 식은 필드를 추가하는 입력란의 행 및 그룹 멤버 자격에 따라 다릅니다.In a tablix data region, the default field expression depends on the row and group memberships of the text box that you add the field to. 테이블의 정보 행에 있는 입력란에 추가되는 Sales 필드에 대한 필드 식은 [Sales]입니다.The field expression for the field Sales, when added to a text box in the detail row of a table, is [Sales]. 동일한 필드를 그룹 머리글의 입력란에 추가하는 경우 그룹 머리글에서 정보 값이 아닌 그룹에 대한 요약 값을 표시하므로 기본 식은 (Sum[Sales])입니다.If you add the same field to a text box in a group header, the default expression is (Sum[Sales]), because the group header displays summary values for the group, not detail values. 보고서가 실행되면 보고서 처리기에서 각 식을 계산하고 보고서의 결과를 대체합니다.When the report runs, the report processor evaluates each expression and substitutes the result in the report.

식에 대한 자세한 내용은 식(보고서 작성기 및 SSRS)을 참조하세요.For more information about expressions, see Expressions (Report Builder and SSRS).

필드 데이터 형식Field Data Types

데이터 집합을 만들 때 데이터 원본의 필드 데이터 형식이 보고서에서 사용하는 데이터 형식과 정확하게 일치하지 않을 수 있습니다.When you create a dataset, the data types of the fields on the data source may not be exactly the data types used in a report. 데이터 형식이 하나 또는 두 개의 매핑 계층을 거칠 수 있습니다.Data types may go through one or two mapping layers. 데이터 처리 확장 프로그램 또는 데이터 공급자는 데이터 원본의 데이터 형식을 CLR(공용 언어 런타임) 데이터 형식으로 매핑할 수 있습니다.The data processing extension or data provider may map data types from the data source to common language runtime (CLR) data types. 데이터 처리 확장 프로그램에서 반환하는 데이터 형식은 .NET Framework.NET Framework에서 CLR(공용 언어 런타임) 데이터 형식의 하위 집합으로 매핑됩니다.The data types returned by data processing extensions are mapped to a subset of common language runtime (CLR) data types from the .NET Framework.NET Framework.

데이터 원본에서 데이터는 데이터 원본에서 지원하는 데이터 형식으로 저장됩니다.On the data source, the data is stored in data types supported by the data source. 예를 들어 SQL ServerSQL Server 데이터베이스의 데이터는 SQL ServerSQL Server nvarchar 또는 datetime 과 같이 지원되는데이터 형식 중 하나여야 합니다.For example, data in a SQL ServerSQL Server database must be one of the supported SQL ServerSQL Server data types such as nvarchar or datetime. 데이터 원본에서 데이터를 검색하는 경우 데이터는 데이터 원본 유형과 연결된 데이터 처리 확장 프로그램 또는 데이터 공급자를 통과합니다.When you retrieve data from the data source, the data passes through a data processing extension or data provider that is associated with the data source type. 데이터 처리 확장 프로그램에 따라 데이터가 데이터 원본에서 사용되는 데이터 형식에서 데이터 처리 확장 프로그램에서 지원하는 데이터 형식으로 변환될 수 있습니다.Depending on the data processing extension, data may be converted from the data types used by data source into data types supported by the data processing extension. Reporting ServicesReporting ServicesSQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)와 함께 설치된 CLR(공용 언어 런타임)에서 지원하는 데이터 형식을 사용합니다. uses data types supported by the common language runtime (CLR) that is installed with SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT). 데이터 공급자는 결과 집합의 각 열을 네이티브 데이터 형식에서 .NET Framework.NET Framework CLR 데이터 형식으로 매핑합니다.The data provider maps each column in the result set from the native data type to a .NET Framework.NET Framework common language runtime (CLR) data type.

각 단계에서 데이터는 다음 목록에서 설명하는 데이터 형식으로 표현됩니다.At each stage, the data is represented by the data types as described in the following list:

  • 데이터 원본 연결하는 데이터 원본 유형 버전에서 지원하는 데이터 형식입니다.Data source The data types supported by the version of the type of data source to which you are connecting.

    예를 들어 SQL ServerSQL Server 데이터 원본에 대한 일반적인 데이터 형식에는 int, datetimevarchar가 있습니다.For example, typical data types for a SQL ServerSQL Server data source include int, datetime, and varchar. SQL Server 2008SQL Server 2008 에서 새로 도입된 데이터 형식으로 date, time, datetimetzdatetime2에 대한 지원을 추가했습니다.Data types introduced by SQL Server 2008SQL Server 2008 added support for date, time, datetimetz, and datetime2. 자세한 내용은 데이터 형식(Transact-SQL)을 참조하세요.For more information, see Data Types (Transact-SQL).

  • 데이터 공급자 또는 데이터 처리 확장 프로그램 데이터 원본에 연결할 때 선택하는 데이터 처리 확장 프로그램의 데이터 공급자 버전에서 지원하는 데이터 형식입니다.Data provider or data processing extension The data types supported by the version of the data provider of the data processing extension you select when you connect to the data source. .NET Framework.NET Framework 를 기반으로 하는 데이터 공급자는 CLR에서 지원하는 데이터 형식을 사용합니다.Data providers based on the .NET Framework.NET Framework use data types supported by the CLR. .NET Framework.NET Framework 데이터 공급자 데이터 형식 지원에 대한 자세한 내용은 MSDN의 데이터 형식 매핑(ADO.NET)기본 형식 사용 을 참조하세요.For more information about .NET Framework.NET Framework data provider data types, see Data Type Mappings (ADO.NET) and Working with Base Types on MSDN.

    예를 들어 .NET Framework.NET Framework 에서 지원하는 일반적인 데이터 형식에는 Int32String이 있습니다.For example, typical data types supported by the .NET Framework.NET Framework include Int32 and String. 달력 날짜 및 시간은 DateTime 구조에서 지원합니다.Calendar dates and times are supported by the DateTime structure. .NET Framework.NET Framework 2.0 서비스 팩 1은 표준 시간대 오프셋이 있는 날짜에 대한 DateTimeOffset 구조를 새로 지원합니다.The .NET Framework.NET Framework 2.0 Service Pack 1 introduced support for the DateTimeOffset structure for dates with a time zone offset.

    참고

    보고서 서버는 보고서 서버에 설치되고 구성되는 데이터 공급자를 사용합니다.The report server uses the data providers that are installed and configured on the report server. 미리 보기 모드의 보고서 제작 클라이언트는 클라이언트 컴퓨터에 설치되고 구성된 데이터 처리 확장 프로그램을 사용합니다.Report authoring clients in Preview mode use the installed and configured data processing extensions on the client machine. 보고서를 보고서 클라이언트 환경과 보고서 서버 환경 모두에서 테스트해야 합니다.You must test your report in both the report client and the report server environment.

  • 보고서 처리기 데이터 형식은 Reporting ServicesReporting Services를 설치할 때 설치된 CLR 버전을 기반으로 합니다.Report processor The data types are based on the version of the CLR installed when you installed Reporting ServicesReporting Services.

    예를 들어 SQL Server 2008SQL Server 2008 에서 새로 도입된 새 날짜 및 시간 유형에 대해 보고서 처리기가 사용하는 데이터 형식이 다음 표에 표시됩니다.For example, the data types the report processor uses for the new date and time types introduced in SQL Server 2008SQL Server 2008 are shown in the following table:

    SQL 데이터 형식SQL Data Type CLR 데이터 형식CLR Data Type DescriptionDescription
    DateDate DateTimeDateTime 날짜만Date only
    TimeTime TimeSpanTimeSpan 시간입니다.Time only
    DateTimeTZDateTimeTZ DateTimeOffsetDateTimeOffset 표준 시간대 오프셋을 포함하는 날짜 및 시간Date and time with time zone offset
    DateTime2DateTime2 DateTimeDateTime 소수 자릿수 밀리초를 포함하는 날짜 및 시간Date and time with fractional milliseconds

    SQL ServerSQL Server 데이터베이스 형식에 대한 자세한 내용은 데이터 형식(데이터베이스 엔진)날짜 및 시간 데이터 형식 및 함수(Transact-SQL)를 참조하세요.For more information about SQL ServerSQL Server database types, see Data Types (Database Engine) and Date and Time Data Types and Functions (Transact-SQL).

    식에서 데이터 집합 필드에 대한 참조를 포함하는 방법은 식의 데이터 형식(보고서 작성기 및 SSRS)을 참조하세요.For more information about including references to a dataset field from an expression, see Data Types in Expressions (Report Builder and SSRS).

런타임에 누락된 필드 검색Detecting Missing Fields at Run Time

보고서가 처리될 때 해당 열이 더 이상 데이터 원본에 존재하지 않아 데이터 집합에 대한 결과 집합에서 지정된 일부 열에 대한 값이 누락될 수 있습니다.When the report is processed, the result set for a dataset may not contain values for all of the columns specified because the columns no longer exist on the data source. 필드 속성 IsMissing을 사용하여 필드에 대한 값이 런타임에 반환되었는지를 검색할 수 있습니다.You can use the field property IsMissing to detect whether values for a field were returned at run-time. 자세한 내용은 데이터 집합 필드 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Dataset Fields Collection References (Report Builder and SSRS).

관련 항목:See Also

데이터 집합 속성 대화 상자, 필드(보고서 작성기) Dataset Properties Dialog Box, Fields (Report Builder)
보고서 작성기의 보고서 파트 및 데이터 집합 Report Parts and Datasets in Report Builder
보고서 포함된 데이터 집합 및 공유 데이터 집합(보고서 작성기 및 SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)