MDSCHEMA_HIERARCHIES 行集

介绍特定维度中的每个层次结构。

行集列

MDSCHEMA_HIERARCHIES 行集包含以下列。

列名

类型指示符

长度

说明

CATALOG_NAME

DBTYPE_WSTR

此层次结构所属的目录的名称。 如果提供程序不支持目录,则为 NULL。

SCHEMA_NAME

DBTYPE_WSTR

不支持

CUBE_NAME

DBTYPE_WSTR

(必需)此层次结构所属的多维数据集的名称。

DIMENSION_UNIQUE_NAME

DBTYPE_WSTR

此层次结构所属的维度的唯一名称。 对于通过限定生成唯一名称的访问接口,此名称的各组成部分之间用分隔符分隔。

HIERARCHY_NAME

DBTYPE_WSTR

层次结构的名称。 如果维度中仅有一个层次结构,则为空。 在 Microsoft SQL Server Analysis Services 中,此列将始终包含一个值。

HIERARCHY_UNIQUE_NAME

DBTYPE_WSTR

层次结构的唯一名称。

HIERARCHY_GUID

DBTYPE_GUID

不支持

HIERARCHY_CAPTION

DBTYPE_WSTR

与层次结构关联的标签或标题。 主要用于显示目的。 如果标题不存在,则返回 HIERARCHY_NAME。 如果维度不包含层次结构,或只有一个层次结构,则此列将包含相应维度的名称。

DIMENSION_TYPE

DBTYPE_I2

维度的类型。 有效值包括下列各值:

  • MD_DIMTYPE_UNKNOWN (0)

  • MD_DIMTYPE_TIME (1)

  • MD_DIMTYPE_MEASURE (2)

  • MD_DIMTYPE_OTHER (3)

  • MD_DIMTYPE_QUANTITATIVE (5)

  • MD_DIMTYPE_ACCOUNTS (6)

  • MD_DIMTYPE_CUSTOMERS (7)

  • MD_DIMTYPE_PRODUCTS (8)

  • MD_DIMTYPE_SCENARIO (9)

  • MD_DIMTYPE_UTILIY (10)

  • MD_DIMTYPE_CURRENCY (11)

  • MD_DIMTYPE_RATES (12)

  • MD_DIMTYPE_CHANNEL (13)

  • MD_DIMTYPE_PROMOTION (14)

  • MD_DIMTYPE_ORGANIZATION (15)

  • MD_DIMTYPE_BILL_OF_MATERIALS (16)

  • MD_DIMTYPE_GEOGRAPHY (17)

HIERARCHY_CARDINALITY

DBTYPE_UI4

层次结构中的成员数。

DEFAULT_MEMBER

DBTYPE_WSTR

此层次结构的默认成员。 这是唯一的名称。 每个层次结构必须有一个默认成员。

ALL_MEMBER

DBTYPE_WSTR

汇总中最高级别的成员。

DESCRIPTION

DBTYPE_WSTR

层次结构的可读说明。 如果不存在说明,则为 NULL。

STRUCTURE

DBTYPE_I2

层次结构的结构。 有效值包括下列各值:

  • MD_STRUCTURE_FULLYBALANCED (0)

  • MD_STRUCTURE_RAGGEDBALANCED (1)

  • MD_STRUCTURE_UNBALANCED (2)

  • MD_STRUCTURE_NETWORK (3)

IS_VIRTUAL

DBTYPE_BOOL

始终返回 False。

IS_READWRITE

DBTYPE_BOOL

一个布尔值,指示是否启用写回到维度列。

如果启用了表示此层次结构的 Write Back to dimension 列,则返回 TRUE。

DIMENSION_UNIQUE_SETTINGS

DBTYPE_I4

始终返回 MDDIMENSIONS_MEMBER_KEY_UNIQUE (1)。

DIMENSION_MASTER_UNIQUE_NAME

DBTYPE_WSTR

始终返回 NULL。

DIMENSION_IS_VISIBLE

DBTYPE_BOOL

始终返回 true。 如果相应维度不可见,则也不会在架构行集中显示该维度。

HIERARCHY_ORDINAL

DBTYPE_UI4

多维数据集的所有层次结构的层次结构序号。

DIMENSION_IS_SHARED

DBTYPE_BOOL

始终返回 TRUE。

HIERARCHY_IS_VISIBLE

DBTYPE_BOOL

指示层次结构是否可见的布尔值。

如果层次结构可见,则返回 TRUE,否则返回 FALSE。

HIERARCHY_ORIGIN

DBTYPE_UI2

确定层次结构源的位掩码:

  • MD_ORIGIN_USER_DEFINED 标识用户定义层次结构中的级别。

  • MD_ORIGIN_ATTRIBUTE 标识属性层次结构中的级别。

  • MD_ORIGIN_INTERNAL 标识未启用的属性层次结构中的级别。

  • MD_ORIGIN_KEY_ATTRIBUTE 标识键属性层次结构中的级别。

HIERARCHY_DISPLAY_FOLDER

DBTYPE_WSTR

在用户界面中显示层次结构时需使用的路径。 文件夹名称将由分号 (;) 分隔。 嵌套式文件夹用反斜杠 (\) 来表示。

INSTANCE_SELECTION

DBTYPE_UI2

向客户端应用程序提供的有关如何显示层次结构的提示。 有效值包括下列各值:

  • MD_INSTANCE_SELECTION_NONE

  • MD_INSTANCE_SELECTION_DROPDOWN

  • MD_INSTANCE_SELECTION_LIST

  • MD_INSTANCE_SELECTION_FILTEREDLIST

  • MD_INSTANCE_SELECTION_MANDATORYFILTER

GROUPING_BEHAVIOR

DBTYPE_I2

指定此层次结构的客户端的预期分组行为的枚举。 可能的值如下:

  • EncourageGrouping (1)

  • DiscourageGrouping (2)

STRUCTURE_TYPE

DBTYPE_WSTR

指示层次结构的类型。 有效值包括下列各值:

  • Natural

  • Unnatural

  • Unknown

行集按 CATALOG_NAME、SCHEMA_NAME、CUBE_NAME、DIMENSION_UNIQUE_NAME、HIERARCHY_NAME 排序。

限制列

对于 MDSCHEMA_HIERARCHIES 行集,可对下表中列出的列进行限制。

列名

类型指示符

限制状态

CATALOG_NAME

DBTYPE_WSTR

可选。

SCHEMA_NAME

DBTYPE_WSTR

可选。

CUBE_NAME

DBTYPE_WSTR

可选。

DIMENSION_UNIQUE_NAME

DBTYPE_WSTR

可选。

HIERARCHY_NAME

DBTYPE_WSTR

可选。

HIERARCHY_UNIQUE_NAME

DBTYPE_WSTR

可选。

HIERARCHY_ORIGIN

DBTYPE_UI2

(可选)默认限制对 MD_USER_DEFINED 和 MD_SYSTEM_ENABLED 有效。

CUBE_SOURCE

DBTYPE_UI2

(可选)具有以下任一有效值的位图:

  • 1 CUBE

  • 2 DIMENSION

默认限制的值为 1。

HIERARCHY_VISIBILITY

DBTYPE_UI2

(可选)具有以下任一有效值的位图:

  • 1 可见

  • 2 不可见

默认限制的值为 1。

请参阅

参考

OLE DB for OLAP 架构行集