Istruzione CREATE SET (MDX)
Crea un set denominato con ambito sessione per il cubo corrente.
Sintassi
CREATE [SESSION] [ STATIC | DYNAMIC ] [HIDDEN] SET
CURRENTCUBE | Cube_Name
.Set_Name AS 'Set_Expression'
[,Property_Name = Property_Value, ...n]
Argomenti
Cube_Name
Espressione stringa valida che specifica il nome del cubo.Set_Name
Espressione stringa valida che specifica il nome del set denominato che viene creato.Set_Expression
Espressione MDX (Multidimensional Expression) valida che restituisce un set.Property_Name
Stringa valida che fornisce il nome di una proprietà del set.Property_Value
Espressione scalare valida che definisce il valore della proprietà del set.
Osservazioni
Un set denominato è un set di membri di dimensioni, o un'espressione che definisce un set, che è possibile creare per un riutilizzo successivo. Un set denominato, ad esempio, consente di definire un set di membri di dimensione costituito dal set dei primi dieci punti vendita per fatturato. È possibile definire il set in modo statico o mediante una funzione, ad esempio TopCount. Il set denominato potrà quindi essere utilizzato ogni volta che sarà necessario recuperare il set dei primi 10 punti vendita.
L'istruzione CREATE SET crea un set denominato che rimane disponibile per tutta la sessione e può pertanto essere utilizzato in più query durante la sessione. Per ulteriori informazioni, vedere Creazione di membri calcolati con ambito sessione (MDX).
È inoltre possibile definire un set denominato da utilizzare in un'unica query. Per definire un set di questo tipo, utilizzare la clausola WITH nell'istruzione SELECT. Per ulteriori informazioni sulla clausola WITH, vedere Creazione di set denominati con ambito query (MDX).
La clausola Set_Expression può contenere qualsiasi funzione che supporta la sintassi MDX. L'ambito dei set creati con l'istruzione CREATE SET che non specificano la clausola SESSION è sessione. Utilizzare la clausola WITH per creare un set con ambito query.
Specificando un cubo diverso dal cubo connesso viene generato un errore. Pertanto, per identificare il cubo corrente è consigliabile utilizzare CURRENTCUBE anziché il nome di un cubo.
Ambito
Un set definito dall'utente può trovarsi all'interno di uno degli ambiti elencati nella tabella seguente.
Ambito query
La visibilità e la durata del set sono limitate alla query. Il set è definito in un'unica query. L'ambito query prevale sull'ambito sessione. Per ulteriori informazioni, vedere Creazione di set denominati con ambito query (MDX).Ambito sessione
La visibilità e la durata del set sono limitate alla sessione in cui è stato creato. La durata è inferiore alla durata della sessione se viene utilizzata l'istruzione DROP SET sul set. L'istruzione CREATE SET crea un set con ambito sessione. Utilizzare la clausola WITH per creare un set con ambito query.
Esempio
Nell'esempio seguente viene creato un set denominato Core Products. Mediante la query SELECT viene quindi illustrata la chiamata del set appena creato. Affinché possa essere eseguita la query SELECT, è necessario che sia stata innanzitutto eseguita l'istruzione CREATE SET. Non possono essere eseguite nello stesso batch.
CREATE SET [Adventure Works].[Core Products] AS '{[Product].[Category].[Bikes]}'
SELECT [Core Products] ON 0
FROM [Adventure Works]
Valutazione del set
La valutazione del set può essere definita in diversi modi: può essere definita per essere eseguita solo una volta alla creazione del set oppure per essere eseguita ogni volta che il set viene utilizzato.
STATIC
Indica che il set viene valutato solo al momento della valutazione dell'istruzione CREATE SET.DYNAMIC
Indica che il set deve essere valutato tutte le volte che viene utilizzato in una query.
Visibilità del set
Il set può essere o meno visibile agli altri utenti che eseguono la query sul cubo.
- HIDDEN
Specifica che il set non è visibile agli utenti che eseguono una query sul cubo.
Proprietà standard
Ogni set presenta un set di proprietà predefinite. Quando un'applicazione client viene connessa a Microsoft Analysis Services, l'amministratore può scegliere se le proprietà predefinite sono supportate o disponibili per essere supportate.
Identificatore proprietà |
Descrizione |
|---|---|
CAPTION |
Una stringa che l'applicazione client utilizza come didascalia per il set. |
DISPLAY_FOLDER |
Stringa che identifica il percorso della cartella di visualizzazione utilizzata dall'applicazione client per visualizzare il set. Il separatore di livello delle cartelle è definito dall'applicazione client. Per gli strumenti e i client forniti da Analysis Services, la barra rovesciata (\) è il separatore del livello. Per fornire più cartelle di visualizzazione per un set definito, utilizzare un punto e virgola (;) per separare le cartelle. |