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.

Vedere anche

Riferimento

Istruzione DROP SET (MDX)

Altre risorse

Istruzioni MDX per la definizione dei dati (MDX)