Analysis Services データベースに対する拡張フィールド プロパティの使用

更新 : 2006 年 4 月 14 日

SQL Server Analysis Services のデータ処理拡張機能では、拡張フィールド プロパティがサポートされています。拡張フィールド プロパティとは、データ ソースにありデータ処理拡張機能でサポートされるフィールド プロパティ Value および IsMissing に加えて使用するプロパティです。拡張プロパティは、レポート データセットのフィールド コレクションの一部として [データセット] ペインには表示されません。拡張フィールド プロパティ値をレポートに含めるには、グローバル Fields コレクションを使用して名前で拡張フィールド プロパティ値を指定する式を記述します。

拡張プロパティには、定義済みプロパティとカスタム プロパティがあります。定義済みプロパティとは、特定のフィールド プロパティ名にマップされ、グローバル Fields コレクションを介して名前でアクセスできる、複数のデータ ソースに共通のプロパティです。カスタム プロパティは、データ プロバイダごとに定義され、拡張プロパティ名を文字列として扱う構文のみを使用して、グローバル Fields コレクションを介してアクセスできます。

Analysis Services MDX クエリ デザイナをグラフィカル モードで使用してクエリを定義する場合、セル プロパティおよびディメンション プロパティの定義済みのセットが自動的に MDX クエリに追加されます。レポート内では、MDX クエリに明記されている拡張プロパティのみを使用できます。レポートによっては、既定の MDX コマンド テキストを変更して、キューブに定義されている他のディメンションまたはカスタム プロパティを含めることができます。Analysis Services データ ソースで使用できる拡張フィールドの詳細については、「プロパティ値の作成および使用 (MDX)」を参照してください。

レポートのフィールド プロパティの操作

拡張フィールド プロパティには、定義済みプロパティとデータ プロバイダ固有のプロパティがあります。フィールド プロパティは、データセット用に作成されたクエリに存在しますが、[データセット] ウィンドウのフィールド一覧に表示されません。したがって、フィールド プロパティはレポートのレイアウトにドラッグできません。代わりに、フィールドをレポートにドラッグし、フィールドの Value プロパティから、使用するプロパティに変更します。

事前に定義されていない拡張プロパティを参照するには、式で次の構文を使用します。

• Fields!FieldName("PropertyName")

定義済みフィールド プロパティ

ほとんどの場合、定義済みフィールド プロパティはメジャー、レベル、またはディメンションに適用されます。定義済みフィールド プロパティは、対応する値が Analysis Services データ ソースに格納されている必要があります。値が存在しない場合、または、レベルにメジャーのみのフィールド プロパティを指定する場合、プロパティは NULL 値を返します。

次の構文のいずれかを使用して、式から定義済みプロパティを参照できます。

• Fields!FieldName.PropertyName
• Fields!FieldName("PropertyName")

次の表に、使用できる定義済みフィールド プロパティの一覧を示します。

定義済みフィールド プロパティは、フィールドに構文を入力する際に式エディタの IntelliSense に表示されます。詳細については、「式でのグローバル コレクションの使用 (Reporting Services)」を参照してください。

メモ :
レポートが実行されてそのデータセットのデータを取得する際にデータ ソース (Analysis Services キューブなど) によってこれらの値が提供される場合にのみ、これらの拡張フィールド プロパティに対応する値が存在します。その場合、以下に示す構文を使用して、すべての式からこれらのフィールド プロパティ値を参照できます。ただし、これらのフィールドはこのデータ プロバイダに固有であるため、これらの値に加えた変更はレポート定義には保存されません。

拡張プロパティの例

拡張プロパティの例として、次の MDX クエリおよび結果セットには、キューブに対して定義されているディメンション属性で使用できるいくつかのメンバ プロパティが含まれています。含まれているメンバ プロパティは、MEMBER_CAPTION、UNIQUENAME、Properties("Day Name")、MEMBER_VALUE、PARENT_UNIQUE_NAME、および MEMBER_KEY です。

この MDX クエリは、AdventureWorks サンプル データベースに付属している AdventureWorks DW データベース内の AdventureWorks キューブに対して実行します。

WITH MEMBER [Measures].[DateCaption] 
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_CAPTION' 
   MEMBER [Measures].[DateUniqueName] 
      AS '[Date].[Date].CURRENTMEMBER.UNIQUENAME' 
   MEMBER [Measures].[DateDayName] 
      AS '[Date].[Date].Properties("Day Name")' 
   MEMBER [Measures].[DateValueinOriginalDatatype] 
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_VALUE' 
   MEMBER [Measures].[DateParentUniqueName] 
      AS '[Date].[Date].CURRENTMEMBER.PARENT_UNIQUE_NAME' 
   MEMBER [Measures].[DateMemberKeyinOriginalDatatype] 
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_KEY' 
SELECT {
   [Measures].[DateCaption], 
   [Measures].[DateUniqueName], 
   [Measures].[DateDayName], 
   [Measures].[DateValueinOriginalDatatype],
   [Measures].[DateParentUniqueName],
   [Measures].[DateMemberKeyinOriginalDatatype]
   } ON COLUMNS , [Date].[Date].ALLMEMBERS ON ROWS 
FROM [Adventure Works]

このクエリを MDX クエリ ペインで実行すると、1,158 行の結果セットが返されます。最初の 4 行を次の表に示します。

MDX クエリ デザイナのグラフィカル モードを使用して作成される既定の MDX クエリに、ディメンション プロパティとして含まれるのは MEMBER_CAPTION と UNIQUENAME のみです。既定では、これらの値は常に String データ型です。

メンバ プロパティの元のデータ型を保持する必要がある場合は、汎用クエリ デザイナで既定の MDX ステートメントを変更することで、追加のプロパティ MEMBER_VALUE を含めることができます。次の単純な MDX ステートメントでは、取得するディメンション プロパティのリストに MEMBER_VALUE が追加されています。

SELECT NON EMPTY {[Measures].[Order Count]} ON COLUMNS, 
NON EMPTY { ([Date].[Month of Year].[Month of Year] ) } 
DIMENSION PROPERTIES 
  MEMBER_CAPTION, MEMBER_UNIQUE_NAME, MEMBER_VALUE ON ROWS 
FROM [Adventure Works]
CELL PROPERTIES 
  VALUE, BACK_COLOR, FORE_COLOR, 
  FORMATTED_VALUE, FORMAT_STRING, 
  FONT_NAME, FONT_SIZE, FONT_FLAGS

MDX 結果ペインに表示された結果の最初の 4 行を次の表に示します。

プロパティは MDX の SELECT ステートメントに含まれていますが、結果セット列には表示されません。そこで、拡張プロパティ機能を使用すると、データをレポートに使用することができます。SQL Server Management Studio の MDX クエリ結果ペインで、セルをダブルクリックすると、セルのプロパティ値が表示されます (キューブ内で設定されている場合)。1,379 という値が格納されている最初の Order Count セルをダブルクリックすると、ポップアップ ウィンドウに次のセル プロパティが表示されます。

このクエリを使用してレポート データセットを作成し、データセットをテーブルにバインドすると、フィールドの既定の VALUE プロパティが表示されます (たとえば =Fields!Month_of_Year!Value)。Value フィールドは既定で String データ型なので、この式をテーブルの並べ替え式として使用した場合、結果は月のアルファベット順に並べ替えられます。月がカレンダー順に並ぶ (つまり、January が先頭に来て December が最後に来る) ようにテーブルを並べ替えるには、次の式を使用します。

=Fields!Month_of_Year("MEMBER_VALUE")

これにより、データ ソースの元の整数データ型に基づいてフィールドの値が並べ替えられます。

参照

関連項目

式でのグローバル コレクションの使用 (Reporting Services)

概念

レポート データセットの定義 (Analysis Services の多次元データおよびデータ マイニング予測データ)
レポート データセットの定義 (SAP NetWeaver BI システムの多次元データ)

その他の技術情報

Reporting Services での式の使用

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴