Elemento Create (XMLA)

Contiene elementi ASSL (Analysis Services Scripting Language) utilizzati dal metodo Execute per creare oggetti su un'istanza MicrosoftSQL ServerAnalysis Services.

Sintassi

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

Caratteristiche elemento

Caratteristica	Descrizione
Tipo di dati e lunghezza	Nessuno
Valore predefinito	Nessuno
Cardinalità	0-n: Elemento facoltativo che può presentarsi più di una volta.

Relazioni elemento

Relazione	Elemento
Elementi padre	Command
Elementi figlio	ObjectDefinition, ParentObject

Attributi

Attributo	Descrizione
AllowOverwrite	Attributo Boolean facoltativo. Se è impostato a Vero, gli oggetti definiti nell'elemento ObjectDefinition possono sovrascrivere oggetti esistenti sull'istanza Analysis Services. Se questo attributo è omesso o impostato a Falso, la presenza di un oggetto esistente genera un errore.
Ambito	Attributo Enum facoltativo. Definisce la durata degli oggetti definiti nell'elemento ObjectDefinition. Se questo attributo viene omesso, gli oggetti definiti nell'elemento ObjectDefinition vengono salvati in modo permanente sull'istanza Analysis Services. Sono disponibili i valori seguenti. Session Gli oggetti definiti nell'elemento ObjectDefinition esistono solo per la durata della sessione di XML for Analysis (XMLA). Nota In caso di utilizzo dell'impostazione Session, l'elemento ObjectDefinition può contenere solo Dimension, Cube o MiningModel elementi ASSL.

Osservazioni

Ogni operazione Create crea un oggetto principale sotto un padre fornito dall'elemento ParentObject. Se l'oggetto padre viene omesso, si presuppone che sia l'istanza Analysis Services di destinazione. Questo genera un errore se il padre di un oggetto principale non è l'istanza di destinazione.

Esempio

Nell'esempio seguente viene illustrata la creazione di un database vuoto denominato Test Database in un'istanza di 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>

Vedere anche

Concetti

Comandi (XMLA)