Элемент Cell (MDDataSet) (XML для аналитики)

Содержит сведения об одной ячейке, содержащейся в родительском элементе CellData.

Синтаксис

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

Характеристики элемента

Связи элемента

Атрибуты

Замечания

В родительском элементе root за элементом Axes следует элемент CellData, который представляет собой коллекцию элементов Cell, в которых содержатся значения свойств для каждой ячейки, возвращенной в многомерном наборе данных. Элемент Cell содержит атрибут CellOrdinal, который определяет порядковый номер, начиная с нуля, ячейки в многомерном наборе данных, и один элемент для каждого значения свойства ячейки, связанного с ячейкой. Каждое значение свойства ячейки в элементе Cell определяется отдельным XML-элементом. Значение свойства ячейки — это данные, содержащиеся в XML-элементе, а имя свойства ячейки, как оно определено в элементе CellInfo родительского корневого элемента, соответствует имени XML-элемента.

Ниже представлен синтаксис записи значения свойства ячейки.

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

Тип данных для значения свойства ячейки указывается только для свойства ячейки VALUE. Типы данных для других свойств ячейки задаются в определении свойства ячейки, включенного в элемент CellInfo. Элемент значения свойства ячейки можно исключить, если указано значение по умолчанию (когда элемент Default включен в определение свойства ячейки, содержащееся в элементе CellInfo) или если значение по умолчанию не указано и значение свойства ячейки равно 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, для верхней левой ячейки.

Применяя формулу, показанную на рисунке, получим, что ось при k = 0 содержит Uk = 4 элемента, а ось при k = 1 содержит Uk = 8 кортежей. P = 2 — число осей в запросе. Если принять ячейку {Калифорния, К3, Стоимость хранения} за S0, начальная сумма будет равна i = 0 до 1. При i = 0 порядковый номер кортежа на оси 0 для столбца {Стоимость хранения} равен 1. При i = 1 порядковый номер кортежа для {Калифорния, К3} равен 2.

При i = 0 Ei = 1, поэтому при i = 0 сумма равна 1 * 1 = 1, а при i = 1 сумма равна 2 (порядковый номер кортежа) умножить на 4 (значение Ei вычисляется как 1 * 4), то есть 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 (XML для аналитики)

Основные понятия

Свойства (XML для аналитики)