Property 要素 (CSDLBI)

[アーティクル]
10/31/2023

重要: このドキュメントはアーカイブされています。最新情報については、「オープン仕様 [MS-CSDLBI]: ビジネスインテリジェンス注釈を使用した概念スキーマ定義ファイル形式」を参照してください。

CSDLBI の Property 要素は、ビジネスインテリジェンスデータモデルをサポートするために、CSDL の Property 要素に追加項目を加えた複合型です。

要素と属性

次の表に、CSDLBI Property 要素を定義する要素と属性を示します。

名前	必須	説明
内容	No	要求の LCID を含む文字列。
DefaultAggregationFunction	はい	計算が属性上で実行され、他の関数が指定されていない場合に使用される集計関数を指定する文字列。指定されない場合、モデルに対する既定の集計関数が使用されます。通常 SUM です。
GroupingBehavior	No	クエリ結果をグループ化する方法を指定する値。属性の内容は TGroupingBehavior 単純型によって定義されます (次の表を参照してください)。
OrderBy	No	このプロパティの値の並べ替え順序が定義されているモデル内の別のプロパティへの参照。 2 つのプロパティの値は 1 対 1 のマッピングである必要があります。それ以外の場合は、並べ替えの動作が未定義です。この要素が省略されると、プロパティは値を基準にして並べ替えられます。
Stability	No	更新操作の間のプロパティ値の安定性を指定する属性です。この属性はユーザーが設定するのではなく、デザイン時環境に不安定な値対してのみ発せられます。行番号を持つ列と、不確定な結果を生成する NOW() または RAND() の式を含む列に常に適用されます。この属性の値は、Stability 単純型を説明する下記の表で示します。

GroupingBehavior

次の表に GroupingBehavior 単純型の値を示します。

値	説明
GroupOnValue	属性の値によるグループ化。
GroupOnEntityKey	エンティティキーによるグループ化。

この 2 つの値は次のように使用できます。たとえば、名前で指定される特定のユーザーの給与天引き額を返すクエリがあるとします。さらにデータベースには、同名で異なるデータベース ID を持つ 2 人のユーザーが含まれているとします。この場合、どちらの属性値が列に適用されているかによって、クエリ結果が異なります。

GroupOnValue: クエリ結果には、両方のユーザーの給与の推論が含まれます。合計は合計されます。
GroupOnEntityKey: クエリ結果には、各ユーザーの給与の推論が含まれますが、個別に一覧表示されます。

Stability

次の表に、Stability 単純型 の値を 示します。

値	説明
Stable	更新操作の間、プロパティは一定です。
RowNumber	プロパティに行番号が含まれます。
Volatile	更新操作の間、プロパティが一定ではない場合があります。

表形式の例

次の XML は、AdventureWorks のテーブルモデルサンプルで使用されているプロパティの一部を CSDLBI Version 1.1 で表現したものです。

  
<EntityType   
   Name="DimEmployee">  
   <Key>  
      <PropertyRef   
      Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber" />  
   </Property>  
  
   <Property   
      Name="EmployeeKey"   
      Type="Int64">  
   <bi:Property />  
   </Property>  
….  
</bi:EntityType>  
</EntityType>

多次元の例

CSDLBI Version 1.1 における次の例では、Contoso Operations キューブを表すデータモデルにおける列のプロパティの一部を示します。プレゼンテーション層で特殊な処理が必要な場合を除き、BI 注釈がほとんどの列で必須ではなく、適用もされないことに注目してください。

  
<EntityType   
   Name="Bike">  
  
   <Key>  
      <PropertyRef Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber"   
   />  
   </Property>  
  
   <Property   
      Name="ProductAlternateKey"   
      Type="String"   
      MaxLength="Max"   
      Unicode="true"   
      FixedLength="false">  
   <bi:Property />  
   </Property>

次の方法で共有