Cell 元素 (MDDataSet) (XMLA)

發行項
05/08/2023

包含父 CellData 元素所包含之單一資料格的相關資訊。

Syntax

  
<CellData>  
   <Cell CellOrdinal="unsignedInt">  
      <!-- Zero or more cell property values -->  
      <!-- or -->  
      <Error>...</Error>  
   </Cell>  
</CellData>

元素特性

特性	描述
資料類型和長度	None
預設值	None
基數	0-n：出現一次以上的選擇性元素。

元素關聯性

關聯性	元素
父元素	CellData
子元素	零或多個資料格屬性值或錯誤

屬性

屬性	描述
CellOrdinal	必要的 unsignedInt 屬性。資料格在多維度資料集中的序數位置。

備註

在父根元素中，軸元素後面接著 CellData 元素，此為 Cell 元素的集合，其中包含多維度資料集中傳回之每個資料格的屬性值。 Cell元素包含CellOrdinal屬性，這表示資料格在多維度資料集中的以零為基底的序數位置，以及與資料格相關聯之每個資料格屬性值的一個元素。 Cell元素中的每個資料格屬性值都是由不同的 XML 元素所定義。資料格屬性的值是 XML 元素所包含的資料，而資料格屬性的名稱（如父根項目的 CellInfo 元素中所定義）會對應至 xml 元素的名稱。

下列語法將描述資料格屬性值：

<CellProperty xsi:type="string">value</CellProperty>

資料格屬性值的資料類型僅針對 VALUE 資料格屬性指定。其他資料格屬性的資料類型取決於 CellInfo 元素中包含的資料格屬性定義。如果已 (指定預設值，就可以排除資料格屬性值元素，方法是將CellInfo元素中包含的資料格屬性定義的default元素包含在資料格屬性) 中，或者，如果未指定任何預設值，而且資料格屬性的值為 null。

資料格屬性錯誤

如果由於 Analysis Services 實例上發生的錯誤而無法傳回資料格屬性，例如無法針對指定儲存格傳回值的計算錯誤，則錯誤專案會取代有問題的資料格屬性內容。下列 XML 範例將描述資料格屬性錯誤：

<Cell CellOrdinal="0">  
   <Value xsi:type="xsd:double">  
      <Error>  
         <ErrorCode>2148497527</ErrorCode>  
         <Description>Unknown error</Description>  
      </Error>  
   </Value>  
</Cell>

計算資料格序數值

您可以根據 CellOrdinal 屬性值來計算資料格的軸參考。從概念上來說，資料集會以資料集的編號，如同資料集是一種 p維陣列，其中 p 是軸的數目。資料格的處理順序是以資料列為主。

假設某項查詢針對資料行要求四個量值，而針對資料列要求兩個州與四個季節的交叉聯結。在下列資料集結果中，以粗體文字顯示的資料集結果部分的 CellOrdinal 屬性為 {9，10，11，13，14，15，17，18，19} 的設定。這是設定，因為資料格是以資料列主要順序編號，從左上方儲存格的 CellOrdinal 為0。

州	季	單位銷售量	店面成本	店面銷售量	銷售計數
California	Q1	16890	14431.09	36175.2	5498
	Q2	18052	15332.02	38396.75	5915
	Q3	18370	15672.83	39394.05	6014
	Q4	21436	18094.5	45201.84	7015
Oregon	Q1	19287	16081.07	40170.29	6184
	Q2	15079	12678.96	31772.88	4799
	Q3	16940	14273.78	35880.46	5432
	Q4	16353	13738.68	34453.44	5196
Washington	Q1	30114	25240.08	63282.86	9906
	Q2	29479	24953.25	62496.64	9654
	Q3	30538	25958.26	64997.38	10007
	Q4	34235	29172.72	73016.34	11217

套用本圖所示的公式後，軸 k = 0 具有 Uk = 4 個成員，而軸 k = 1 具有 Uk = 8 個 Tuple。 P = 2 是查詢中的總軸數。將資料格 {California, Q3, Store Cost} 視為 S0 之後，初始總和為 i = 0 至 1。若 i = 0，{Store Cost} 之軸 0 上的 Tuple 序數是 1。若 i = 1，{CA, Q3} 的 Tuple 序數則為 2。

若 i = 0，則 Ei = 1，而若 i = 0，則總和為 1 * 1 = 1，而若 i = 1，則總和為 2 (Tuple 序數) 乘以 4 (計算成 1 * 4 的 Ei 值) 或 8。 1 + 8 的總和為 9，亦即該資料格的資料格序數。

範例

下列範例示範 cell 元素的結構，包括每個資料格的值、FORMATTED_VALUE 和 FORMAT_STRING 資料格屬性值。

<CellData>  
   <Cell CellOrdinal="0">  
      <Value xsi:type="xsd:double">16890</Value>  
      <FmtValue>16,890.00</FmtValue>  
      <FormatString>Standard</FormatString>  
   </Cell>  
   <Cell CellOrdinal="1">  
      <Value xsi:type="xsd:int">50</Value>  
      <FmtValue>50</FmtValue>  
      <FormatString>Standard</FormatString>  
   </Cell>  
   <Cell CellOrdinal="2">  
      <Value xsi:type="xsd:double">36175.2</Value>  
      <FmtValue>$36,175.20</FmtValue>  
      <FormatString>Currency</FormatString>  
   </Cell>  
</CellData>

共用方式為