Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les propriétés de cellule dans MDX (Multidimensional Expressions) contiennent des informations sur le contenu et le format des cellules dans une source de données multidimensionnelle, comme un cube.
MDX prend en charge le mot clé CELL PROPERTIES dans une instruction MDX SELECT pour récupérer les propriétés intrinsèques des cellules. Les propriétés intrinsèques des cellules sont les plus couramment utilisées pour faciliter la présentation visuelle des données de cellule.
Syntaxe du mot clé CELL PROPERTIES
Utilisez la syntaxe suivante pour le CELL PROPERTIES mot clé de l’instruction MDX SELECT :
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
La syntaxe suivante montre le format de la <cell_props> valeur et la façon dont cette valeur utilise le CELL PROPERTIES mot clé avec une ou plusieurs propriétés de cellule intrinsèques :
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propriétés de cellule intrinsèques prises en charge
Le tableau suivant répertorie les propriétés intrinsèques prises en charge qui sont utilisées dans la <property> valeur.
| Propriété | Descriptif |
|---|---|
ACTION_TYPE |
Masque de bits qui indique quels types d’actions existent sur la cellule. Cette propriété peut prendre les valeurs suivantes : MDACTION_TYPE_URL MDACTION_TYPE_HTML MDACTION_TYPE_STATEMENT MDACTION_TYPE_DATASET MDACTION_TYPE_ROWSET MDACTION_TYPE_COMMANDLINE MDACTION_TYPE_PROPRIÉTAIRE MDACTION_TYPE_REPORT Type d'Action MD: Drillthrough Remarque : les actions d’extraction ne sont pas incluses pour les requêtes contenant un jeu dans la clause Where. |
| BACK_COLOR | Couleur d'arrière-plan pour l'affichage de la propriété VALUE ou FORMATTED_VALUE. Pour plus d’informations, consultez FORE_COLOR et BACK_COLOR Contenus (MDX). |
CELL_ORDINAL |
Numéro ordinal de la cellule dans le jeu de données. |
| FONT_FLAGS | Le masque de bits détaillant les effets sur la police de caractères. Par exemple, la valeur 5 représente la combinaison d’effets de police gras (MDFF_BOLD) et souligné (MDFF_UNDERLINE). La valeur est le résultat d’une opération OR au niveau du bit d’une ou plusieurs des constantes suivantes :MDFF_BOLD = 1MDFF_ITALIC = 2MDFF_UNDERLINE = 4MDFF_STRIKEOUT = 8 |
| FONT_NAME | Police à utiliser pour afficher la propriété VALUE ou FORMATTED_VALUE. |
| FONT_SIZE | Taille de police à utiliser pour afficher la propriété VALUE ou FORMATTED_VALUE. |
| FORE_COLOR | Couleur de premier plan pour l’affichage de la propriété VALUE ou FORMATTED_VALUE. Pour plus d’informations, consultez FORE_COLOR et BACK_COLOR Contenus (MDX). |
FORMAT |
Identique à FORMAT_STRING. |
FORMAT_STRING |
Chaîne de format utilisée pour créer la valeur de la propriété FORMATTED_VALUE. Pour plus d’informations, consultez FORMAT_STRING Contenu (MDX). |
FORMATTED_VALUE |
Chaîne de caractères qui représente un affichage mis en forme de la VALUE propriété. |
LANGUAGE |
Le site où le FORMAT_STRING sera utilisé.
LANGUAGE est généralement utilisé pour la conversion monétaire. |
UPDATEABLE |
Valeur qui indique si la cellule peut être mise à jour. Cette propriété peut prendre les valeurs suivantes :MD_MASK_ENABLED (0x00000000) La cellule peut être mise à jour.MD_MASK_NOT_ENABLED (0x10000000) Impossible de mettre à jour la cellule.CELL_UPDATE_ENABLED (0x00000001) La cellule peut être mise à jour dans le cellset.CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) La cellule peut être mise à jour avec une instruction update. La mise à jour peut échouer si une cellule terminale est mise à jour et qu'elle n'est pas activée pour l'écriture.CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) La cellule ne peut pas être mise à jour car elle a un membre calculé parmi ses coordonnées ; elle a été récupérée avec un ensemble dans la clause WHERE. Une cellule peut être mise à jour même si une formule affecte la valeur de celle-ci ou qu’une cellule calculée est impliquée dans le chemin d'agrégation. Dans ce scénario, la valeur finale de la cellule peut ne pas être la valeur mise à jour, car le calcul affecte le résultatCELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) Impossible de mettre à jour la cellule, car les mesures non-somme (nombre, min, max, nombre distinct, semi-additif) ne peuvent pas être mises à jour.CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) Impossible de mettre à jour la cellule, car elle n’existe pas car elle se trouve à l’intersection d’une mesure et d’un membre de dimension non lié au groupe de mesures de la mesure.CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) Impossible de mettre à jour la cellule, car elle est sécurisée.CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) Réservé à une utilisation ultérieure.CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007) Impossible de mettre à jour la cellule pour des raisons internes.CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) Impossible de mettre à jour la cellule, car la mise à jour n’est pas prise en charge dans le modèle d’exploration de données, les dimensions indirectes ou d’exploration de données. |
VALUE |
Valeur non mise en forme de la cellule. |
Seules les propriétés des cellules CELL_ORDINAL, FORMATTED_VALUE et VALUE sont requises. Toutes les propriétés de cellule, intrinsèques ou spécifiques au fournisseur, sont définies dans l’ensemble de lignes de PROPERTIES schéma, y compris leurs types de données et la prise en charge du fournisseur. Pour plus d’informations sur l’ensemble de lignes de PROPERTIES schéma, consultez MDSCHEMA_PROPERTIES Ensemble de lignes.
Par défaut, si le CELL PROPERTIES mot clé n’est pas utilisé, les propriétés de cellule retournées sont VALUE, FORMATTED_VALUEet CELL_ORDINAL (dans cet ordre). Si le CELL PROPERTIES mot clé est utilisé, seules ces propriétés de cellule explicitement indiquées avec le mot clé sont retournées.
L’exemple suivant illustre l’utilisation du CELL PROPERTIES mot clé dans une requête MDX :
SELECT
{[Measures].[Reseller Gross Profit]} ON COLUMNS,
{[Reseller].[Reseller Type].[Reseller Name].Members} ON ROWS
FROM [Adventure Works]
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORMAT_STRING, FORE_COLOR, BACK_COLOR
Les propriétés de cellule ne sont pas retournées pour les requêtes MDX qui retournent des ensembles de lignes aplaties ; dans ce cas, chaque cellule est représentée comme si seule la FORMATTED_VALUE propriété de cellule a été retournée.
Définition des propriétés de cellule
Les propriétés de cellule peuvent être définies dans Microsoft SQL Server Analysis Services à différents endroits. Par exemple, la propriété Format String peut être définie pour des mesures régulières sous l’onglet Structure du cube de l’éditeur de cube dans SQL Server Data Tools (SSDT) ; la même propriété peut être définie pour les mesures calculées définies sur le cube sous l’onglet Calculs de l’éditeur de cube ; les mesures calculées définies dans la clause WITH d’une requête ont également leur chaîne de format définie. La requête suivante montre comment définir les propriétés de cellule sur une mesure calculée ::
WITH MEMBER MEASURES.CELLPROPERTYDEMO AS [Measures].[Internet Sales Amount]
, FORE_COLOR=RGB(0,0,255)
, BACK_COLOR=IIF([Measures].[Internet Sales Amount]>7000000, RGB(255,0,0), RGB(0,255,0))
, FONT_SIZE=10
, FORMAT_STRING='#,#.000'
SELECT MEASURES.CELLPROPERTYDEMO ON 0,
[Date].[Calendar Year].[Calendar Year].MEMBERS ON 1
FROM [Adventure Works]
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORE_COLOR, BACK_COLOR, FONT_SIZE