共用方式為

Cell 元素 (MDDataSet) (XMLA)

  • 發行項

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

語法

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

元素特性

特性

說明

資料類型和長度

無

預設值

無

基數

0-n：出現一次以上的選擇性元素。

元素關聯性

關聯性

元素

父元素

CellData

子元素

零或多個資料格屬性值，或 Error

屬性

屬性

說明

CellOrdinal

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

備註

在 root 父元素中，Axes 元素後面接著 CellData 元素，而它是 Cell 元素的集合，其中包含在多維度資料集中傳回之每個資料格的屬性值。 Cell 元素包含 CellOrdinal 屬性 (Attribute)，它會指出資料格在多維度資料集中的以零為基底序數位置，而且會針對與資料格相關聯的每個資料格屬性 (Property) 值指出一個元素。 Cell 元素中的每個資料格屬性值都由不同的 XML 元素所定義。 資料格屬性的值是 XML 元素所包含的資料，而且資料格屬性的名稱 (在父根元素的 CellInfo 元素中定義) 會對應至 XML 元素的名稱。

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

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

資料格屬性值的資料類型僅針對 VALUE 資料格屬性指定。 其他資料格屬性的資料類型則由 CellInfo 元素中包含的資料格屬性定義決定。 如果您已經針對資料格屬性指定預設值 (針對 CellInfo 元素中包含的資料格屬性定義加入 Default 元素)，或者沒有指定任何預設值而且資料格屬性的值為 Null，此時可能會排除資料格屬性值元素。

資料格屬性錯誤

如果由於 Microsoft SQL Server Analysis Services 執行個體發生錯誤 (例如，無法針對給定資料格傳回值的計算錯誤) 而無法傳回資料格屬性，Error 元素就會取代發生問題的資料格屬性內容。 下列 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 元素的結構，包括每個資料格的 VALUE、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>

請參閱

參考

MDDataSet 資料類型 (XMLA)

概念

屬性 (XMLA)