Compartir a través de


Elemento Create (XMLA)

Contiene elementos del Lenguaje de scripts de Analysis Services (ASSL) utilizados por el método Execute para crear objetos en una instancia de Microsoft SQL Server Analysis Services.

Sintaxis

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

Características del elemento

Característica

Descripción

Tipo y longitud de los datos

Ninguno

Valor predeterminado

Ninguno

Cardinalidad

0-n: Elemento opcional que puede aparecer más de una vez.

Relaciones del elemento

Relación

Elemento

Elementos primarios

Command

Elementos secundarios

ObjectDefinition, ParentObject

Atributos

Attribute

Descripción

AllowOverwrite

Atributo Boolean opcional. Si está establecido en True, los objetos definidos en el elemento ObjectDefinition pueden sobrescribir objetos existentes en la instancia de Analysis Services. Si este atributo se omite o se establece en False, la presencia de un objeto existente genera un error.

Scope

Atributo Enum opcional. Define la duración de objetos definidos en el elemento ObjectDefinition. Si se omite este atributo, los objetos definidos en el elemento ObjectDefinition se almacenan en la instancia de Analysis Services. Dispone de los siguientes valores:

  • Session

    Los objetos definidos en el elemento ObjectDefinition sólo existen mientras dura la sesión de XML for Analysis (XMLA).

    NotaNota
    Si se utiliza el valor Session, el elemento ObjectDefinition sólo puede contener elementos ASSL Dimension, Cube o MiningModel.

Comentarios

Cada operación Create crea un objeto principal bajo un elemento primario proporcionado por el elemento ParentObject. Si se omite el objeto primario, se asume que es la instancia de Analysis Services de destino. Esto genera un error si el elemento primario de un objeto principal no es la instancia de destino.

Ejemplo

En el siguiente ejemplo se crea una base de datos vacía denominada Test Database en una instancia de Analysis Services.

        <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>

Vea también

Conceptos