Definizione dei dati MDX - creare impostatoMDX Data Definition - CREATE SET

SI APPLICA A:sìSQL Server Analysis ServicesnoAzure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services

Crea un set denominato con ambito sessione per il cubo corrente.Creates a named set with session scope for the current cube.

SintassiSyntax


CREATE [SESSION] [ STATIC | DYNAMIC ] [HIDDEN] SET   
   CURRENTCUBE | Cube_Name  
      .Set_Name AS 'Set_Expression'  
      [,Property_Name = Property_Value, ...n]  

ArgomentiArguments

Cube_NameCube_Name
Espressione stringa valida che specifica il nome del cubo.A valid string expression that provides the name of the cube.

Set_NameSet_Name
Espressione stringa valida che specifica il nome del set denominato che viene creato.A valid string expression that provides the name for the named set being created.

Set_ExpressionSet_Expression
Espressione MDX (Multidimensional Expression) valida che restituisce un set.A valid Multidimensional Expressions (MDX) expression that returns a set.

Property_nameProperty_Name
Stringa valida che fornisce il nome di una proprietà del set.A valid string that provides the name of a set property.

Property_ValueProperty_Value
Espressione scalare valida che definisce il valore della proprietà del set.A valid scalar expression that defines the set property's value.

OsservazioniRemarks

Un set denominato è un set di membri di dimensioni, o un'espressione che definisce un set, che è possibile creare per un riutilizzo successivo.A named set is a set of dimension members (or an expression that defines a set) that you create to use again. Un set denominato, ad esempio, consente di definire un set di membri di dimensioni costituito dal set dei primi dieci punti vendita per fatturato.For example, a named set makes it possible to define a set of dimension members that consists of the set of the top ten stores by sales. Questo set può essere definito in modo statico, o tramite una funzione come TopCount.This set can be defined statically, or by means of a function like TopCount. Il set denominato potrà quindi essere utilizzato ogni volta che sarà necessario recuperare il set dei primi 10 punti vendita.This named set can then be used wherever the set of the top 10 stores is needed.

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.The CREATE SET statement creates a named set that remains available throughout the session, and therefore, can be used in multiple queries in a session. Per ulteriori informazioni, vedere membri calcolati Creating Session-Scoped ( MDX ) .For more information, see Creating Session-Scoped Calculated Members (MDX).

È inoltre possibile definire un set denominato da utilizzare in un'unica query.You can also define a named set for use by a single query. Per definire un set di questo tipo, utilizzare la clausola WITH nell'istruzione SELECT.To define such a set, you use the WITH clause in the SELECT statement. Per ulteriori informazioni sulla clausola WITH, vedere Creating Query-Scoped denominati ( MDX ) .For more information about the WITH clause, see Creating Query-Scoped Named Sets (MDX).

Il Set_Expression clausola può contenere qualsiasi funzione che supporta la sintassi MDX.The Set_Expression clause can contain any function that supports MDX syntax. L'ambito dei set creati con l'istruzione CREATE SET che non specificano la clausola SESSION è sessione.Sets created with the CREATE SET statement that do not specify the SESSION clause have session scope. Utilizzare la clausola WITH per creare un set con l'ambito query.Use the WITH clause to create a set with query scope.

Specificando un cubo diverso dal cubo connesso viene generato un errore.Specifying a cube other than the cube that is currently connected causes an error. Pertanto, per identificare il cubo corrente è consigliabile usare CURRENTCUBE anziché il nome di un cubo.Therefore, you should use CURRENTCUBE in place of a cube name to denote the current cube.

AmbitoScope

Un set definito dall'utente può trovarsi all'interno di uno degli ambiti elencati nella tabella seguente.A user-defined set can occur within one of the scopes listed in the following table.

Ambito queryQuery scope
La visibilità e la durata del set sono limitate alla query.The visibility and lifetime of the set is limited to the query. Il set è definito in un'unica query.The set is defined in an individual query. L'ambito query prevale sull'ambito sessione.Query scope overrides session scope. Per ulteriori informazioni, vedere Creating Query-Scoped denominati ( MDX ) .For more information, see Creating Query-Scoped Named Sets (MDX).

Ambito sessioneSession scope
La visibilità e la durata del set sono limitate alla sessione in cui è stato creato.The visibility and lifetime of the set is limited to the session in which it is created. 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.(The lifetime is less than the session duration if a DROP SET statement is issued on the set.) The CREATE SET statement creates a set with session scope. Utilizzare la clausola WITH per creare un set con l'ambito query.Use the WITH clause to create a set with query scope.

EsempioExample

Nell'esempio seguente viene creato un set denominato Core Products.The following example creates a set called Core Products. Mediante la query SELECT viene quindi illustrata la chiamata del set appena creato.The SELECT query then demonstrates calling the newly created set. Affinché possa essere eseguita la query SELECT, è necessario che sia stata innanzitutto eseguita l'istruzione CREATE SET. Non possono essere eseguite nello stesso batch.The CREATE SET statement must be executed before the SELECT query can be executed - they cannot be executed in the same batch.

CREATE SET [Adventure Works].[Core Products] AS '{[Product].[Category].[Bikes]}'  

SELECT [Core Products] ON 0  
  FROM [Adventure Works]  

Valutazione del setSet Evaluation

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.Set evaluation can be defined to occur differently; it can be defined to occur only once at set creation or can be defined to occur every time the set is used.

STATICSTATIC
Indica che il set viene valutato solo al momento della valutazione dell'istruzione CREATE SET.Indicates that the set is evaluated only once at the time the CREATE SET statement is evaluated.

DYNAMICDYNAMIC
Indica che il set deve essere valutato tutte le volte che viene utilizzato in una query.Indicates that the set is to be evaluated every time it is used in a query.

Visibilità setSet Visibility

Il set può essere o meno visibile agli altri utenti che eseguono la query sul cubo.The set can be either visible or not to other users who query the cube.

HIDDENHIDDEN
Specifica che il set non è visibile agli utenti che eseguono una query sul cubo.Specifies that the set is not visible to users who query the cube.

Proprietà standardStandard Properties

Ogni set presenta un set di proprietà predefinite.Each set has a set of default properties. Quando un'applicazione client è connesso ad MicrosoftMicrosoft Analysis ServicesAnalysis Services, le proprietà predefinite sono supportate o disponibili per essere supportate, come l'amministratore sceglie.When a client application is connected to MicrosoftMicrosoft Analysis ServicesAnalysis Services, the default properties are either supported, or available to be supported, as the administrator chooses.

Identificatore proprietàProperty identifier SignificatoMeaning
CAPTIONCAPTION Una stringa che l'applicazione client utilizza come didascalia per il set.A string that the client application uses as the caption for the set.
DISPLAY_FOLDERDISPLAY_FOLDER Una stringa che identifica il percorso della cartella di visualizzazione che l'applicazione client utilizza per mostrare il set.A string that identifies the path of the display folder that the client application uses to show the set. Il separatore di livello delle cartelle è definito dall'applicazione client.The folder level separator is defined by the client application. Per gli strumenti e i client forniti da Analysis ServicesAnalysis Services, la barra rovesciata (\) è il separatore di livello.For the tools and clients supplied by Analysis ServicesAnalysis Services, the backslash (\) is the level separator. Per fornire più cartelle di visualizzazione per un set definito, utilizzare un punto e virgola (;) per separare le cartelle.To provide multiple display folders for a defined set, use a semicolon (;) to separate the folders.

Vedere ancheSee Also

ELIMINARE l'istruzione SET ( MDX ) DROP SET Statement (MDX)
Le istruzioni di definizione dei dati MDX ( MDX )MDX Data Definition Statements (MDX)