共用方式為

  • 發行項

CREATE ACTION 陳述式 (MDX)

建立與 Cube、維度、階層或從屬物件關聯的動作。

語法

CREATE ACTION CURRENTCUBE | Cube_Name
   .Action_Name <action body>
<action body> ::= 
FOR 
        CUBE 
    | Hierarchy_Name [MEMBERS] 
    | Level_Name [MEMBERS] 
    | CELLS 
    | SET } 
      AS 'MDX_Expression' 
        [, TYPE = '
              { URL 
            | HTML 
            | STATEMENT 
               | DATASET 
            | ROWSET 
            | COMMANDLINE 
               | PROPRIETARY } 
         ']
   [ , INVOCATION = 'INTERACTIVE | ON_OPEN | BATCH ' ]
   [ , APPLICATION = String_Expression ]
   [ , DESCRIPTION = String_Expression ]
   [ , CAPTION = 'MDX_Expression' ]

引數

  • Cube_Name
    提供 Cube 名稱的有效字串。

  • Action_ Name
    提供將要建立之動作名稱的有效字串。

  • Hierarchy_ Name
    提供階層名稱的有效字串。

  • Level_ Name
    提供層級名稱的有效字串。

  • Member_ Name
    提供成員名稱或成員索引鍵的有效字串。

  • MDX_Expression
    有效的 MDX 運算式。

  • String_Expression
    有效的字串運算式。

備註

用戶端應用程式可以建立和執行不安全的動作；用戶端應用程式也可以使用不安全的函數。若要避免這些狀況，請使用「Safety Options」屬性。如需詳細資訊，請參閱＜安全性選項屬性＞。

[!附註]

包含此陳述式是為了回溯相容性 (Backward Compatibility) 的需要。不支援 SQL Server Analysis Services 的新動作，例如「鑽研」或「報表」動作。

動作類型

下表描述 Microsoft SQL Server Analysis Services 中可用的不同動作類型。

動作類型

描述

URL

傳回的動作字串是 URL，應使用網際網路瀏覽器開啟。

附註附註
如果此動作不是以 http:// 或 https:// 為開頭，那麼瀏覽器將無法使用此動作，除非「SafetyOptions」設為 DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL。

HTML

傳回的動作字串是 HTML 指令碼。應將此字串儲存至檔案，而且應使用網際網路瀏覽器來轉譯此檔案。在此情況下，可能會將整個指令碼視為已產生 HTML 的一部分執行。

STATEMENT

傳回的動作字串是一個陳述式，必須將命令物件的 ICommand::SetText 方法設為字串，並呼叫 ICommand::Execute方法來執行。如果未能成功執行此命令，會傳回錯誤。

DATASET

傳回的動作字串是一個 MDX 陳述式，必須將命令物件的 ICommand::SetText 方法設為字串，並呼叫 ICommand::Execute 方法來執行。要求的介面識別碼 (IID) 應為 IDataset。如果已建立資料集，此命令就能成功執行。用戶端應用程式應該允許使用者瀏覽傳回的資料集。

ROWSET

跟 DATASET 相似，但用戶端應用程式應該要求 IRowset 的 IID，而不是 IDataset 的 IID。如果已建立資料列集，此命令就能成功執行。用戶端應用程式應該允許使用者瀏覽傳回的資料列集。

COMMANDLINE

用戶端應用程式應執行此動作字串。此字串是一個命令列。

PROPRIETARY

除非用戶端應用程式有自訂、非一般的特定動作，否則應用程式不應該顯示，也不該執行此動作。除非用戶端應用程式在 APPLICATION_NAME 上設定適當限制，明確提出要求，否則不會將專屬動作傳回給用戶端應用程式。

引動過程類型

下表描述 Analysis Services 中可用的不同引動過程類型。引動過程類型只由用戶端應用程式使用，可協助判定何時要叫用動作。引動過程類型實際上不會決定動作的引動過程行為。

引動過程類型

描述

INTERACTIVE

此動作應透過使用者互動，由用戶端應用程式叫用。

ON_OPEN

此動作應在目標物件開啟時，由用戶端應用程式叫用。目前未實作此引動過程類型。

BATCH

此動作應在用戶端應用程式決定要在批次作業中叫用目標物件時，由用戶端應用程式叫用。目前未實作此引動過程類型。

範圍

每個動作是為特定 Cube 而定義，而且在該 Cube 中有唯一的名稱。一個動作可有下表列出的其中一個範圍。

  • Cube 範圍
    獨立於特定維度、成員或資料格集的動作；例如：「啟動 AS/400 生產系統的終端機模擬」。

  • 維度範圍
    此動作適用於特定維度。這些動作不相依於層級或成員的特定選取項目。

  • 層級範圍
    此動作適用於特定維度層級。這些動作不相依於該維度內成員的特定選取項目。

  • 成員範圍
    此動作適用於特定層級成員。

  • 資料格範圍
    此動作僅適用於特定資料格。

  • 集合範圍
    此動作僅適用於集合。ActionParameterSet 名稱保留供動作之運算式內的應用程式使用。

請參閱

其他資源

MDX 資料定義陳述式 (MDX)