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

Содержит набор кортежей, используемых для представления единственной оси в многомерном наборе данных, содержащемся в элементе Axes, в котором используется тип данных MDDataSet, возвращаемый методом Execute.

Синтаксис

<Axes>
   ...
   <Axis> <!-- when AxisFormat XMLA property is set to ClusterFormat -->
      <CrossProduct>...</CrossProduct>
   </Axis>
   <Axis> <!-- when AxisFormat XMLA property is set to TupleFormat or CustomFormat -->
      <Tuples>...</Tuples>
   </Axis>
   ...
</Axes>

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

Характеристика	Описание
Тип данных и длина	нет
Значение по умолчанию	Нет
Количество элементов	От 0 до n: необязательный элемент, который может встречаться несколько раз.

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

Связь	Элемент
Родительские элементы	Axes
Дочерние элементы	CrossProduct или Tuples

Замечания

Содержимое элемента Axis изменяется в зависимости от значения свойства XMLA AxisFormat, используемого методом Execute.

TupleFormat

Когда клиентское приложение устанавливает для свойства AxisFormat значение TupleFormat, ось представляется в виде набора кортежей. Каждый элемент Axis содержит элемент Tuples, который представляет множество кортежей на этой оси. Каждый кортеж представляется с помощью элемента Tuple, который содержит элементы Member из каждой иерархии на оси.

ClusterFormat

Когда клиентское приложение устанавливает для свойства AxisFormat значение ClusterFormat, элементы на каждой оси разделяются на кластеры, где каждый кластер представляет перекрестное произведение упорядоченных множеств элементов из каждой иерархии. Каждый элемент Axis состоит из одного или нескольких элементов CrossProduct. Каждый элемент CrossProduct содержит элемент Members из каждой иерархии на оси.

CustomFormat

Если в клиентском приложении свойству AxisFormat присваивается значение CustomFormat, это значение рассматривается наравне со значением TupleFormat в экземпляре служб Analysis Services.

Примеры

Описание

В следующем примере иллюстрируется структура элементов Axis, при условии, что в клиенте определяется значение TupleFormat или CustomFormat для свойства XMLA AxisFormat с учетом наличия следующих элементов для оси:

Иерархия Time	1999	1999	2000
Иерархия Category	Actual	Budget	Budget

Код

<Axes>
   <Axis name="Axis0">
      <Tuples>
         <Tuple>
            <Member Hierarchy="Time">
               <UName>[Time].[1999]</UName>
               ...
            </Member>
            <Member Hierarchy="Category">
               <UName>[Scenario].[Actual]</UName>
               ...
            </Member>
         </Tuple>
         <Tuple>
            <Member Hierarchy="Time">
               <UName>[Time].[1999]</UName>
               ...
            </Member>
            <Member Hierarchy="Category">
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Tuple>
         <Tuple>
            <Member Hierarchy="Time">
               <UName>[Time].[2000]</UName>
               ...
            </Member>
            <Member Hierarchy="Category">
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Tuple>
      </Tuples>
   </Axis>
   ...
</Axes>

Описание

В следующем примере иллюстрируется структура элементов Axis, при условии, что в клиенте определяется значение ClusterFormat для свойства XMLA AxisFormat с учетом наличия следующих элементов для оси:

Иерархия Time	1999	1999	2000	2001
Иерархия Category	Actual	Budget	Budget	Budget
Кластеры	Кластер 1	Кластер 1	Кластер 1	Кластер 2

Код

<Axes>
   <Axis name="Axis0">
      <CrossProduct Size = "4">
         <Members Hierarchy="Time">
            <Member>
               <UName>[Time].[1999]</UName>
               ...
            </Member>
            <Member>
               <UName>[Time].[2000]</UName>
               ...
            </Member>
         </Members>
         <Members Hierarchy="Category">
            <Member>
               <UName>[Scenario].[Actual]</UName>
               ...
            </Member>
            <Member>
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Members>
      </CrossProduct>
      <CrossProduct Size = "1">
         <Members Hierarchy="Time">
            <Member>
               <UName>[Time].[2001]</UName>
               ...
            </Member>
         </Members>
         <Members Hierarchy="Category">
            <Member>
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Members>
      </CrossProduct>
   </Axis>
   ...
</Axes>

См. также

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

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