Статья
09/28/2010

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

Содержит элементы ASSL, используемые методом Execute для создания объектов в экземпляре служб MicrosoftSQL ServerAnalysis 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)

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