Статья
04/01/2012

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

Содержит элементы 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.

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)

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