MDX 資料定義 - CREATE ACTION

  • 發行項

建立可以與 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_名稱
提供所建立動作名稱的有效字串。

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

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

Member_名稱
提供成員名稱或成員金鑰的有效字串。

MDX_Expression
有效的 MDX 運算式。

String_Expression
有效的字串運算式。

備註

用戶端應用程式可以建立並執行不安全的動作;用戶端應用程式也可以使用不安全的函式。 若要避免這些情況，請使用 Safety Options 屬性。 如需詳細資訊，請參閱 Safety Options 屬性。

注意

此語句隨附于回溯相容性。 不支援 Analysis Services 的新動作，例如鑽研或報表動作。

動作類型

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

動作類型 描述
URL 傳回的動作字串是應該使用網際網路瀏覽器開啟的 URL。

注意：如果此動作不是以 https:// 或 https:// 開頭，除非 SafetyOptions 設定為 DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL ，否則瀏覽器將無法使用此動作。
HTML 傳回的動作字串是 HTML 腳本。 字串應該儲存至檔案，而且應該使用網際網路瀏覽器來轉譯檔案。 在此情況下，整個腳本可能會以產生的 HTML 一部分執行。
聲明 傳回的動作字串是一個語句，必須藉由將命令物件的 ICommand：：SetText 方法設定 為字串並呼叫 ICommand：：Execute 方法來執行。 如果命令失敗，則會傳回錯誤。
資料 傳回的動作字串是需要執行的 MDX 語句，方法是將命令物件的 ICommand：：SetText 方法設定 為字串並呼叫 ICommand：：Execute 方法。 要求的介面識別碼 （IID） 應該是 IDataset 。 如果已建立資料集，命令就會成功。 用戶端應用程式應該允許使用者流覽傳回的資料集。
ROWSET 類似于 DATASET ，但用戶端應用程式應該要求 IRowset 的 IID ，而不是要求 IDataset 的 IID。 如果已建立資料列集，命令就會成功。 用戶端應用程式應該允許使用者流覽傳回的資料列集。
COMMANDLINE 用戶端應用程式應該執行動作字串。 字串是命令列。
專有 除非應用程式具有特定動作的自訂非一般知識，否則用戶端應用程式不應顯示或執行動作。 除非用戶端應用程式明確要求這些動作，方法是對APPLICATION_NAME 設定適當的限制 ，否則不會將專屬動作傳回給用戶端應用程式。

調用類型

下表描述 Analysis Services 中可用的不同類型的調用。 調用類型只會由用戶端應用程式用來協助判斷何時叫用動作。 調用類型實際上不會判斷動作的調用行為。

調用類型 描述
互動 用戶端應用程式應該透過使用者互動叫用動作。
ON_OPEN 開啟目標物件時，用戶端應用程式應該叫用動作。 此調用類型目前尚未實作。
批 當目標物件涉及批次作業時，用戶端應用程式應該叫用動作，如用戶端應用程式所決定。 此調用類型目前尚未實作。

範圍

每個動作都會針對特定 Cube 定義，並在該 Cube 中具有唯一的名稱。 動作可以有下表所列的其中一個範圍。

Cube 範圍
對於與特定維度、成員或儲存格無關的動作;例如：「啟動 AS/400 生產系統的終端機模擬」。

維度範圍
動作會套用至特定維度。 這些動作不取決於特定層級或成員的選擇。

層級範圍
動作會套用至特定的維度層級。 這些動作不相依于該維度中成員的特定選取專案。

成員範圍
動作適用于特定層級成員。

儲存格範圍
動作僅適用于特定儲存格。

設定範圍
動作僅適用于集合。 名稱 ActionParameterSet 會保留供應用程式在動作運算式內使用。

另請參閱

MDX 資料定義語句 （MDX）