Elemento Create (XMLA)

  • Artigo

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>