Définition de données MDX - CREATE MEMBER

Article
05/23/2023

Crée un membre calculé.

Syntaxe

  
CREATE [ SESSION ] [HIDDDEN] [ CALCULATED ] MEMBER CURRENTCUBE | Cube_Name.Member_Name   
   AS MDX_Expression  
      [,Property_Name = Property_Value, ...n]  
......[,SCOPE_ISOLATION = CUBE]

Arguments

Cube_Name
Expression de chaîne valide qui fournit le nom du cube où le membre sera créé.

Member_Name
Expression de chaîne valide qui spécifie le nom d'un membre. Spécifiez un nom complet pour créer un membre au sein d'une dimension autre que la dimension Mesures. Si vous ne fournissez pas un nom de membre complet, le membre sera créé dans la dimension Mesures.

MDX_Expression
Expression MDX (Multidimensional Expressions) valide.

Property_Name
Chaîne valide qui précise le nom d'une propriété de membre calculé.

Property_Value
Expression scalaire valide qui définit la valeur de la propriété de membre calculé.

Remarques

L'instruction CREATE MEMBER définit les membres calculés disponibles tout au long de la session, et qui peuvent par conséquent être utilisés dans plusieurs requêtes au cours de la session. Pour plus d’informations, consultez Création de Session-Scoped membres calculés (MDX).

Vous pouvez également définir un membre calculé qui ne doit être utilisé que par une requête unique. Pour définir un membre calculé limité à une seule requête, utilisez la clause WITH de l'instruction SELECT. Pour plus d’informations, consultez Création de Query-Scoped membres calculés (MDX).

Property_Name peut faire référence à des propriétés de membre calculées standard ou facultatives. Les propriétés de membre standard sont répertoriées plus loin dans cette rubrique. Les membres calculés créés avec CREATE MEMBER sans valeur SESSION ont une étendue de session. En outre, les chaînes contenues dans les définitions de membre calculé sont délimitées par des guillemets doubles. Ce comportement diffère de celui de la méthode définie par OLE DB, qui spécifie que les chaînes doivent être délimitées par des guillemets simples.

La spécification d'un cube autre que le cube actuellement connecté génère une erreur. C'est pourquoi vous devez utiliser CURRENTCUBE de préférence à un nom de cube, pour désigner le cube actuel.

Pour de plus amples informations sur les propriétés de membre définies par OLE DB, reportez-vous à la documentation qui l'accompagne.

Étendue

Un membre calculé peut se produire au s'in d'une des portées répertoriées dans le tableau suivant.

Étendue de requête
La visibilité et la durée de vie du membre calculé sont limitées à la requête. Le membre calculé est défini dans une requête particulière. L'étendue de requête remplace l'étendue de session. Pour plus d’informations, consultez Création de Query-Scoped membres calculés (MDX).

Étendue de session
La visibilité et la durée de vie du membre calculé sont limitées à la session dans laquelle il a été créé. (La durée de vie est inférieure à la durée de session si une instruction DROP MEMBER est émise sur le membre calculé.) L’instruction CREATE MEMBER crée un membre calculé avec une étendue de session.

Isolement de la portée

Par défaut, lorsqu'un script MDX (Multidimensional Expressions) de cube contient des membres calculés, les membres calculés sont résolus avant que les calculs au niveau de la session soient résolus et avant que des calculs définis par requête soient résolus.

Notes

Dans certains scénarios, la fonction d’agrégation (MDX) et la fonction VisualTotals (MDX) n’affichent pas ce comportement.

Le comportement permet aux applications clientes génériques de travailler avec des cubes qui contiennent des calculs complexes, sans avoir à prendre en compte l'implémentation spécifique des calculs. Toutefois, dans certains scénarios, vous pouvez exécuter des membres calculés de session ou d’étendue de requête avant certains calculs dans le cube, et ni la fonction Aggregate ni la fonction VisualTotals ne sont applicables. Pour ce faire, utilisez la propriété de calcul SCOPE_ISOLATION.

Exemple

Le script ci-dessous est un exemple de scénario dans lequel la propriété de calcul SCOPE_ISOLATION est requise pour obtenir le résultat correct.

Script MDX du cube :

CREATE MEMBER CURRENTCUBE.Measures.ProfitRatio AS 'Measures.[Store Sales]/Measures.[Store Cost]', SOLVE_ORDER = 10

Requête MDX :

WITH MEMBER [Customer].[Customers].[USA]. USAWithoutWA AS  
[Customer].[Customers].[Country].&[USA] - [Customer].[Customers].[State Province.&[WA], SOLVE_ORDER=5  
SELECT {USAWithoutWA} ON 0 FROM SALES  
WHERE ProfitRatio

Le résultat souhaité de la requête précédente est le pourcentage des ventes pour les USA sans WA, pour stocker le coût pour les USA sans WA. La requête précédente ne retourne pas le résultat souhaité. Elle retourne le pourcentage des USA moins le pourcentage de WA, ce qui représente un résultat dénué de sens. Pour obtenir le résultat souhaité, vous pouvez utiliser la propriété de calcul SCOPE_ISOLATION.

Requête MDX utilisant la propriété de calcul SCOPE_ISOLATION :

WITH MEMBER [Customer].[Customers].[USA]. USAWithoutWA AS  
[Customer].[Customers].[Country].&[USA] - [Customer].[Customers].[State Province.&[WA], SOLVE_ORDER=5  
,SCOPE_ISOLATION=CUBE  
SELECT {USAWithoutWA} ON 0 FROM SALES  
WHERE ProfitRatio

Propriétés standard

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

Des propriétés de membre supplémentaires peuvent être disponibles, selon la définition du cube. Les propriétés suivantes représentent des informations relatives au niveau de dimension dans le cube.

Identificateur de propriété	Signification
SOLVE_ORDER	Ordre dans lequel le membre calculé sera résolu si un membre calculé fait référence à un autre membre calculé (c'est-à-dire à l'intersection des membres calculés).
FORMAT_STRING	Chaîne de format de style Office que l’application cliente peut utiliser lors de l’affichage des valeurs de cellule.
VISIBLE	Valeur qui indique si le membre calculé est visible dans un ensemble de lignes de schéma. Les membres calculés visibles peuvent être ajoutés à un ensemble avec la fonction AddCalculatedMembers . Une valeur autre que zéro indique que le membre calculé est visible. La valeur par défaut de cette propriété est Visible. Les membres calculés qui ne sont pas visibles (possédant la valeur zéro) sont généralement utilisés comme étapes intermédiaires dans des membres calculés plus complexes. Ces membres calculés peuvent également être référencés par d'autres types de membres, tels que des mesures.
NON_EMPTY_BEHAVIOR	Mesure ou jeu utilisé pour déterminer le comportement des membres calculés lors de la résolution des cellules vides. Avertissement Cette propriété est déconseillée. Évitez de l'utiliser. Pour plus d’informations, consultez Fonctionnalités Analysis Services déconseillées dans SQL Server 2014.
CAPTION	Chaîne que l'application cliente utilise à titre de légende du membre.
DISPLAY_FOLDER	Chaîne qui identifie le chemin d'accès du dossier d'affichage que l'application cliente utilise pour afficher le membre. Le séparateur de niveau de dossier est défini par l'application cliente. Pour les outils et les clients fournis par Analysis Services, la barre oblique inverse (\) est le séparateur de niveau. Pour fournir plusieurs dossiers d'affichage à un membre défini, utilisez un point-virgule (;) pour séparer les dossiers.
ASSOCIATED_MEASURE_GROUP	Nom du groupe de mesures auquel ce membre est associé.

Voir aussi

Instruction DROP MEMBER (MDX)
Instruction UPDATE MEMBER (MDX)
Instructions MDX de définition de données (MDX)