Inserimento, aggiornamento ed eliminazione di membri (XMLA)

È possibile utilizzare i comandi Insert, Update e Drop in XML for Analysis (XMLA) rispettivamente per inserire, aggiornare o eliminare membri da una dimensione abilitata per la scrittura. Per altre informazioni sulle dimensioni abilitate per la scrittura, vedere Write-Enabled Dimensioni.

Inserimento di nuovi membri

Il Insert comando inserisce nuovi membri in attributi specificati in una dimensione abilitata per la scrittura.

Prima di costruire il Insert comando, è necessario disporre delle informazioni seguenti per i nuovi membri da inserire:

• Dimensione in cui inserire i nuovi membri.

• Attributo della dimensione in cui inserire i nuovi membri.

• Nomi dei nuovi membri, incluse eventuali traduzioni applicabili per il nome.

• Chiavi dei nuovi membri. Se un attributo usa una chiave composta, la chiave potrebbe richiedere più valori.

• Valori per le proprietà di attributo applicabili che non vengono implementate come altri attributi all'interno della dimensione. Tali proprietà di attributo includono operazioni unarie, traduzioni, rollup personalizzati, proprietà di rollup personalizzate e livelli ignorati.

Il Insert comando accetta solo due proprietà:

• Proprietà Object , che contiene un riferimento all'oggetto per la dimensione in cui devono essere inseriti i membri. Il riferimento all'oggetto contiene l'identificatore del database, l'identificatore del cubo e l'identificatore di dimensione per la dimensione.

• Proprietà Attributes , che contiene uno o più elementi Attribute per identificare gli attributi in cui devono essere inseriti i membri. Ogni Attribute elemento identifica un attributo e fornisce il nome, il valore, le traduzioni, l'operatore unario, il rollup personalizzato, le proprietà di rollup personalizzate e i livelli ignorati per aggiungere un singolo membro all'attributo identificato.

  Annotazioni

  Tutte le proprietà per l'elemento Attribute devono essere incluse. In caso contrario, potrebbe verificarsi un errore.

Aggiornamento dei membri esistenti

Il Update comando aggiorna i membri esistenti negli attributi specificati, in base alle relazioni con altri membri in altri attributi, in una dimensione abilitata per la scrittura. Il Update comando può spostare membri in altri livelli nelle gerarchie contenute nella dimensione e può essere utilizzato per ristrutturare le gerarchie padre-figlio definite dagli attributi padre.

Prima di costruire il Update comando, è necessario disporre delle informazioni seguenti disponibili per l'aggiornamento dei membri:

• Dimensione in cui aggiornare i membri esistenti.

• Attributi della dimensione in cui aggiornare i membri esistenti.

• Chiavi dei membri esistenti. Se un attributo usa una chiave composta, la chiave potrebbe richiedere più valori.

• Valori per le proprietà di attributo applicabili che non vengono implementate come altri attributi all'interno della dimensione. Tali proprietà di attributo includono operazioni unarie, traduzioni, rollup personalizzati, proprietà di rollup personalizzate e livelli ignorati.

Il Update comando accetta solo tre proprietà obbligatorie:

• Proprietà Object contenente un riferimento all'oggetto per la dimensione in cui aggiornare i membri. Il riferimento all'oggetto contiene l'identificatore del database, l'identificatore del cubo e l'identificatore di dimensione per la dimensione.

• Proprietà Attributes che contiene uno o più Attribute elementi per identificare gli attributi in cui aggiornare i membri. L'elemento Attribute identifica un attributo e fornisce il nome, il valore, le traduzioni, l'operatore unario, il rollup personalizzato, le proprietà di rollup personalizzate e i livelli ignorati per un singolo membro aggiornato per l'attributo identificato.

  Annotazioni

  Tutte le proprietà per l'elemento Attribute devono essere incluse. In caso contrario, potrebbe verificarsi un errore.

• Proprietà Where , che contiene uno o più Attribute elementi che vincolano gli attributi in cui devono essere aggiornati i membri. La Where proprietà è fondamentale per limitare un Update comando a istanze specifiche di un membro. Se la Where proprietà non viene specificata, vengono aggiornate tutte le istanze di un determinato membro. Ad esempio, ci sono tre clienti per i quali vuoi cambiare il nome della città da Redmond a Bellevue. Per modificare il nome della città, è necessario specificare una Where proprietà che identifica i tre membri nell'attributo Customer per cui devono essere modificati i membri dell'attributo City. Se non si specifica questa Where proprietà, ogni cliente il cui nome della città è attualmente Redmond avrà il nome della città di Bellevue dopo l'esecuzione del Update comando.

  Annotazioni

  Ad eccezione dei nuovi membri, il Update comando può aggiornare solo i valori di chiave dell'attributo per gli attributi non inclusi nella Where clausola . Ad esempio, il nome della città non può essere aggiornato quando un cliente viene aggiornato; in caso contrario, il nome della città viene modificato per tutti i clienti.

Aggiornamento dei membri negli attributi padre

Per supportare gli attributi padre, il Update comando le proprietà MoveWithDescendants MovewithDescedantsfacoltative. L'impostazione della MoveWithDescendants proprietà su true indica che anche i discendenti del membro padre devono essere spostati con il membro padre quando viene modificato l'identificatore del membro padre. Se questo valore è impostato su false, lo spostamento di un membro padre determina la promozione dei discendenti immediati di tale membro padre al livello in cui si trova in precedenza il membro padre.

Quando si aggiornano i membri in un attributo padre, il Update comando non può aggiornare i membri in altri attributi.

Eliminazione di membri esistenti

Prima di costruire il Drop comando, è necessario disporre delle informazioni seguenti per i membri da eliminare:

• Dimensione in cui eliminare i membri esistenti.

• Attributi della dimensione in cui eliminare i membri esistenti.

• Chiavi dei membri esistenti da eliminare. Se un attributo usa una chiave composta, la chiave potrebbe richiedere più valori.

Il Drop comando accetta solo due proprietà obbligatorie:

• Proprietà Object che contiene un riferimento all'oggetto per la dimensione in cui devono essere eliminati i membri. Il riferimento all'oggetto contiene l'identificatore del database, l'identificatore del cubo e l'identificatore di dimensione per la dimensione.

• Proprietà Where che contiene uno o più Attribute elementi per vincolare gli attributi in cui eliminare i membri. La Where proprietà è fondamentale per limitare un Drop comando a istanze specifiche di un membro. Se il Where comando non viene specificato, vengono eliminate tutte le istanze di un determinato membro. Ad esempio, ci sono tre clienti che si vogliono eliminare da Redmond. Per eliminare questi clienti, è necessario fornire una Where proprietà che identifica i tre membri nell'attributo Customer da rimuovere e il membro Redmond dell'attributo City da cui rimuovere i tre clienti. Se la Where proprietà specifica solo il membro Redmond dell'attributo City, ogni cliente associato a Redmond verrà eliminato dal Drop comando . Se la Where proprietà specifica solo i tre membri nell'attributo Customer, i tre clienti verranno eliminati interamente dal Drop comando.

  Annotazioni

  Gli Attribute elementi inclusi in un Drop comando devono contenere solo le AttributeName proprietà e Keys . In caso contrario, potrebbe verificarsi un errore.

Eliminazione di membri negli attributi padre

L'impostazione della proprietà DeleteWithDescendants indica che anche i discendenti di un membro padre devono essere eliminati con il membro padre. Se questo valore è impostato su false, i discendenti immediati del membro padre vengono invece alzati di livello al livello in cui risiedeva il membro padre in precedenza.

Importante

Un utente deve disporre solo delle autorizzazioni di eliminazione per il membro padre per eliminare sia il membro padre che i relativi discendenti. Un utente non ha bisogno di autorizzazioni di eliminazione per i discendenti.

Vedere anche

Elemento Drop (XMLA)
Elemento Insert (XMLA)
Elemento Update (XMLA)
Definizione e identificazione di oggetti (XMLA)
Sviluppo con XMLA in Analysis Services