Elemento Create (XMLA)

  • Artigo

Contém elementos ASSL (Analysis Services Scripting Language) usados pelo método Execute para criar objetos em uma instância Microsoft SQL Server Analysis Services.

Sintaxe

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

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 podem substituir existindo objetos na instância 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 este atributo for omitido, os objetos definidos no elemento ObjectDefinition persistirão na instância Analysis Services. Os seguintes valores estão disponíveis:

  • Session

    Os objetos definidos no elemento ObjectDefinition só existem para a duração da sessão XMLA (XML for Analysis).

    ObservaçãoObservação

    Ao usar a configuração Session, o elemento ObjectDefinition só pode conter os elementos Dimension, Cubeou MiningModel de ASSL.

Comentários

Cada operação Create cria um objeto principal sob um pai fornecido pelo elemento ParentObject. Se o objeto pai for omitido, será considerada a instância de destino Analysis Services. 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 Test Database em uma instância 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>

Consulte também

Conceitos

Commands (XMLA)