CREATE ACTION ステートメント (MDX)

[アーティクル]
12/15/2008

更新 : 2006 年 7 月 17 日

キューブ、ディメンション、階層、下位オブジェクトに関連付けられるアクションを作成します。

構文

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
キューブ名を指定する有効な文字列です。

Action_ Name
作成するアクションの名前を指定する有効な文字列です。

Hierarchy_ Name
階層名を指定する有効な文字列です。

Level_ Name
レベル名を指定する有効な文字列です。

Member_ Name
メンバ名またはメンバキーを指定する有効な文字列です。

MDX_Expression
有効な MDX 式です。

String_Expression
有効な文字列式です。

解説

クライアントアプリケーションが安全でないアクションを作成して実行したり、安全でない関数を使用したりする可能性もあります。そのような事態を避けるには、Safety Options プロパティを使用します。詳細については、「Safety Options プロパティ」を参照してください。

メモ :
このステートメントは、旧バージョンとの互換性のために用意されています。SQL Server 2005 Analysis Services (SSAS) で新しく追加されたアクション (ドリルスルーやレポート) はサポートされていません。

アクションの種類

Microsoft SQL Server 2005 Analysis Services (SSAS) で使用できるアクションの種類は次のとおりです。

アクションの種類

説明

URL

返されるアクション文字列は、インターネットブラウザで開く URL です。

ms144885.note(ja-jp,SQL.90).gif メモ :

このアクションが http:// または https:// で始まっていない場合は、SafetyOptions を DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL に設定しない限り、ブラウザでそのアクションを実行することはできません。

HTML

返されるアクション文字列は、HTML スクリプトです。その文字列をファイルに保存して、そのファイルをインターネットブラウザで処理します。この場合は、生成された HTML の一部としてスクリプト全体を実行できます。

STATEMENT

返されるアクション文字列はステートメントです。そのステートメントは、コマンドオブジェクトの ICommand::SetText メソッドをその文字列に設定し、ICommand::Execute メソッドを呼び出すことによって実行する必要があります。コマンドが成功しなかった場合は、エラーが返されます。

DATASET

返されるアクション文字列は、MDX ステートメントです。その MDX ステートメントは、コマンドオブジェクトの ICommand::SetText メソッドをその文字列に設定し、ICommand::Execute メソッドを呼び出すことによって実行する必要があります。要求するインターフェイス ID (IID) は、IDataset です。データセットが作成されれば、コマンドは成功したことになります。クライアントアプリケーションでは、返されたデータセットをユーザーが表示できるようにする必要があります。

ROWSET

基本的に DATASET と同じですが、クライアントアプリケーションでは、IDataset の IID を要求する代わりに、IRowset の IID を要求します。行セットが作成されれば、コマンドは成功したことになります。クライアントアプリケーションでは、返された行セットをユーザーが表示できるようにする必要があります。

COMMANDLINE

クライアントアプリケーションでアクション文字列を実行します。その文字列は、コマンドラインです。

PROPRIETARY

クライアントアプリケーションが、特有のアクションに関するカスタム情報や一般的でない情報を認識できるのでない限り、この種のアクションの表示や実行を行うべきではありません。APPLICATION_NAME に対する適切な制限を設定したうえで、クライアントアプリケーションが独自のアクションを明示的に要求するのでなければ、独自のアクションがクライアントアプリケーションに返されることはありません。

呼び出しの種類

Analysis Services で使用できる呼び出しの種類は以下のとおりです。クライアントアプリケーションでは、呼び出しの種類に基づいて、アクションを呼び出すタイミングを判別します。呼び出しの種類によって、アクションの呼び出しの動作が実際に決まるわけではありません。

呼び出しの種類	説明
INTERACTIVE	クライアントアプリケーションは、ユーザーとの対話によってアクションを呼び出します。
ON_OPEN	クライアントアプリケーションは、対象のオブジェクトが開かれた時点でアクションを呼び出します。この呼び出しの種類は、現在実装されていません。
BATCH	クライアントアプリケーションは、対象のオブジェクトがバッチ操作にかかわった時点を判別してアクションを呼び出します。この呼び出しの種類は、現在実装されていません。

スコープ

各アクションは、特定のキューブに対して定義するものであり、そのキューブ内で一意の名前を持ちます。アクションには、以下のいずれかのスコープを設定できます。

キューブスコープ
特定のディメンション、メンバ、セルに限定されないアクションです。たとえば、"AS/400 実稼働システムの端末エミュレーションの起動" などは、これに相当します。

ディメンションスコープ
特定のディメンションに適用されるアクションです。この種のアクションは、選択された特定のレベルまたはメンバに依存しません。

レベルスコープ
特定のディメンションレベルに適用されるアクションです。この種のアクションは、そのディメンション内で選択された特定のメンバに依存しません。

メンバスコープ
特定のレベルメンバに適用されるアクションです。

セルスコープ
特定のセルだけに適用されるアクションです。

セットスコープ
1 つのセットだけに適用されるアクションです。ActionParameterSet という名前は、そのアクションの式の中でアプリケーションが使用する予約語です。

参照

その他の技術情報

MDX データ定義ステートメント (MDX)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース	履歴
2006 年 7 月 17 日	変更内容 : わかりやすくするために構文および引数を更新しました。

次の方法で共有

CREATE ACTION ステートメント (MDX)

構文

引数

解説

アクションの種類

呼び出しの種類

スコープ

参照

その他の技術情報

ヘルプおよび情報

変更履歴

その他のリソース