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 comando Inserisci inserisce nuovi membri negli attributi specificati in una dimensione abilitata per la scrittura.

Prima di costruire il comando Inserisci , è 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.

• Le 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 comando Inserisci 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 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 da aggiungere 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 comando Update 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 comando Update può spostare i 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 comando Update , è 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.

• Le 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 comando Update accetta solo tre proprietà obbligatorie:

• Proprietà Object , che contiene un riferimento all'oggetto per la dimensione in cui devono essere aggiornati 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 aggiornati 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.

• La proprietà Where , che contiene uno o più elementi Attribute che vincolano gli attributi in cui devono essere aggiornati i membri. La proprietà Where è fondamentale per limitare un comando Update a istanze specifiche di un membro. Se la proprietà Where non viene specificata, tutte le istanze di un determinato membro vengono aggiornate. 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 proprietà Where che identifica i tre membri nell'attributo Customer per cui devono essere modificati i membri dell'attributo City. Se non si specifica questa proprietà Where , ogni cliente il cui nome di città è attualmente Redmond avrà il nome della città di Bellevue dopo l'esecuzione del comando Update .

  Annotazioni

  Ad eccezione dei nuovi membri, il comando Update può aggiornare solo i valori di chiave dell'attributo per gli attributi non inclusi nella clausola Where . 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 comando Aggiorna le proprietà MoveWithDescendants MovewithDescedantsfacoltative. L'impostazione della proprietà MoveWithDescendants su true indica che anche i discendenti del membro padre devono essere spostati con il membro padre quando l'identificatore di tale membro padre cambia. 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 comando Update non può aggiornare i membri in altri attributi.

Eliminazione di membri esistenti

Prima di costruire il comando Drop , è 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 comando Drop 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.

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

  Annotazioni

  Gli elementi Attribute inclusi in un comando Drop devono contenere solo le proprietà AttributeName 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.

Vedere anche

Elemento Rimozione (XMLA)
Inserisci Elemento (XMLA)
Elemento di aggiornamento (XMLA)
Definizione e identificazione di oggetti (XMLA)
Sviluppo con XMLA in Analysis Services