Définition des données MDX - CREATE SET

Crée un ensemble nommé avec la portée de session pour le cube courant.

Syntax

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

Arguments

Cube_Name
Une expression de chaîne valide qui fournit le nom du cube.

Set_Name
Une expression de chaîne valide qui fournit le nom de l’ensemble nommé créé.

Set_Expression
Une expression valide des expressions multidimensionnelles (MDX) qui retourne un ensemble.

Property_Name
Une chaîne valide qui fournit le nom d’une propriété d’ensemble.

Property_Value
Une expression scalaire valide qui définit la valeur de la propriété de l’ensemble.

Remarks

Un ensemble nommé est un ensemble de membres de dimension (ou une expression qui définit un ensemble) que vous créez pour réutiliser. Par exemple, un ensemble nommé permet de définir un ensemble de membres dimensionnels qui comprend l’ensemble des dix magasins les plus vendus. Cet ensemble peut être défini statiquement, ou au moyen d’une fonction comme TopCount. Cet ensemble nommé peut alors être utilisé partout où l’ensemble des 10 magasins principaux est nécessaire.

L’instruction CREATE SET crée un ensemble nommé qui reste disponible tout au long de la session, et peut donc être utilisé dans plusieurs requêtes au sein d’une session. Pour plus d’informations, voir Création de Session-Scoped membres calculés (MDX).

Vous pouvez aussi définir un ensemble nommé à utiliser par une seule requête. Pour définir un tel ensemble, vous utilisez la clause WITH dans l’instruction SELECT. Pour plus d’informations sur la clause WITH, voir Création Query-Scoped ensembles nommés (MDX).

La clause Set_Expression peut contenir n’importe quelle fonction qui prend en charge la syntaxe MDX. Les ensembles créés avec l’instruction CREATE SET qui ne spécifient pas la clause SESSION ont une portée de session. Utilisez la clause WITH pour créer un ensemble avec portée de requête.

Spécifier un cube autre que le cube actuellement connecté provoque une erreur. Par conséquent, vous devriez utiliser CURRENTCUBE à la place d’un nom de cube pour désigner le cube actuel.

Scope

Un ensemble défini par l’utilisateur peut se trouver dans l’un des champs de vision listés dans le tableau suivant.

Étendue de requête
La visibilité et la durée de vie de l’ensemble sont limitées à la requête. L’ensemble est défini dans une requête individuelle. Le périmètre de requête supprime le périmètre de session. Pour plus d’informations, voir Créer Query-Scoped ensembles nommés (MDX).

Portée de la session
La visibilité et la durée de vie de l’ensemble sont limitées à la session durant laquelle il est créé. (La durée de vie est inférieure à la durée de la session si une instruction DROP SET est émise sur l’ensemble.) L’instruction CREATE SET crée un ensemble avec la portée de la session. Utilisez la clause WITH pour créer un ensemble avec portée de requête.

Example

L’exemple suivant crée un ensemble appelé Core Products. La requête SELECT démontre alors comment appeler l’ensemble nouvellement créé. L’instruction CREATE SET doit être exécutée avant que la requête SELECT puisse être exécutée – elles ne peuvent pas être exécutées dans le même lot.

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

Évaluation des ensembles

L’évaluation des ensembles peut être définie différemment ; il peut être défini pour apparaître une seule fois lors de la création de l’ensemble ou peut être défini comme survenant à chaque fois que l’ensemble est utilisé.

STATIQUE
Indique que l’ensemble n’est évalué qu’une seule fois au moment où l’instruction CREATE SET est évaluée.

DYNAMIC
Indique que l’ensemble doit être évalué à chaque fois qu’il est utilisé dans une requête.

Définir la visibilité

L’ensemble peut être visible ou non pour d’autres utilisateurs qui interrogent le cube.

CACHÉ
Précise que l’ensemble n’est pas visible pour les utilisateurs qui consultent le cube.

Propriétés standard

Chaque ensemble possède un ensemble de propriétés par défaut. Lorsqu’une application cliente est connectée à Analysis Services, les propriétés par défaut sont soit prises en charge, soit disponibles pour être prises en charge, selon le choix de l’administrateur.

Identificateur de propriété Sens
LÉGENDE Une chaîne que l’application cliente utilise comme légende pour l’ensemble.
DISPLAY_FOLDER Une chaîne qui identifie le chemin du dossier d’affichage que l’application cliente utilise pour afficher l’ensemble. Le séparateur au niveau des dossiers est défini par l’application cliente. Pour les outils et clients fournis par Analysis Services, la barre oblique inverse (\) est le séparateur de niveau. Pour fournir plusieurs dossiers d’affichage pour un ensemble défini, utilisez un point-virgule (;) pour séparer les dossiers.

Voir aussi

Déclaration DROP SET (MDX)
Déclarations de définition de données MDX (MDX)

  • Last updated on