MDX データ操作 - CREATE SET

[アーティクル]
05/23/2023

現在のキューブのセッションスコープを持つ名前付きセットを作成します。

構文

  
CREATE [SESSION] [ STATIC | DYNAMIC ] [HIDDEN] SET   
   CURRENTCUBE | Cube_Name  
      .Set_Name AS 'Set_Expression'  
      [,Property_Name = Property_Value, ...n]

引数

Cube_Name
キューブの名前を提供する有効な文字列式。

Set_Name
作成する名前付きセットの名前を指定する有効な文字列式です。

Set_Expression
セットを返す有効な多次元式 (MDX) 式。

Property_Name
セットのプロパティの名前を指定する有効な文字列です。

Property_Value
セットのプロパティの値を定義する有効なスカラー式です。

解説

名前付きセットは、もう一度使用するために作成するディメンションメンバーのセット (またはセットを定義する式) です。たとえば、売上高上位 10 ストアのセットで構成されるディメンションメンバーのセットを名前付きセットとして定義するとします。このセットは静的に定義することも、 TopCount などの関数を使用して定義することもできます。この名前付きセットは、上位 10 店舗のセットが必要な場所であればどこでも使用できます。

CREATE SET ステートメントは、セッション全体で使用できる名前付きセットを作成するため、セッション内の複数のクエリで使用できます。詳細については、「 Session-Scoped計算メンバーの作成 (MDX)」を参照してください。

1 つのクエリだけで使用する名前付きセットを定義することも可能です。そのようなセットを定義する場合は、SELECT ステートメントで WITH 句を使用します。 WITH 句の詳細については、「名前付きセット (MDX) Query-Scoped作成する」を参照してください。

Set_Expression 句には、MDX 構文をサポートする任意の関数を含めることができます。 SESSION 句を指定しない CREATE SET ステートメントで作成されたセットには、セッションスコープがあります。クエリスコープによるセットを作成するには、WITH 句を使用してください。

現在接続されているキューブ以外のキューブを指定すると、エラーが発生します。したがって、現在のキューブを示すには、キューブ名の代わりに CURRENTCUBE を使用する必要があります。

Scope

ユーザー定義セットは、次の表に示すスコープの 1 つ内で実行できます。

クエリスコープ
セットの表示設定と有効期間は、クエリに限定されます。セットは、個々のクエリで定義されます。クエリスコープはセッションスコープをオーバーライドします。詳細については、「名前付きセットの作成 (MDX)」Query-Scoped参照してください。

セッションスコープ
セットの可視性と有効期間は、セットが作成されるセッションに制限されます。 (DROP SET ステートメントがセットに対して発行された場合、有効期間はセッション期間より短くなります)。CREATE SET ステートメントは、セッションスコープを持つセットを作成します。クエリスコープによるセットを作成するには、WITH 句を使用してください。

例

次の例では、Core Products というセットを作成します。次に SELECT クエリによって、新しく作成されたセットの呼び出しを示しています。 CREATE SET ステートメントは、SELECT クエリを実行する前に実行する必要があります。同じバッチで実行することはできません。

CREATE SET [Adventure Works].[Core Products] AS '{[Product].[Category].[Bikes]}'  
  
SELECT [Core Products] ON 0  
  FROM [Adventure Works]

評価の設定

セット評価は、異なる方法で行われるよう定義できます。これは、セットの作成時に 1 回だけ実行されるように定義することも、セットが使用されるたびに発生するように定義することもできます。

STATIC
CREATE SET ステートメントが評価されるときに、セットを一度だけ評価することを示します。

DYNAMIC
クエリでセットが使用されるたびに、セットを評価することを示します。

可視性の設定

このセットは、キューブに対してクエリを実行する他のユーザーに対して表示または非表示にすることができます。

HIDDEN
キューブに対してクエリを実行するユーザーがセットを表示できないように指定します。

標準のプロパティ

セットには、それぞれ既定のプロパティのセットがあります。クライアントアプリケーションが Analysis Services に接続されている場合、既定のプロパティは、管理者が選択したとおりにサポートされるか、サポート可能になります。

プロパティの識別子	意味
キャプション	クライアントアプリケーションがセットのキャプションとして使用する文字列。
DISPLAY_FOLDER	セットを表示するためにクライアントアプリケーションが使用する、表示フォルダーのパスを識別する文字列です。フォルダーレベルの区切り記号は、クライアントアプリケーションによって定義されます。 Analysis Services によって提供されるツールとクライアントの場合、円記号 (\) はレベル区切り記号です。定義されたセットで複数の表示フォルダーを指定するには、セミコロン (;) を使用してフォルダーを区切ります。

プロパティの識別子

意味

キャプション

クライアントアプリケーションがセットのキャプションとして使用する文字列。

DISPLAY_FOLDER

セットを表示するためにクライアントアプリケーションが使用する、表示フォルダーのパスを識別する文字列です。フォルダーレベルの区切り記号は、クライアントアプリケーションによって定義されます。 Analysis Services によって提供されるツールとクライアントの場合、円記号 (\) はレベル区切り記号です。定義されたセットで複数の表示フォルダーを指定するには、セミコロン (;) を使用してフォルダーを区切ります。

参照

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

次の方法で共有