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

Содержит Analysis Services элементы языка ASSL, используемые методом EXECUTE для изменения объектов в экземпляре Analysis Services.

Синтаксис

  
<Command>  
   <Alter Scope="enum" AllowCreate="boolean" ObjectExpansion="enum">  
      <Object>...</Object>  
      <ObjectDefinition>...</ObjectDefinition>  
   </Alter>  
</Command>  

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

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

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

Связь	Элемент
Родительские элементы	Команда
Дочерние элементы	Object, ObjectDefinition

Атрибуты

Атрибут	Описание
AllowCreate	Необязательный атрибут типа Boolean . Показывает, необходимо ли создавать объекты, определенные в команде Alter , если их не существует. Если задано значение true, объекты, определенные в элементе ObjectDefinition , создаются на Analysis Servicesном экземпляре, если они еще не существуют. Другими словами, если в экземпляре не существует нужных объектов, команда Alter обрабатывается точно так же, как и команда Create . Если для этого атрибута не было задано значение или было задано значение false, то в том случае, если объектов не существует, будет возвращена ошибка.
ObjectExpansion	Необязательный атрибут типа Enum . Определяет масштаб изменений, которые будут произведены методом Execute . Если установлено значение ObjectProperties, элемент ObjectDefinition должен содержать только полное описание изменяемого главного объекта, включающее описания подчиненных ему второстепенных объектов. Подчиненные главные объекты изменяемого объекта затронуты не будут. Примечание. при использовании параметра ObjectProperties с типом данных ClrAssembly не нужно указывать элемент данных связанных типов данных ClrAssemblyFile . Если параметр не указан, то ClrAssembly использует существующие файлы. Если установлено значение ExpandFull, то в элементе ObjectDefinition должно содержаться не только определение изменяемого объекта, но и определения всех главных объектов, являющихся его потомками. Примечание. параметр ExpandFull не может использоваться с элементом Server .
Область	Необязательный атрибут типа Enum . Определяет срок жизни объектов, определенных в элементе ObjectDefinition . Если установлено значение Session, то объекты, определенные в элементе ObjectDefinition , будут существовать только в течение сеанса XMLA. Примечание. при использовании параметра сеанса элемент ObjectDefinition может содержать только элементы ASSL измерения, Кубыи MiningModel . Если этот атрибут пропущен, объекты, определенные в элементе ObjectDefinition , сохраняются в экземпляре Analysis Services.

Комментарии

Каждая команда Alter изменяет определение одного главного объекта, подчиняющегося родительскому объекту, заданному в элементе ParentObject .