Analysis Services 数据库的扩展字段属性 (SSRS)

项目
03/23/2023

SQL Server Analysis Services 数据处理扩展插件支持扩展字段属性。扩展字段属性是除字段属性 Value 和 IsMissing 之外的属性，可用于数据源并受数据处理扩展插件支持。扩展属性并不作为报表数据集的字段集合的一部分显示在“报表数据”窗格中。你可以通过编写使用内置 Fields 集合按名称指定扩展字段属性值的表达式，来将这些扩展字段属性值包含在报表中。

扩展属性包括预定义属性和自定义属性。预定义属性是多个数据源中通用的属性，它们映射到特定字段属性名称并可通过内置 Fields 集合按名称进行访问。自定义属性是特定于每个数据提供程序的属性，只能通过内置 Fields 集合，使用将扩展属性名称用作字符串的语法进行访问。

在图形模式下使用 Analysis Services MDX 查询设计器定义查询时，一组预定义的单元属性和维度属性会自动添加到 MDX 查询。您只能使用在您的报表的 MDX 查询中专门列出的扩展属性。根据您的报表，可能需要修改默认 MDX 命令文本才能包含多维数据集中定义的其他维度或自定义属性。有关 Analysis Services 数据源中的可用扩展字段的详细信息，请参阅创建和使用属性值 (MDX)。

在报表中使用字段属性

扩展字段属性包括预定义属性和数据访问接口特定属性。即使字段属性位于为数据集生成的查询中，它们也不会与字段列表一起显示在 “报表数据” 窗格中，因此，不能将字段属性拖至报表设计图面中。相反，您必须将字段拖至报表，然后将字段的 Value 属性更改为要使用的属性。例如，如果已设置多维数据集的单元格数据的格式，则可以通过表达式 =Fields!FieldName.FormattedValue，来使用 FormattedValue 字段属性。

若要引用未预定义的扩展属性，请在表达式中使用以下语法：

Fields!FieldName("PropertyName")

预定义的字段属性

在大多数情况下，预定义的字段属性应用于度量值、级别或维度。预定义的字段属性必须在 Analysis Services 数据源中存储相应的值。如果值不存在，或者（例如）对某个级别指定了仅适用于度量值的字段属性，则该属性将返回空值。

可以使用以下任一语法引用表达式中的预定义属性：

Fields!FieldName.PropertyName
Fields!FieldName("PropertyName")

下表提供了您可以使用的预定义字段属性的列表：

Property	Type	说明或所需的值
值	Object	指定字段的数据值。
IsMissing	布尔值	指示是否在结果数据集中找到了该字段。
UniqueName	字符串	返回级别的完全限定名称。例如，某位员工的 UniqueName 值可能为 [Employee].[Employee Department].[Department].&[Sales].&[North American Sales Manager].&[272]。
BackgroundColor	字符串	返回数据库中为该字段定义的背景颜色。
彩色	字符串	返回数据库中为该项定义的前景色。
FontFamily	字符串	返回数据库中为该项定义的字体的名称。
FontSize	字符串	返回数据库中为该项定义的字体的字号。
FontWeight	字符串	返回数据库中为该项定义的字体的粗细。
FontStyle	字符串	返回数据库中为该项定义的字体的样式。
TextDecoration	字符串	返回数据库中为该项定义的特殊文本格式设置。
FormattedValue	字符串	返回度量值或关键数字的格式值。例如， “销售额配额” 的 FormattedValue 属性将返回一种货币格式，如 $1,124,400.00。
Key	Object	返回级别的键。
LevelNumber	整数	针对父子层次结构返回级别号或维度编号。
ParentUniqueName	字符串	针对父子层次结构返回父级的完全限定名称。

注意

仅当数据源（如 Analysis Services 多维数据集）在运行报表并检索报表数据集的数据时，为这些扩展字段属性提供值，这些值才存在。然后，您可以使用下面介绍的语法从任意表达式引用这些字段属性值。但是，由于这些字段专用于此数据访问接口，因此，对这些值所做的更改不会随报表定义一同保存。

扩展属性示例

为了说明扩展属性，以下 MDX 查询和结果集包含了为多维数据集定义的某维度属性的多个可用成员属性。包含的成员属性为 MEMBER_CAPTION、UNIQUENAME、Properties("Day Name")、MEMBER_VALUE、PARENT_UNIQUE_NAME 和 MEMBER_KEY。

此 MDX 查询针对 AdventureWorks2022 DW 数据库中的 AdventureWorks2022 多维数据集运行，它包含在 AdventureWorks2022 示例数据库中。

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 行的结果集。下表显示了其中的前四行。

DateCaption	DateUniqueName	DateDayName	DateValueinOriginalDatatype	DateParentUniqueName	DateMemberKeyinOriginalDatatype
All Periods	[Date].[Date].[All Periods]	(null)	(null)	(null)	0
1-Jul-01	[Date].[Date].&[1]	星期日	7/1/2001	[Date].[Date].[All Periods]	1
2-Jul-01	[Date].[Date].&[2]	星期一	7/2/2001	[Date].[Date].[All Periods]	2
3-Jul-01	[Date].[Date].&[3]	星期二	7/3/2001	[Date].[Date].[All Periods]	3

对于使用图形模式下的默认 MDX 查询设计器生成的 MDX 查询，其维度属性只包括 MEMBER_CAPTION 和 UNIQUENAME。默认情况下，这些值始终为 String数据类型。

如果需要成员属性采用其原始数据类型，则可通过在基于文本的查询设计器中修改默认 MDX 语句，来包含附加属性 MEMBER_VALUE。在下面的简单 MDX 语句中，MEMBER_VALUE 已添加到要检索的维度属性列表中。

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“结果”窗格中的前四行结果。

Month of Year	订单计数
1 月	2,481
February	2,684
March	2,749
April	2,739

即使属性是 MDX 选择语句的一部分，它们也不会显示在结果集列中。尽管如此，使用扩展属性功能仍可将这些数据用于报表。如果在多维数据集中设置了单元格属性值，可以在 SQL Server Management Studio 的 MDX 查询“结果”窗格中双击单元格，并查看单元格属性值。如果双击第一个包含 1,379 的 Order Count 单元，则会看到一个包含以下单元属性的弹出窗口：

属性	值
CellOrdinal	0
值	2481
BACK_COLOR	(null)
FORE_COLOR	(null)
FORMATTED_VALUE	2,481
FORMAT_STRING	#、#
FONT_NAME	(null)
FONT_SIZE	(null)
FONT_FLAGS	(null)

如果使用此查询创建报表数据集，并将该数据集绑定到一个表，则可以看到字段的默认 VALUE 属性，例如 =Fields!Month_of_Year!Value。如果将此表达式设置为该表的排序表达式，则会按月份的字母顺序对表进行排序，因为“值”字段使用 String 数据类型。若要按月份在一年中的顺序（即一月排在第一位，十二月排在最后）对该表进行排序，请使用以下表达式：

=Fields!Month_of_Year("MEMBER_VALUE")

这将使用数据源中字段的原始整数数据类型对其值进行排序。

另请参阅

表达式（报表生成器和 SSRS）
表达式中的内置集合（报表生成器和 SSRS）
数据集字段集合（报表生成器和 SSRS）

通过

Analysis Services 数据库的扩展字段属性 (SSRS)

在报表中使用字段属性

预定义的字段属性

扩展属性示例

另请参阅

反馈

其他资源