Elemento Create (XMLA)

Articolo
05/08/2023

Contiene Analysis Services ASSL (Analysis Services Scripting Language) utilizzati dal metodo Execute per creare oggetti in un'Analysis Services istanza di .

Sintassi

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

Caratteristiche degli elementi

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

Relazioni tra elementi

Relazione	Elemento
Elementi padre	Comando
Elementi figlio	ObjectDefinition, ParentObject

Attributi

Attributo	Descrizione
AllowOverwrite	Attributo Boolean facoltativo. Se impostato su True, gli oggetti definiti nell'elemento ObjectDefinition possono sovrascrivere gli oggetti esistenti nell Analysis Services istanza. Se questo attributo è omesso o impostato a Falso, la presenza di un oggetto esistente genera un errore.
Scope	Attributo Enum facoltativo. Definisce la durata degli oggetti definiti nell'elemento ObjectDefinition . Se questo attributo viene omesso, gli oggetti definiti nell'elemento ObjectDefinition vengono resi persistenti nell Analysis Services istanza. È disponibile il valore seguente: Sessione: gli oggetti definiti nell'elemento ObjectDefinition esistono solo per la durata della sessione XML for Analysis (XMLA). Si noti che quando si usa l'impostazione Session , l'elemento ObjectDefinition può contenere solo elementi ASSL Dimension, Cube o MiningModel .

Attributo

Descrizione

AllowOverwrite

Attributo Boolean facoltativo. Se impostato su True, gli oggetti definiti nell'elemento ObjectDefinition possono sovrascrivere gli oggetti esistenti nell Analysis Services istanza. Se questo attributo è omesso o impostato a Falso, la presenza di un oggetto esistente genera un errore.

Scope

Attributo Enum facoltativo. Definisce la durata degli oggetti definiti nell'elemento ObjectDefinition . Se questo attributo viene omesso, gli oggetti definiti nell'elemento ObjectDefinition vengono resi persistenti nell Analysis Services istanza. È disponibile il valore seguente:

Sessione: gli oggetti definiti nell'elemento ObjectDefinition esistono solo per la durata della sessione XML for Analysis (XMLA).
Si noti che quando si usa l'impostazione Session , l'elemento ObjectDefinition può contenere solo elementi ASSL Dimension, Cube o MiningModel .

Commenti

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

Esempio

Nell'esempio seguente viene creato un database vuoto denominato Test Database in un'istanza Analysis Services database .

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

Condividi tramite