Condividi tramite

  • Articolo

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 dimensione, o un'espressione che definisce un set, che è possibile creare per un utilizzo ripetuto. 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 tramite una funzione, ad esempio TopCount. Il set denominato potrà quindi essere utilizzato ogni volta che sarà necessario recuperare il set dei primi dieci 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.

  • Ambito globale
    Per creare un set denominato con ambito più ampio rispetto al contesto della sessione dell'utente, ovvero al posto della durata dell'istanza in esecuzione, è possibile utilizzare l'istruzione CREATE SET nello script MDX predefinito. Per ulteriori informazioni, vedere Script MDX di base (MDX). Un set denominato definito tramite l'istruzione CREATE SET nello script MDX predefinito è disponibile per tutti gli utenti in tutte le query MDX in qualsiasi sessione.

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.

Per ulteriori informazioni, vedere Creazione di set denominati in MDX (MDX).

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 MicrosoftAnalysis Services, l'amministratore può scegliere se le proprietà predefinite sono supportate o disponibili per essere supportate.

Identificatore proprietà

Significato

CAPTION

Una stringa che l'applicazione client utilizza come didascalia per il set.

DISPLAY_FOLDER

Una stringa che identifica il percorso della cartella di visualizzazione che l'applicazione client utilizza per mostrare 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 di livello. Per fornire più cartelle di visualizzazione per un set definito, utilizzare un punto e virgola (;) per separare le cartelle.