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

Статья
08/01/2012

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

Синтаксис

<Command>
   <Create Scope="enum" AllowOverwrite="boolean">
      <ParentObject>...</ParentObject>
      <ObjectDefinition>...</ObjectDefinition>
   </Create>
</Command>

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

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

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

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

Атрибуты

AllowOverwrite

Необязательный атрибут типа Boolean. Если имеет значение True, объекты, определенные в элементе ObjectDefinition, могут заменять существующие объекты в экземпляре служб Службы Analysis Services. Если этот атрибут пропущен или имеет значение False, то при наличии существующего объекта возникает ошибка.

Scope

Необязательный атрибут типа Enum. Определяет срок жизни объектов, определенных в элементе ObjectDefinition. Если этот атрибут опускается, объекты, определенные в элементе ObjectDefinition, сохраняются в экземпляре служб Службы Analysis Services. Доступны следующие значения:

Session

Объекты, определенные в элементе ObjectDefinition, существуют только во время сеанса XML для аналитики (XMLA).

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

Замечания

Каждая операция Create создает для родительского объекта, указанного в элементе ParentObject, один главный объект. Если родительский элемент пропущен, предполагается, что им является целевой экземпляр служб Службы Analysis Services. Если родитель главного объекта не является целевым экземпляром, возникает ошибка.

Пример

В следующем примере в экземпляре служб Службы Analysis Services создается пустая база данных с именем Test Database.

<Create xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">
   <ObjectDefinition>
      <Database xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
         <Name>Test Database</Name>
         <Description>A test database.</Description>
      </Database>
   </ObjectDefinition>
</Create>

См. также

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

Команды (XMLA)

Поделиться через