MDX 单元格属性 - 使用单元格属性

适用于： SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

多维表达式 (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	用于显示 VALUE 或 FORMATTED_VALUE 属性的背景色。 有关详细信息，请参阅 MDX) (FORE_COLOR 和 BACK_COLOR 内容 。
CELL_ORDINAL	数据集中单元的序号。
FONT_FLAGS	字体的位掩码细节效果。 该值是对以下一个或多个常量执行按位 OR 操作的结果： MDFF_BOLD = 1 MDFF_ITALIC = 2 MDFF_UNDERLINE = 4 MDFF_STRIKEOUT = 8 例如，值 5 表示粗体 (MDFF_BOLD) 和下划线 (MDFF_UNDERLINE) 字体效果的组合。
FONT_NAME	要用于显示 VALUE 或 FORMATTED_VALUE 属性的字体。
FONT_SIZE	要用于显示 VALUE 或 FORMATTED_VALUE 属性的字体大小。
FORE_COLOR	用于显示 VALUE 或 FORMATTED_VALUE 属性的前景色。 有关详细信息，请参阅 MDX) (FORE_COLOR 和 BACK_COLOR 内容 。
FORMAT	与 FORMAT_STRING相同。
FORMAT_STRING	用来创建 FORMATTED_VALUE 属性值的格式字符串。 有关详细信息，请参阅 mdX) (FORMAT_STRING内容 。
FORMATTED_VALUE	表示 VALUE 属性的格式化显示的字符串。
LANGUAGE	应用 FORMAT_STRING 的区域设置。 LANGUAGE 通常用于进行货币转换。
更新	指示单元是否可更新的值。 此属性可以具有下列值之一：
	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) 无法更新单元格，因为无法更新非总和度量值 (计数、最小值、最大值、非重复计数、半累加) 。
	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_ORDINAL、 FORMATTED_VALUE和 VALUE 单元属性是必需的。 所有的单元属性（内部单元属性或特定于提供程序的单元属性）都在 PROPERTIES 架构行集中进行定义，包括它们的数据类型和提供程序支持。

默认情况下，如果未使用 CELL PROPERTIES 关键字，返回的单元属性为 VALUE、 FORMATTED_VALUE和 CELL_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 SQL Server Analysis Services中的不同位置设置单元格属性。 例如，可以在 SQL Server Data Tools 中的多维数据集编辑器的“多维数据集结构”选项卡上为常规度量值设置格式字符串属性;对于在多维数据集编辑器的“计算”选项卡上的多维数据集上定义的计算度量值，可以设置相同的属性;在查询的 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)