EntityType 元素 (CSDL)

EntityType 元素會定義資料模型中的單一實體。 bi:EntityType 元素會擴充實體資料架構中使用之 EntityType 的定義。

系統會針對資料模型中包含的每個實體指定 EntityType 元素。 EntityType 的子元素會描述資料表中的資料行和量值。 資料表之間的關聯性包含在 EntityContainer 中。

EntityType 元素可能具有下列子元素 (按所列順序):

  • Key 元素

  • Property 元素

  • NavigationProperty 元素

適用的屬性

下表描述了在 EntityType 元素上找到的屬性,以及適用於 EntityType 元素的所有屬性。

屬性名稱

是否必要

值

Caption

否

實體的易記顯示名稱。 如果模型中沒有設定標題,則不顯示任何標題。

Collection

是

資料模型的名稱。

CollectionCaption

否

實體的複數名稱。

目錄

否

表示實體中資料類型的值,可能的值如下所列。 這些值是以維度的 Analysis Services 內容類型為基礎,屬於選擇性:

  • 帳戶

  • BillOfMaterials

  • Channel

  • 貨幣

  • Customers

  • Geography

  • Organization

  • Products

  • Promotions

  • Quantitative

  • Rates

  • Regular

  • 案例

  • Time

  • 公用程式

DefaultDetails

否

屬性參考的清單,共同代表資料表中的資料行集。

DefaultImage

否

包含用來說明實體之影像之資料行的參考。

DisplayKey

資料行或角色端的參考清單,這些資料行或角色端構成了可向使用者唯一識別實體執行個體的強式識別碼。

文件集

否

實體的描述。

IsTimeDimension

是

指出是否將實體當做時間維度使用。

Key

是

表示當做實體索引鍵使用的資料行。

名稱

是

Cube 維度的合併名稱。

OriginEntityType

否

主要資料表的合併名稱。 如果此值與 EntityType 名稱的值相同,表示實體就是原始實體。

限定詞

否

在檢視上設定的屬性,可讓用戶端用來區別不同檢視中的屬性。

ReferenceName

是

實體的未合併完整名稱。

隱藏

否

如果為 True,表示應該向用戶端隱藏實體。

範例

下列摘錄顯示模型中使用之 Date 資料表的部分 CSDL 表示法。

<EntityType Name="Date">
            <Key>
              <PropertyRef Name="Date" />
            </Key>
            <Property Name="RowNumber" Type="Int64" Nullable="false">
              <bi:Property Hidden="true" Contents="RowNumber" Stability="RowNumber" />
            </Property>
            <Property Name="Date" Type="DateTime" Nullable="false">
              <bi:Property />
            </Property>
            <Property Name="DayNumberOfWeek" Type="Int64">
              <bi:Property />
            </Property>
            <Property Name="EnglishDayNameOfWeek" Type="String" MaxLength="Max" FixedLength="false">
              <bi:Property />
            </Property>
            <bi:EntityType Contents="Time" />
          </EntityType>
  </Association>