Share via

  • Статья

Элемент 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.

Замечания

Каждая операция 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)