Elemento Create (XMLA)

Contém elementos ASSL (linguagem de script de Analysis Services) usados pelo método Execute para criar objetos em uma instância de Analysis Services.

Syntax

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

Características do elemento

Característica	Descrição
Comprimento e tipo de dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-n: Elemento opcional que pode ocorrer mais de uma vez.

Relações de elementos

Relação	Elemento
Elementos pai	Comando
Elementos filho	ObjectDefinition, ParentObject

Atributos

Atributo	Descrição
AllowOverwrite	Atributo Boolean opcional. Se definido como true, os objetos definidos no elemento ObjectDefinition poderão substituir os objetos existentes na instância de Analysis Services. Se esse atributo for omitido ou definido como False, a presença de um objeto existente gerará um erro.
Escopo	Atributo Enum opcional. Define a duração de objetos definida no elemento ObjectDefinition . Se esse atributo for omitido, os objetos definidos no elemento ObjectDefinition serão persistidos na instância de Analysis Services. O seguinte valor está disponível: Sessão: os objetos definidos no elemento ObjectDefinition existem somente pela duração da sessão XML for Analysis (XMLA). Observe que, ao usar a configuração de sessão , o elemento ObjectDefinition só pode conter elementos de dimensão, cuboou MiningModel ASSL.

Comentários

Cada operação Create cria um objeto principal sob um pai fornecido pelo elemento ParentObject . Se o objeto pai for omitido, ele será considerado como a instância de Analysis Services de destino. Isso gerará um erro se o pai de um objeto principal não for a instância de destino.

Exemplo

O exemplo a seguir cria um banco de dados vazio chamado banco de dados de teste em uma instância de Analysis Services.

  
      <Create xmlns="http://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>