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

Статья
08/01/2012

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

Синтаксис

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

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

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

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

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

Атрибуты

AllowCreate

Необязательный атрибут типа Boolean. Показывает, необходимо ли создавать объекты, определенные в команде Alter, если их не существует.

Если установлено значение true, то объекты, определенные в элементе ObjectDefinition, будут созданы экземпляром служб Службы Analysis Services (в том случае, если они не существуют). Другими словами, если в экземпляре не существует нужных объектов, команда Alter обрабатывается точно так же, как и команда Create.

Если для этого атрибута не было задано значение или было задано значение false, то в том случае, если объектов не существует, будет возвращена ошибка.

ObjectExpansion

Необязательный атрибут типа Enum. Определяет масштаб изменений, которые будут произведены методом Execute.

Если установлено значение ObjectProperties, элемент ObjectDefinition должен содержать только полное описание изменяемого главного объекта, включающее описания подчиненных ему второстепенных объектов. Подчиненные главные объекты изменяемого объекта затронуты не будут.

Примечание
Если используется параметр ObjectProperties с типом данных ClrAssembly, то указывать элемент Data связанных с ним типов данных ClrAssemblyFile необязательно. Если параметр не указан, то ClrAssembly использует существующие файлы.

Если установлено значение ExpandFull, то в элементе ObjectDefinition должно содержаться не только определение изменяемого объекта, но и определения всех главных объектов, являющихся его потомками.

Примечание
Параметр ExpandFull не может использоваться совместно с элементом Server.

Scope

Необязательный атрибут типа Enum. Определяет срок жизни объектов, определенных в элементе ObjectDefinition.

Если установлено значение Session, то объекты, определенные в элементе ObjectDefinition, будут существовать только в течение сеанса XMLA.

Примечание
При использовании параметра Session элемент ObjectDefinition может содержать только следующие элементы языка ASSL: Dimension, Cube или MiningModel.

Если этот атрибут опускается, объекты, определенные в элементе ObjectDefinition, сохраняются в экземпляре служб Службы Analysis Services.

Замечания

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

См. также

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

Команды (XMLA)

Share via