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). Nota 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

Comandos (XMLA)