共用方式為

MDSCHEMA_HIERARCHIES 資料列集

  • 發行項

描述特定維度中的每個階層。

資料列集資料行

MDSCHEMA_HIERARCHIES 資料列集包含下列資料行。

資料行名稱

類型指標

長度

說明

CATALOG_NAME

DBTYPE_WSTR

這個階層所屬之目錄的名稱。 如果提供者不支援目錄，則為 NULL。

SCHEMA_NAME

DBTYPE_WSTR

不支援

CUBE_NAME

DBTYPE_WSTR

(必要項) 此階層所屬 Cube 的名稱。

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

階層在 Cube 所有階層中的序數。

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 結構描述資料列集