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.

Vedere anche

Riferimento

Istruzione DROP SET (MDX)

Altre risorse

Istruzioni MDX per la definizione dei dati (MDX)