MDX 成员属性 - 内部成员属性

项目
12/23/2023

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

SQL Server Analysis Services公开维度成员的内部属性，可以包含在查询中，以返回其他数据或元数据以用于自定义应用程序，或协助模型调查或构造。如果您正在使用 SQL Server 客户端工具，可以在 SQL Server Management Studio (SSMS) 中查看内部属性。

内部属性包括 ID、 KEY、 KEYx和 NAME，这些是每个成员在任意级别公开的属性。还可以返回位置信息，如 LEVEL_NUMBER 或 PARENT_UNIQUE_NAME等等。

根据您构造查询的方式和用于执行查询的客户端应用程序，成员属性在结果集中可能是可见的，也可能是不可见的。如果您正在使用 SQL Server Management Studio 测试或运行查询，可以双击结果集中的某个成员以打开“成员属性”对话框，显示每个内部成员属性的值。

有关如何使用和查看维度成员属性的说明，请参阅在 SSMS 的“MDX 查询”窗口中查看 SSAS 成员属性。

注意

作为符合 1999 年 3 月 (2.6) OLE DB 规范的 OLAP 部分的提供程序，Microsoft SQL Server SQL Server Analysis Services 支持本主题中列出的内部成员属性。

SQL Server 以外的提供程序SQL Server Analysis Services 可能支持其他内部成员属性。有关其他访问接口支持的内部成员属性的详细信息，请参阅这些访问接口附带的文档。

成员属性的类型

SQL Server SQL Server Analysis Services支持的内部成员属性有两种类型：

上下文相关的成员属性
这些成员属性必须在特定层次结构或级别的上下文中使用，用于为指定维度或级别的每个成员提供值。

请注意以下示例如何包括 KEY 属性的路径： MEMBER [Measures].[Parent Member Key] AS [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY")。

非上下文相关的成员属性
这些成员属性不能在特定维度或级别的上下文中使用，而是为某个轴上的所有成员返回值。

与上下文不相关的属性是独立的，不包括路径信息：请注意，在以下示例中，没有为 PARENT_UNIQUE_NAME 指定维度或级别： DIMENSION PROPERTIES PARENT_UNIQUE_NAME ON COLUMNS

不论内部成员属性是否是上下文相关的，都应遵循下列使用规则：

只能指定与投影在轴上的维度成员相关的那些内部成员属性。
可以在同一查询中同时包含对上下文相关成员属性和非上下文相关内部成员属性的请求。
使用 PROPERTIES 关键字查询属性。

以下部分介绍 SQL Server SQL Server Analysis Services 中可用的各种上下文相关和非上下文相关内部成员属性，以及如何对每种类型的属性使用 PROPERTIES 关键字 (keyword) 。

上下文相关的成员属性

所有维度成员和级别成员都支持一列上下文相关的内部成员属性。下表列出了这些上下文相关的属性。

属性	说明
ID	在内部维护的成员 ID。
键	以原始数据类型表示的成员键的值。 MEMBER_KEY 用于向后兼容。对于非组合键，MEMBER_KEY 具有与 KEY0 相同的值；对于组合键，MEMBER_KEY 属性为 null。
KEYx	成员键，其中 x 是成员键的序号，起始值为零。 KEY0 适用于组合键和非组合键，但是主要用于组合键。对于组合键，KEY0、KEY1、KEY2 等共同构成了组合键。您可以在查询中独立使用它们以返回组合键的该部分。例如，指定 KEY0 返回组合键的第一部分，指定 KEY1 返回组合键的下一部分等等。如果键不是组合键，则 KEY0 与 Key等效。请注意， KEYx 可以在上下文中使用，也可以不带上下文使用。因此，它显示在两个列表中。有关如何使用此成员属性的示例，请参阅简单的 MDX 小组件：Key0、Key1、Key2。
名称	成员名。

上下文相关属性的 PROPERTIES 语法

在特定维度或级别的上下文中使用这些成员属性，用于为指定维度或级别的每个成员提供值。

对于维度成员属性，在属性名称的前面加上属性适用的维度的名称。下面的示例列出了正确的语法：

DIMENSION PROPERTIES Dimension.Property_name

对于级别成员属性，可以在属性名称的前面仅加上级别名称；或者，为了更加明确具体，也可以将维度名称和级别名称都加上。下面的示例列出了正确的语法：

DIMENSION PROPERTIES [Dimension.]Level.Property_name

为了说明这一点，假设您希望返回 [Sales] 维度中引用的每个成员的所有名称。若要返回这些名称，需要在多维表达式 (MDX) 查询中使用以下语句：

DIMENSION PROPERTIES [Sales].Name

非上下文相关的成员属性

所有成员都支持一列内部成员属性，这些属性不因上下文而改变。这些属性提供了一些附加信息，可供应用程序用来改善用户的体验。

下表列出了 SQL Server SQL Server Analysis Services 支持的非上下文相关内部属性。

注意

MEMBERS 架构行集中的列支持下表中列出的内部成员属性。有关 MEMBERS 架构行集的详细信息，请参阅MDSCHEMA_MEMBERS行集。

属性	说明
CATALOG_NAME	此成员所属的多维数据集的名称。
CHILDREN_CARDINALITY	成员具有的子级的个数。它可以是一个估计值，所以不应依赖它进行确切计数。访问接口应尽可能返回最精确的估计值。
CUSTOM_ROLLUP	自定义成员表达式。
CUSTOM_ROLLUP_PROPERTIES	自定义成员属性。
说明	用户可以阅读的成员说明。
DIMENSION_UNIQUE_NAME	此成员所属的维度的唯一名称。对于通过限定生成唯一名称的访问接口，此名称的各组成部分之间用分隔符分隔。
HIERARCHY_UNIQUE_NAME	层次结构的唯一名称。如果成员属于多个层次结构，则成员所属的每个层次结构都有对应的一行。对于通过限定生成唯一名称的访问接口，此名称的各组成部分之间用分隔符分隔。
IS_DATAMEMBER	一个指示成员是否为数据成员的布尔值。
IS_PLACEHOLDERMEMBER	用来指明成员是否为占位符的布尔值。
KEYx	成员键，其中 x 是成员键的序号，起始值为零。 KEY0 可用于组合键和非组合键。如果键不是组合键，则 KEY0 与 Key等效。对于组合键，KEY0、KEY1、KEY2 等共同构成了组合键。您可以在查询中独立引用它们以返回组合键的该部分。例如，指定 KEY0 返回组合键的第一部分，指定 KEY1 返回组合键的下一部分等等。请注意， KEYx 可以在上下文中使用，也可以不带上下文使用。因此，它显示在两个列表中。有关如何使用此成员属性的示例，请参阅简单的 MDX 小组件：Key0、Key1、Key2。
LCID x	区域设置 ID 十六进制值中的成员标题的翻译，其中 x 是区域设置 ID 十进制值（例如，LCID1009 表示加拿大英语）。这仅适用于翻译具有绑定到数据源的标题列的情况。
LEVEL_NUMBER	成员距层次结构的根的距离。根级别为零。
LEVEL_UNIQUE_NAME	成员所属的级别的唯一名称。对于通过限定生成唯一名称的访问接口，此名称的各组成部分之间用分隔符分隔。
MEMBER_CAPTION	与成员相关的标签或标题。标题主要用于显示目的。如果不存在标题，查询将返回 MEMBER_NAME。
MEMBER_KEY	以原始数据类型表示的成员键的值。 MEMBER_KEY 用于向后兼容。对于非组合键，MEMBER_KEY 具有与 KEY0 相同的值；对于组合键，MEMBER_KEY 属性为 null。
MEMBER_NAME	成员名。
MEMBER_TYPE	成员的类型。此属性可以具有下列值之一： MDMEMBER_TYPE_REGULAR MDMEMBER_TYPE_ALL MDMEMBER_TYPE_FORMULA MDMEMBER_TYPE_MEASURE MDMEMBER_TYPE_UNKNOWN 注意：MDMEMBER_TYPE_FORMULA 优先于 MDMEMBER_TYPE_MEASURE。因此，如果 Measures 维度上有一个公式（计算）成员，则计算成员的 MEMBER_TYPE 属性为 MDMEMBER_TYPE_FORMULA。
MEMBER_UNIQUE_NAME	成员的唯一名称。对于通过限定生成唯一名称的访问接口，此名称的各组成部分之间用分隔符分隔。
MEMBER_VALUE	以原始类型表示的成员的值。
PARENT_COUNT	此成员具有的父级的个数。
PARENT_LEVEL	成员的父级距层次结构的根级别的距离。根级别为零。
PARENT_UNIQUE_NAME	成员的父成员的唯一名称。对于根级别上的任何成员，均返回NULL 。对于通过限定生成唯一名称的访问接口，此名称的各组成部分之间用分隔符分隔。
SKIPPED_LEVELS	跳过的成员级别数。
UNARY_OPERATOR	成员的一元运算符。
UNIQUE_NAME	成员的完全限定名称，它采用以下格式：[dimension].[level].[key6.]

非上下文相关属性的 PROPERTIES 语法

使用以下语法指定使用 PROPERTIES 关键字的非上下文相关的内部成员属性：

DIMENSION PROPERTIES Property

请注意，此语法不允许使用维度或级别来限定属性。因为非上下文相关的内部成员属性适用于某条轴上的所有成员，所以不能限定属性。

例如，指定 DESCRIPTION 内部成员属性的 MDX 语句具有以下语法：

DIMENSION PROPERTIES DESCRIPTION

此语句返回轴维度中各个成员的说明。如果尝试使用维度或级别限定属性（如 Dimension.DESCRIPTION 或 Level.DESCRIPTION 中所示），则语句不会进行验证。

示例

以下示例显示返回内部属性的 MDX 查询。

示例 1：在查询中使用上下文相关的内部属性

以下示例返回每个产品类别的父 ID、键和名称。请注意属性如何公开为度量值。这允许您在运行查询时在单元集中查看属性，而非在 SSMS 的“成员属性”对话框中查看。您可能运行类似的查询以从部署的多维数据集检索成员元数据。

WITH  
MEMBER [Measures].[Parent Member ID] AS  
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("ID")  
MEMBER [Measures].[Parent Member Key] AS  
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY")  
MEMBER [Measures].[Parent Member Name] AS  
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("Name")  
SELECT  
 {[Measures].[Parent Member ID], [Measures].[Parent Member Key], [Measures].[Parent Member Name] } on COLUMNS,   
 [Product].[Product Categories].AllMembers on ROWS  
FROM [Adventure Works]

示例 2：非上下文相关的内部属性

以下示例是非上下文相关的内部属性的完整列表。在 SSMS 中运行查询后，单击各个成员可以在“成员属性”对话框中查看属性。

SELECT [Measures].[Sales Amount Quota] on COLUMNS,  
[Employee].[Employees].members  
DIMENSION PROPERTIES  
 CATALOG_NAME ,   
 CHILDREN_CARDINALITY ,  
 CUSTOM_ROLLUP ,   
 CUSTOM_ROLLUP_PROPERTIES ,   
 DESCRIPTION ,   
 DIMENSION_UNIQUE_NAME ,   
 HIERARCHY_UNIQUE_NAME ,  
 IS_DATAMEMBER ,   
 IS_PLACEHOLDERMEMBER ,   
 KEY0 ,  
 LCID ,  
 LEVEL_NUMBER ,  
 LEVEL_UNIQUE_NAME ,  
 MEMBER_CAPTION ,   
 MEMBER_KEY ,   
 MEMBER_NAME ,   
 MEMBER_TYPE ,  
 MEMBER_UNIQUE_NAME ,   
 MEMBER_VALUE ,   
 PARENT_COUNT ,   
 PARENT_LEVEL ,   
 PARENT_UNIQUE_NAME ,  
 SKIPPED_LEVELS ,   
 UNARY_OPERATOR ,   
 UNIQUE_NAME    
 ON ROWS  
FROM [Adventure Works]  
WHERE [Employee].[Employee Department].[Department].&[Sales]

示例 3：将成员属性作为结果集中的数据返回

下面的示例为指定区域设置的 Adventure Works 多维数据集中 Product 维度的产品类别成员返回翻译后的标题。

WITH   
MEMBER Measures.CategoryCaption AS Product.Category.CurrentMember.MEMBER_CAPTION  
MEMBER Measures.SpanishCategoryCaption AS Product.Category.CurrentMember.Properties("LCID3082")  
MEMBER Measures.FrenchCategoryCaption AS Product.Category.CurrentMember.Properties("LCID1036")  
SELECT   
{ Measures.CategoryCaption, Measures.SpanishCategoryCaption, Measures.FrenchCategoryCaption } ON 0  
,[Product].[Category].MEMBERS ON 1  
FROM [Adventure Works]

另请参阅

PeriodsToDate (MDX)
Children (MDX)
Hierarchize (MDX)
Count（集）(MDX)
Filter (MDX)
AddCalculatedMembers (MDX)
DrilldownLevel (MDX)
Properties (MDX)
PrevMember (MDX)
使用成员属性 (MDX)
MDX 函数参考 (MDX)

通过