EntityContainer 要素 (CSDLBI)

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

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

EntityContainer 要素は、CSDL の種類に基づく複合型で、1 つのデータモデル内のエンティティのコレクションを定義します。ビジネスインテリジェンスアプリケーションでは、EntityContainer で表されるデータモデルは、リレーションシップによってリンクされた列のある複数のテーブルと、計算、メジャー、および KPI を含む可能性があります。概念的には、データベースやデータソースに似ています。

EntityContainer では、テーブルやリレーションシップを含む、データモデルに含まれる各エンティティタイプを指定する必要があります。これらのモデルエンティティに関する情報は、Entity 要素型の子エンティティをリストすることで指定します。詳細については、「 EntityType 要素 (CSDLBI)」を参照してください。

照合順序や言語などのプロパティは、個別のオブジェクトではなく、EntityContainer のレベルで定義されます。ただし、モデル内の列およびテキスト属性は、キャプションまたは他の言語での翻訳を持つことができます。

要素と属性

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

名前	必須	説明
名前	はい	データモデルの名前。
Caption	No	データベースまたはデータモデルの説明。
カルチャ	はい	要求の LCID を含む文字列。
CompareOptions	はい	モデルの言語固有の並べ替えおよび文字列比較のオプション
DirectQueryMode	No	モデルが DirectQuery モードを使用するときのクエリモードを示す列挙体。
EntitySet 要素	はい	EntitySet 要素 (CSDLBI)
AssociationSet 要素	No	AssociationSet 要素 (CSDLBI)

CompareOptions 要素

CompareOptions 属性では、データモデルに適用される照合順序のプロパティが定義されます。 CompareOptions で定義されているプロパティは、モデルのデザイン時に Analysis Services データベースで設定される並べ替え順序、かなの区別、大文字小文字の区別に対する設定から派生されます。次の表では、CompareOptions 属性の一部として含まれる値について説明します。

値	説明
IgnoreCase	文字列の比較で大文字と小文字を区別するかどうかを示すブール値。
IgnoreNonSpace	文字列の比較で、分音文字などの非空白結合文字を無視するかどうかを示すブール値。
IgnoreKanaType	文字列の比較でカタカナを区別するかどうかを示すブール値。
IgnoreWidth	文字列の比較で文字幅を区別するかどうかを示すブール値。

DirectQueryMode

DirectQueryMode

単純型である DirectQueryMode は、リレーショナルデータソースからの直接的なデータの取得がモデルで有効である場合に、既定で使用されるクエリの種類を定義します。このプロパティは、DirectQuery モードで実行されるテーブルモデルのみに適用されます。次の表は、DirectQuery モード列挙体で使用可能な値の一覧です。

値	説明
InMemory	モデルに対するクエリがキャッシュ内のデータを使用することを示します。
InMemoryWithDirectQuery	既定では、モデルに対するクエリがリレーショナルデータソースからのデータを使用することを示します。
DirectQueryWithInMemory	既定ではモデルに対するクエリがキャッシュ内のデータを使用することを示します。
DirectQuery	モデルに対するクエリがリレーショナルデータソース内のみのデータを使用することを示します。

表形式の例

CSDLBI Version 1.1 における次の例は、AdventureWorks テーブルデータモデルの一部です。

  
<EntityContainer   
     Name="Sandbox">  
   <EntitySet   
       Name="DimEmployee"   
       EntityType="Sandbox.DimEmployee">  
   <bi:EntitySet />  
   </EntitySet>  
  
   <EntitySet   
     Name="DimProduct"   
       EntityType="Sandbox.DimProduct">  
    <bi:EntitySet />  
    </EntitySet>  
  
<bi:EntityContainer Caption="AWSimple" Culture="en-US">

多次元の例

CSDLBI Version 1.1 における次の例は、Contoso Operations キューブからの抜粋です。

  
<EntityContainer   
     Name="Sandbox">  
   <EntitySet   
      Name="Bike"   
      EntityType="Sandbox.Bike">  
    <bi:EntitySet Hidden="true" />  
   </EntitySet>  
…  
<bi:EntityContainer   
   Caption="CSDLTest"   
   Culture="en-US">  
<bi:CompareOptions   
   IgnoreCase="true" />  
</bi:EntityContainer>  
</EntityContainer>

次の方法で共有