Artigo
09/28/2010

Elemento Create (XMLA)

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

Sintaxe

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

Características do elemento

Característica	Descrição
Tipo de dados e comprimento	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	Command
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ção Ao usar a configuração Session, o elemento ObjectDefinition só pode conter os elementos Dimension, Cubeou MiningModel de ASSL.

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çã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)

Compartilhar via