使用单元属性 (MDX)

多维表达式 (MDX) 中的单元属性包含有关多维数据源(如多维数据集)中的单元的内容和格式的信息。

MDX 支持使用 MDX SELECT 语句中的 CELL PROPERTIES 关键字来检索内部单元属性。 内部单元属性通常用于协助单元数据的直观显示。

CELL PROPERTIES 关键字的语法

MDX CELL PROPERTIES 语句中的 SELECT 关键字使用下列语法:

SELECT [<axis_specification>  
       [, <axis_specification>...]]  
  FROM [<cube_specification>]  
[WHERE [<slicer_specification>]]  
[<cell_props>]  

下列语法显示了 <cell_props> 值的格式,以及此值如何将 CELL PROPERTIES 关键字与一个或多个内部单元属性一起使用:

<cell_props> ::= CELL PROPERTIES <property> [, <property>...]  

支持的内部单元属性

下表列出了 <property> 值中使用的、支持的内部单元属性。

属性 说明
ACTION_TYPE 指示单元中存在何种操作的位掩码。 此属性可以具有下列值之一:

MDACTION_TYPE_URL

MDACTION_TYPE_HTML

MDACTION_TYPE_STATEMENT

MDACTION_TYPE_DATASET

MDACTION_TYPE_ROWSET

MDACTION_TYPE_COMMANDLINE

MDACTION_TYPE_PROPRIETARY

MDACTION_TYPE_REPORT

MDACTION_TYPE_DRILLTHROUGH



注意:对于在 where 子句中包含集的查询来说,不包含钻取操作。
BACK_COLOR 用于显示 VALUEFORMATTED_VALUE 属性的背景色。 有关详细信息,请参阅 MDX) (FORE_COLOR 和 BACK_COLOR 内容
CELL_ORDINAL 数据集中单元的序号。
FONT_FLAGS 字体的位掩码细节效果。 例如,值 5 表示粗体 (MDFF_BOLD) 和下划线 (MDFF_UNDERLINE) 字体效果的组合。 该值是对以下一个或多个常量执行按位 OR 操作的结果:

MDFF_BOLD = 1

MDFF_ITALIC = 2

MDFF_UNDERLINE = 4

MDFF_STRIKEOUT = 8
FONT_NAME 用来显示 VALUEFORMATTED_VALUE 属性的字体。
FONT_SIZE 用来显示 VALUEFORMATTED_VALUE 属性的字体大小。
FORE_COLOR 用来显示 VALUEFORMATTED_VALUE 属性的前景色。 有关详细信息,请参阅 MDX) (FORE_COLOR 和 BACK_COLOR 内容
FORMAT FORMAT_STRING 相同。
FORMAT_STRING 用来创建 FORMATTED_VALUE 属性值的格式字符串。 有关详细信息,请参阅 FORMAT_STRING 内容 (MDX)
FORMATTED_VALUE 表示 VALUE 属性的格式化显示的字符串。
LANGUAGE 应用 FORMAT_STRING 的区域设置。 LANGUAGE 通常用于进行货币转换。
UPDATEABLE 指示单元是否可更新的值。 此属性可以具有下列值之一:

MD_MASK_ENABLED (0x00000000) 可以更新单元格。

MD_MASK_NOT_ENABLED (0x10000000) 无法更新单元格。

CELL_UPDATE_ENABLED (0x00000001) 单元格可以在单元格集中更新。

CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) 可以使用 update 语句更新单元格。 如果更新的叶单元未启用写操作,更新可能会失败。

CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) 无法更新单元格,因为单元格的坐标中有一个计算成员;使用 where 子句中的集检索单元格。 即使公式影响单元值或单元值上存在计算单元(在沿聚合路径的某个位置),仍可以更新单元。 在这种情况下,单元的最终值可能不是更新后的值,因为计算将影响结果。

CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) 无法更新单元格,因为无法更新非求和度量值 (count、min、max、distinct count、半累加) 。

CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) 无法更新单元格,因为该单元格不存在,因为它位于与度量值的度量值组无关的维度成员的交集处。

CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) 由于单元格已受到保护,因此无法更新单元格。

CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) 保留以供将来使用。

CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007) 由于内部原因,无法更新单元格。

CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) 无法更新单元格,因为挖掘模型、间接或数据挖掘维度不支持更新。
VALUE 单元的未格式化值。

只有 CELL_ORDINALFORMATTED_VALUEVALUE 单元属性是必需的。 所有的单元属性(内部单元属性或特定于提供程序的单元属性)都在 PROPERTIES 架构行集中进行定义,包括它们的数据类型和提供程序支持。 有关架构行集的详细信息 PROPERTIES ,请参阅 MDSCHEMA_PROPERTIES行集

默认情况下,如果未使用 CELL PROPERTIES 关键字,返回的单元属性为 VALUEFORMATTED_VALUECELL_ORDINAL(按这里显示的顺序)。 如果使用了 CELL PROPERTIES 关键字,将只返回用该关键字显式声明的那些单元属性。

下面的示例显示了 CELL PROPERTIES 关键字在 MDX 查询中的使用:

SELECT  
   {[Measures].[Reseller Gross Profit]} ON COLUMNS,  
   {[Reseller].[Reseller Type].[Reseller Name].Members} ON ROWS  
FROM [Adventure Works]  
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORMAT_STRING, FORE_COLOR, BACK_COLOR  

对于返回简化格式的行集的 MDX 查询,不返回单元属性;这种情况下,每个单元表现为似乎只返回了 FORMATTED_VALUE 单元属性。

设置单元属性

可以在 Microsoft SQL Server Analysis Services中的不同位置设置单元格属性。 例如,可以在 SQL Server Data Tools (SSDT) 的多维数据集编辑器的“多维数据集结构”选项卡上为常规度量值设置“格式字符串”属性;可以为多维数据集编辑器的“计算”选项卡上的多维数据集上定义的计算度量值设置相同的属性;在查询的 WITH 子句中定义的计算度量值也定义了其格式字符串。以下查询演示了如何在计算度量值上设置单元格属性:

WITH MEMBER MEASURES.CELLPROPERTYDEMO AS [Measures].[Internet Sales Amount]  
, FORE_COLOR=RGB(0,0,255)  
, BACK_COLOR=IIF([Measures].[Internet Sales Amount]>7000000, RGB(255,0,0), RGB(0,255,0))  
, FONT_SIZE=10  
, FORMAT_STRING='#,#.000'  
SELECT MEASURES.CELLPROPERTYDEMO ON 0,  
[Date].[Calendar Year].[Calendar Year].MEMBERS ON 1  
FROM [Adventure Works]  
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORE_COLOR, BACK_COLOR, FONT_SIZE  

另请参阅

MDX 查询基础知识 (Analysis Services)