共用方式為

  • 發行項

MDSCHEMA_ACTIONS 資料列集

描述可用於用戶端應用程式的動作。

資料列集資料行

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

資料行名稱

類型指標

長度

描述

CATALOG_NAME

DBTYPE_WSTR

資料庫的名稱。

SCHEMA_NAME

DBTYPE_WSTR

不支援。一定會包含 VT_NULL。

CUBE_NAME

DBTYPE_WSTR

此動作所屬 Cube 的名稱。

ACTION_NAME

DBTYPE_WSTR

此動作的名稱。

ACTION_TYPE

DBTYPE_I4

點陣圖，可用於指定動作的觸發方法。Msmd.h 檔案為此點陣圖定義下列的位元值常數：

  • MDACTION_TYPE_URL (0x01)

  • MDACTION_TYPE_HTML (0x02)

  • MDACTION_TYPE_STATEMENT (0x04)

  • MDACTION_TYPE_DATASET (0x08)

  • MDACTION_TYPE_ROWSET (0x10)

  • MDACTION_TYPE_COMMANDLINE (0x20)

  • MDACTION_TYPE_PROPRIETARY (0x40)

  • MDACTION_TYPE_REPORT (0x80)

  • MDACTION_TYPE_DRILLTHROUGH (0x100)

COORDINATE

DBTYPE_WSTR

多維度運算式 (MDX) 運算式，指定物件或要在其中執行動作的多維度空間中的座標。用戶端應用程式必須負責提供此限制資料行的値。

CORDINATE 必須解決成 COORDINATE_TYPE 所指定的物件。

COORDINATE_TYPE

DBTYPE_I4

點陣圖，指定如何解譯 COORDINATE 限制資料行。Msmd.h 檔案為此點陣圖定義下列的位元值常數：

  • MDACTION_COORDINATE_CUBE (1)

  • MDACTION_COORDINATE_DIMENSION (2)

    參考到維度階層。

  • MDACTION_COORDINATE_LEVEL (3)

  • MDACTION_COORDINATE_MEMBER (4)

  • MDACTION_COORDINATE_SET (5)

  • MDACTION_COORDINATE_CELL (6)

ACTION_CAPTION

DBTYPE_WSTR

如果未指定任何標題，且 DDL 中未指定任何翻譯，則此為動作名稱。

如果指定了標題或翻譯，且 CaptionIsMDX 為 False，則下列其中一個字串：

  • 適當語言的翻譯。

  • 如果沒有找到所指定語言的翻譯，則此為指定的標題。

  • 如果沒有找到翻譯，且在 DDL 中未指定標題，則此為動作名稱。

如果指定了標題或翻譯，且 CaptionIsMDX 為 True，則字串會在找到 DDL 標題中所指定語言的適當翻譯或指定翻譯，並計算建立字串的公式後產生。

如果動作是在 MDX 指令碼中指定，則沒有翻譯，且標題一定會被視為 MDX 運算式。

DESCRIPTION

DBTYPE_WSTR

動作的易記描述。

CONTENT

DBTYPE_WSTR

要執行之動作的運算式或內容。

APPLICATION

DBTYPE_WSTR

要用於執行動作的應用程式的名稱。

INVOCATION

DBTYPE_I4

如何叫用動作的相關資訊：

  • MDACTION_INVOCATION_INTERACTIVE (1) 指出在正常作業期間所用的一般動作。這是此資料行的預設值。

  • MDACTION_INVOCATION_ON_OPEN (2) 指出此動作應在第一次開啟 Cube 時執行。

  • MDACTION_INVOCATION_BATCH (4) 指出此動作會當做批次作業或 MicrosoftSQL ServerIntegration Services 工作的一部分來執行。

這些列舉值會定義於 Msmd.h 檔案中。

資料列集會按 CATALOG_NAME、SCHEMA_NAME、CUBE_NAME 和 ACTION_NAME 排序。

[!附註]

MDACTION_TYPE_PROPRIETARY 類型的動作必須提供 APPLICATION 資料行的値。

限制資料行

在下表列出的資料行上可能會限制 MDSCHEMA_ACTIONS 資料列集。

資料行名稱

類型指標

限制狀態

CATALOG_NAME

DBTYPE_WSTR

選擇性

SCHEMA_NAME

DBTYPE_WSTR

選擇性

CUBE_NAME

DBTYPE_WSTR

強制性

ACTION_NAME

DBTYPE_WSTR

選擇性

ACTION_TYPE

DBTYPE_I4

選擇性

COORDINATE

DBTYPE_WSTR

強制性

COORDINATE_TYPE

DBTYPE_I4

強制性

INVOCATION

DBTYPE_I4

(選擇性) INVOCATION 限制資料行預設為 MDACTION_INVOCATION_INTERACTIVE 的値。若要擷取所有動作，請使用 INVOCATION 限制資料行中的 MDACTION_INVOCATION_ALL 値。

CUBE_SOURCE

DBTYPE_UI2

(選擇性) 具有下列其中一個有效值的點陣圖：

  • 1 CUBE

  • 2 DIMENSION (維度)

預設限制為値 1。
重要注意事項重要事項

INVOCATION 限制資料行具有 MDACTION_INVOCATION_INTERACTIVE 的預設値。任何未明確指定此資料行值的結構描述資料列集，都只包含具有此値的資料列。如果想要資料列集包含整個動作集，請在 INVOCATION 限制資料行中使用 MDACTION_INVOCATION_ALL 常數。

用戶端應用程式可以使用 OR 運算子來定義一個以上的 ACTION_TYPE。

備註

下表列出有效的 COORDINATE 和 COORDINATE_TYPE 組合。

COORDINATE 物件類型

COORDINATE_TYPE

Cube

MDACTION_COORDINATE_CUBE

Dimension

MDACTION_COORDINATE_DIMENSION

MDACTION_COORDINATE_LEVEL

MDACTION_COORDINATE_MEMBER

MDACTION_COORDINATE_SET

MDACTION_COORDINATE_CELL

Hierarchy

MDACTION_COORDINATE_DIMENSION

Level

MDACTION_COORDINATE_LEVEL

Member

MDACTION_COORDINATE_MEMBER

Set

MDACTION_COORDINATE_SET

cell

MDACTION_COORDINATE_CELL