Inserimento, aggiornamento ed eliminazione di membri (XMLA)
È possibile usare i comandi Insert, Update ed 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 Dimensioni abilitate per la scrittura.
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 Insert , per i nuovi membri da inserire dovrebbero essere disponibili le informazioni seguenti:
Dimensione in cui inserire i nuovi membri.
Attributo della dimensione in cui inserire i nuovi membri.
Nomi dei nuovi membri, inclusa qualsiasi conversione applicabile per il nome.
Chiavi dei nuovi membri. Se un attributo utilizza una chiave composta, per la chiave può essere necessario utilizzare più valori.
Valori per tutte le proprietà dell'attributo applicabili non implementate come altri attributi nella dimensione. Tali proprietà includono operazioni unarie, conversioni, rollup personalizzati e relative proprietà 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 di database, l'identificatore di 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.
Nota
Tutte le proprietà per l'elemento Attribute devono essere incluse. In caso contrario, è possibile che si verifichi un errore.
Aggiornamento di 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 usato per ristrutturare le gerarchie padre-figlio definite dagli attributi padre.
Prima di costruire il comando Update , è necessario avere a disposizione le informazioni seguenti 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 utilizza una chiave composta, per la chiave può essere necessario utilizzare più valori.
Valori per tutte le proprietà dell'attributo applicabili non implementate come altri attributi nella dimensione. Tali proprietà includono operazioni unarie, conversioni, rollup personalizzati e relative proprietà 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 di database, l'identificatore di 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.
Nota
Tutte le proprietà per l'elemento Attribute devono essere incluse. In caso contrario, è possibile che si verifichi 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 è specificata, vengono aggiornate tutte le istanze di un determinato membro. Si supponga ad esempio che siano presenti tre clienti per cui si desidera modificare il nome di città da Redmond in 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 nell'attributo City. Se non si specifica questa proprietà Where , ogni cliente il cui nome della città è attualmente Redmond avrebbe il nome della città di Bellevue dopo l'esecuzione del comando Update.
Nota
Ad eccezione dei nuovi membri, il comando Update può aggiornare solo i valori della chiave dell'attributo per gli attributi non inclusi nella clausola Where . Quando ad esempio viene aggiornato un cliente, il relativo nome di città non può essere aggiornato. In caso contrario, il nome di città viene modificato per tutti i clienti.
Aggiornamento di membri in attributi padre
Per supportare gli attributi padre, il comando Update consente di impostare le proprietà MoveWithDescendantsMovewithDescedants facoltative. L'impostazione della proprietà MoveWithDescendants 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 comporta la promozione dei relativi discendenti immediati al livello in cui il membro padre si trovava in precedenza.
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 avere a disposizione le 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 utilizza una chiave composta, per la chiave può essere necessario utilizzare 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 di database, l'identificatore di 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 è specificato, tutte le istanze di un determinato membro vengono eliminate. Si supponga ad esempio che siano presenti tre clienti che si desidera eliminare da Redmond. Per eliminare questi clienti, è necessario specificare 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 .
Nota
Gli elementi Attribute inclusi in un comando Drop devono contenere solo le proprietà AttributeNamee Keys . In caso contrario, è possibile che si verifichi un errore.
Eliminazione di membri in 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 promossi al livello in cui il membro padre si trovava in precedenza.
Importante
Per eliminare sia il membro padre che i relativi discendenti, è sufficiente che un utente disponga delle autorizzazioni per l'eliminazione del solo membro padre e non è necessario che disponga delle autorizzazioni per l'eliminazione dei discendenti.
Vedere anche
Elemento Drop (XMLA)
Elemento Insert (XMLA)
Elemento Update (XMLA)
Definizione e identificazione di oggetti (XMLA)
Sviluppo con XMLA in Analysis Services