Condividi tramite


Elemento Create (XMLA)

Contiene elementi ASSL (Analysis Services Scripting Language) utilizzati dal metodo Execute per creare oggetti in un'istanza Microsoft SQL Server Analysis 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ò ricorrere più di una volta.

Relazioni elemento

Relazione

Elemento

Elementi padre

Command

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