Analysis Services 데이터베이스에 대한 확장 필드 속성(SSRS)Extended Field Properties for an Analysis Services Database (SSRS)

SQL ServerSQL Server Analysis ServicesAnalysis Services 데이터 처리 확장 프로그램은 확장 필드 속성을 지원합니다.The SQL ServerSQL Server Analysis ServicesAnalysis Services data processing extension supports extended field properties. 확장 필드 속성은 ValueIsMissing 외에 데이터 원본에서 사용할 수 있고 데이터 처리 확장 프로그램에서 지원되는 속성입니다.Extended field properties are properties in addition to the field properties Value and IsMissing that are available on the data source and supported by the data processing extension. 확장 속성은 보고서 데이터 집합에 대한 필드 컬렉션의 일부로 보고서 데이터 창에 나타나지 않습니다.Extended properties do not appear in the Report Data pane as part of the field collection for a report dataset. 기본 제공 Fields 컬렉션을 사용하여 이름으로 확장 필드 속성 값을 지정하는 식을 작성하면 보고서에 확장 필드 속성 값을 포함할 수 있습니다.You can include extended field property values in your report by writing expressions that specify them by name using the built-in Fields collection.

확장 속성에는 미리 정의된 속성과 사용자 지정 속성이 포함됩니다.Extended properties include predefined properties and custom properties. 미리 정의된 속성은 여러 데이터 원본에 공통되는 속성으로, 특정 필드 속성 이름에 매핑되고 기본 제공 Fields 컬렉션을 통해 이름으로 액세스될 수 있습니다.Predefined properties are properties common to multiple data sources that are mapped to specific field property names and can be accessed through the built-in Fields collection by name. 사용자 지정 속성은 각 데이터 공급자별로 정의되며 확장 속성 이름을 문자열로 사용하는 구문에 의해서만 기본 제공 Fields 컬렉션을 통해 액세스될 수 있습니다.Custom properties are specific to each data provider and can be accessed through the built-in Fields collection only through syntax using the extended property name as a string.

그래픽 모드에서 Analysis ServicesAnalysis Services MDX 쿼리 디자이너를 사용하여 쿼리를 정의하면 미리 정의된 셀 속성 및 차원 속성 집합이 자동으로 MDX 쿼리에 추가됩니다.When you use the Analysis ServicesAnalysis Services MDX query designer in graphical mode to define your query, a predefined set of cell properties and dimension properties are automatically added to the MDX query. 보고서의 MDX 쿼리에 구체적으로 나열된 확장 속성만 사용할 수 있습니다.You can only use extended properties that are specifically listed in the MDX query in your report. 보고서에 따라 기본 MDX 명령 텍스트를 수정하여 큐브에 정의된 다른 차원 속성이나 사용자 지정 속성을 포함할 수도 있습니다.Depending on your report, you may want to modify the default MDX command text to include other dimension or custom properties defined in the cube. Analysis ServicesAnalysis Services 데이터 원본에서 사용할 수 있는 확장 필드에 대한 자세한 내용은 속성 값 만들기 및 사용(MDX)을 참조하세요.For more information about extended fields available in Analysis ServicesAnalysis Services data sources, see Creating and Using Property Values (MDX).

보고서에서 필드 속성 사용Working with Field Properties in a Report

확장 필드 속성에는 미리 정의된 속성과 데이터 공급자 관련 속성이 포함됩니다.Extended field properties include predefined properties and data provider-specific properties. 필드 속성은 데이터 집합에 대해 작성된 쿼리에 포함되어 있어도 보고서 데이터 창의 필드 목록에 나타나지 않습니다. 따라서 필드 속성을 보고서 디자인 화면으로 끌 수 없습니다.Field properties do not appear with the field list in the Report Data pane, even though they are in the query built for a dataset; therefore, you cannot drag field properties onto your report design surface. 대신 필드를 보고서로 끈 다음 필드의 Value 속성을 사용하려는 속성으로 변경해야 합니다.Instead, you must drag the field onto the report and then change the Value property of the field to the property that you want to use. 예를 들어 큐브의 셀 데이터 형식이 이미 지정되어 있는 경우 =Fields!FieldName.FormattedValue식을 통해 FormattedValue 필드 속성을 사용할 수 있습니다.For example, if the cell data from a cube has already been formatted, you can use the FormattedValue field property by using the following expression: =Fields!FieldName.FormattedValue.

미리 정의되지 않은 확장 속성을 참조하려면 식에 다음 구문을 사용하십시오.To refer to an extended property that is not predefined, use the following syntax in an expression:

  • Fields!FieldName("PropertyName")Fields!FieldName("PropertyName")

미리 정의된 필드 속성Predefined Field Properties

대부분의 경우 미리 정의된 필드 속성은 측정값, 수준 또는 차원에 적용됩니다.In most cases, predefined field properties apply to measures, levels, or dimensions. 미리 정의된 필드 속성의 해당 값은 Analysis ServicesAnalysis Services 데이터 원본에 저장되어 있어야 합니다.A predefined field property must have a corresponding value stored in the Analysis ServicesAnalysis Services data source. 예를 들어 값이 없거나 수준에서 측정값 전용 필드 속성을 지정한 경우에는 Null 값이 반환됩니다.If a value does not exist, or if you specify a measure-only field property on a level (for example), the property returns a null value.

다음 구문 중 하나를 사용하여 식에서 미리 정의된 속성을 참조할 수 있습니다.You can use either of the following syntaxes to refer to a predefined property from an expression:

  • Fields!FieldName.PropertyNameFields!FieldName.PropertyName

  • Fields!FieldName("PropertyName")Fields!FieldName("PropertyName")

    다음 표에서는 사용할 수 있는 미리 정의된 필드 속성 목록을 보여 줍니다.The following table provides a list of predefined field properties that you can use.

속성Property 형식Type 설명 또는 필요한 값Description or expected value
ValueValue 개체Object 필드의 데이터 값을 지정합니다.Specifies the data value of the field.
IsMissingIsMissing BooleanBoolean 필드가 결과 데이터 집합에 있는지 여부를 나타냅니다.Indicates whether the field was found in the resulting data set.
UniqueNameUniqueName 문자열String 수준의 정규화된 이름을 반환합니다.Returns the fully qualified name of a level. 예를 들어 직원의 UniqueName 값은 [Employee].[Employee Department].[Department].&[Sales].&[North American Sales Manager].&[272]일 수 있습니다.For example, the UniqueName value for an employee might be [Employee].[Employee Department].[Department].&[Sales].&[North American Sales Manager].&[272].
BackgroundColorBackgroundColor 문자열String 필드에 대해 데이터베이스에 정의된 배경색을 반환합니다.Returns the background color defined in the database for the field.
Color 문자열String 항목에 대해 데이터베이스에 정의된 전경색을 반환합니다.Returns the foreground color defined in the database for the item.
FontFamilyFontFamily 문자열String 항목에 대해 데이터베이스에 정의된 글꼴 이름을 반환합니다.Returns the name of the font defined in the database for the item.
FontSizeFontSize 문자열String 항목에 대해 데이터베이스에 정의된 글꼴 크기를 반환합니다.Returns the point size of the font defined in the database for the item.
FontWeightFontWeight 문자열String 항목에 대해 데이터베이스에 정의된 글꼴 두께를 반환합니다.Returns the weight of the font defined in the database for the item.
FontStyleFontStyle 문자열String 항목에 대해 데이터베이스에 정의된 글꼴 스타일을 반환합니다.Returns the style of the font defined in the database for the item.
TextDecorationTextDecoration 문자열String 항목에 대해 데이터베이스에 정의된 특수 텍스트 서식을 반환합니다.Returns special text formatting defined in the database for the item.
FormattedValueFormattedValue 문자열String 측정값 또는 주요 숫자 값의 형식화된 값을 반환합니다.Returns a formatted value for a measure or key figure. 예를 들어 Sales Amount Quota 에 대한 FormattedValue 속성은 $1,124,400.00과 같은 통화 형식을 반환합니다.For example, the FormattedValue property for Sales Amount Quota returns a currency format like $1,124,400.00.
KeyKey 개체Object 수준의 키를 반환합니다.Returns the key for a level.
LevelNumberLevelNumber 정수Integer 부모-자식 계층에 대해 수준 또는 차원 번호를 반환합니다.For parent-child hierarchies, returns the level or dimension number.
ParentUniqueNameParentUniqueName 문자열String 부모-자식 계층에 대해 부모 수준의 정규화된 이름을 반환합니다.For parent-child hierarchies, returns a fully qualified name of the parent level.

참고

이러한 확장 필드 속성의 값은 보고서가 실행되어 해당 데이터 집합에 대한 데이터가 검색될 때 데이터 원본(예: Analysis ServicesAnalysis Services 큐브)이 이러한 값을 제공하는 경우에만 존재합니다.Values exist for these extended field properties only if the data source (for example, the Analysis ServicesAnalysis Services cube) provides these values when your report runs and retrieves the data for its datasets. 이러한 값이 존재하는 경우 다음 섹션에 설명된 구문을 사용하여 모든 식에서 해당 필드 속성 값을 참조할 수 있습니다.You can then refer to those field property values from any expression using the syntax described in the following section. 그러나 이러한 필드는 이 데이터 공급자에만 해당되므로 이러한 값을 변경해도 보고서 정의와 함께 저장되지 않습니다.However, because these fields are specific to this data provider, changes that you make to these values are not saved with the report definition.

확장 속성 예Example Extended Properties

확장 속성을 설명하기 위해 다음 MDX 쿼리와 결과 집합에는 큐브에 대해 정의된 차원 특성에서 사용할 수 있는 몇 개의 멤버 속성이 포함되어 있습니다.To illustrate extended properties, the following MDX query and result set include several member properties available from a dimension attribute defined for a cube. 포함된 멤버 속성은 MEMBER_CAPTION, UNIQUENAME, Properties("Day Name"), MEMBER_VALUE, PARENT_UNIQUE_NAME 및 MEMBER_KEY입니다.The member properties included are MEMBER_CAPTION, UNIQUENAME, Properties("Day Name"), MEMBER_VALUE, PARENT_UNIQUE_NAME, and MEMBER_KEY.

이 MDX 쿼리는 AdventureWorks2012AdventureWorks2012 예제 데이터베이스에 포함된 AdventureWorks2012AdventureWorks2012 DW 데이터베이스의 AdventureWorks2012AdventureWorks2012 큐브에 대해 실행됩니다.This MDX query runs against the AdventureWorks2012AdventureWorks2012 cube in the AdventureWorks2012AdventureWorks2012 DW database, included with the AdventureWorks2012AdventureWorks2012 sample databases.

WITH MEMBER [Measures].[DateCaption]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_CAPTION'   
   MEMBER [Measures].[DateUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.UNIQUENAME'   
   MEMBER [Measures].[DateDayName]   
      AS '[Date].[Date].Properties("Day Name")'   
   MEMBER [Measures].[DateValueinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_VALUE'   
   MEMBER [Measures].[DateParentUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.PARENT_UNIQUE_NAME'   
   MEMBER [Measures].[DateMemberKeyinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_KEY'   
SELECT {  
   [Measures].[DateCaption],   
   [Measures].[DateUniqueName],   
   [Measures].[DateDayName],   
   [Measures].[DateValueinOriginalDatatype],  
   [Measures].[DateParentUniqueName],  
   [Measures].[DateMemberKeyinOriginalDatatype]  
   } ON COLUMNS , [Date].[Date].ALLMEMBERS ON ROWS   
FROM [Adventure Works]  

MDX 쿼리 창에서 이 쿼리를 실행하면 1158개 행이 포함된 결과 집합이 나타납니다.When you run this query in an MDX query pane, you get a result set with 1158 rows. 다음 표에서는 처음 4개 행을 보여 줍니다.The first four rows are shown in the following table.

DateCaptionDateCaption DateUniqueNameDateUniqueName DateDayNameDateDayName DateValueinOriginalDatatypeDateValueinOriginalDatatype DateParentUniqueNameDateParentUniqueName DateMemberKeyinOriginalDatatypeDateMemberKeyinOriginalDatatype
All PeriodsAll Periods [Date].[Date].[All Periods][Date].[Date].[All Periods] (null)(null) (null)(null) (null)(null) 00
1-Jul-011-Jul-01 [Date].[Date].&[1][Date].[Date].&[1] 일요일Sunday 7/1/20017/1/2001 [Date].[Date].[All Periods][Date].[Date].[All Periods] 1.1
2-Jul-012-Jul-01 [Date].[Date].&[2][Date].[Date].&[2] 월요일Monday 7/2/20017/2/2001 [Date].[Date].[All Periods][Date].[Date].[All Periods] 22
3-Jul-013-Jul-01 [Date].[Date].&[3][Date].[Date].&[3] 화요일Tuesday 7/3/20017/3/2001 [Date].[Date].[All Periods][Date].[Date].[All Periods] 33

그래픽 모드로 MDX 쿼리 디자이너를 사용하여 작성한 기본 MDX 쿼리는 차원 속성으로 MEMBER_CAPTION과 UNIQUENAME만 포함합니다.Default MDX queries built using the MDX Query Designer in graphical mode only include MEMBER_CAPTION and UNIQUENAME for dimension properties. 기본적으로 이러한 값은 항상 String데이터 형식입니다.By default, these values always are data type String.

원래 데이터 형식에 멤버 속성이 필요한 경우 텍스트 기반 쿼리 디자이너에서 기본 MDX 문을 수정하여 추가 속성 MEMBER_VALUE를 포함할 수 있습니다.If you need a member property in its original data type, you can include an additional property MEMBER_VALUE by modifying the default MDX statement in the text-based query designer. 간단한 다음 MDX 문에서 MEMBER_VALUE는 검색할 차원 속성 목록에 추가되었습니다.In the following simple MDX statement, MEMBER_VALUE has been added to the list of dimension properties to retrieve.

SELECT NON EMPTY {[Measures].[Order Count]} ON COLUMNS,   
NON EMPTY { ([Date].[Month of Year].[Month of Year] ) }   
DIMENSION PROPERTIES   
   MEMBER_CAPTION, MEMBER_UNIQUE_NAME, MEMBER_VALUE ON ROWS   
FROM [Adventure Works]  
CELL PROPERTIES   
   VALUE, BACK_COLOR, FORE_COLOR,   
   FORMATTED_VALUE, FORMAT_STRING,   
   FONT_NAME, FONT_SIZE, FONT_FLAGS  

다음 표에서는 MDX 결과 창에 나타나는 결과의 처음 4개 행을 보여 줍니다.The first four rows of the result in the MDX Results pane appear in the following table.

Month of YearMonth of Year Order CountOrder Count
JanuaryJanuary 2,4812,481
FebruaryFebruary 2,6842,684
MarchMarch 2,7492,749
AprilApril 2,7392,739

속성은 MDX SELECT 문의 일부이지만 결과 집합 열에 나타나지 않습니다.Even though the properties are part of the MDX select statement, they do not appear in the result set columns. 그러나 확장 속성 기능을 사용하여 이 데이터를 보고서에 사용할 수 있습니다.Nevertheless, the data is available for a report by using the extended properties feature. SQL ServerSQL Server Management StudioManagement Studio의 MDX 쿼리 결과 창에서 셀을 두 번 클릭하면 큐브에 설정된 경우 셀 속성 값을 볼 수 있습니다.In an MDX query result pane in SQL ServerSQL Server Management StudioManagement Studio, you can double-click on the cell and see the cell property values if they are set in the cube. 1,379가 포함된 첫 번째 Order Count 셀을 두 번 클릭하면 다음 셀 속성이 있는 팝업 창이 표시됩니다.If you double-click on the first Order Count cell that contains 1,379, you will see a pop-up window with the following cell properties:

속성Property ValueValue
CellOrdinalCellOrdinal 00
ValueVALUE 24812481
BACK_COLORBACK_COLOR (null)(null)
FORE_COLORFORE_COLOR (null)(null)
FORMATTED_VALUEFORMATTED_VALUE 2,4812,481
FORMAT_STRINGFORMAT_STRING #,##,#
FONT_NAMEFONT_NAME (null)(null)
FONT_SIZEFONT_SIZE (null)(null)
FONT_FLAGSFONT_FLAGS (null)(null)

이 쿼리를 사용하여 보고서 데이터 집합을 만들고 테이블에 바인딩하면 필드의 기본 VALUE 속성(예: =Fields!Month_of_Year!Value)을 볼 수 있습니다.If you create a report dataset with this query and bind the dataset to a table, you can see the default VALUE property for a field, for example, =Fields!Month_of_Year!Value. 이 식을 테이블에 대한 정렬 식으로 설정하면 Value 필드가 String 데이터 형식을 사용하므로 테이블이 월을 기준으로 사전순으로 정렬됩니다.If you set this expression as the sort expression for the table, your results will be to sort the table alphabetically by month because the Value field uses a String data type. 월이 연도에서 발생하는 순서대로, 즉 1월이 처음이고 12월이 마지막이 되도록 테이블을 정렬하려면 다음 식을 사용합니다.To sort the table in so that the months are in the order they occur in the year with January first and December last, use the following expression:

=Fields!Month_of_Year("MEMBER_VALUE")  

이렇게 하면 데이터 원본의 원래 정수 데이터 형식으로 필드 값이 정렬됩니다.This sorts the value of the field in its original integer data type from the data source.

관련 항목:See Also

식(보고서 작성기 및 SSRS) Expressions (Report Builder and SSRS)
식의 기본 제공 컬렉션(보고서 작성기 및 SSRS) Built-in Collections in Expressions (Report Builder and SSRS)
데이터 집합 필드 컬렉션(보고서 작성기 및 SSRS)Dataset Fields Collection (Report Builder and SSRS)