通过

  • 项目

使用单元属性 (MDX)

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

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

CELL PROPERTIES 关键字的语法

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

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 属性的背景色。有关详细信息，请参阅 FORE_COLOR 和 BACK_COLOR 内容 (MDX)。

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 属性的前景色。有关详细信息，请参阅 FORE_COLOR 和 BACK_COLOR 内容 (MDX)。

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) 不能更新单元，因为不能更新非和度量值（计数、最小值、最大值、非重复计数、半累加性）。

  • 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 架构行集中进行定义，包括它们的数据类型和提供程序支持。有关 PROPERTIES 架构行集的详细信息，请参阅 MDSCHEMA_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 Analysis Services 中的不同地方进行设置。例如，可在 BI Development Studio 中的多维数据集编辑器的“多维数据集结构”选项卡上为常规度量值设置“格式字符串”属性；可在多维数据集编辑器的“计算”选项卡上为对多维数据集定义的计算度量值设置相同的属性；在查询的 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 查询基础知识 (MDX)