Utilisation des propriétés de cellule (MDX)
Les propriétés de cellule dans les expressions multidimensionnelles (MDX, Multidimensional Expressions) contiennent des informations sur le contenu et le format des cellules appartenant à une source de données multidimensionnelles, par exemple un cube.
La syntaxe MDX prend en charge le mot clé CELL PROPERTIES dans une instruction MDX SELECT pour l'extraction des propriétés de cellule intrinsèques. Ces propriétés sont principalement utilisées pour définir l'affichage des données des cellules.
Syntaxe du mot clé CELL PROPERTIES
Utilisez la syntaxe suivante pour le mot clé CELL PROPERTIES de l'instruction MDX SELECT :
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
La syntaxe suivante représente le format de la valeur <cell_props> et la manière dont elle utilise le mot clé CELL PROPERTIES 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 dresse la liste des propriétés de cellule intrinsèques prises en charge utilisées dans la valeur <property>.
Propriété |
Description |
|---|---|
ACTION_TYPE |
Masque binaire indiquant les types d'actions qui existent sur la cellule. Cette propriété peut prendre les valeurs suivantes :
|
BACK_COLOR |
Couleur d'arrière-plan utilisée pour afficher la propriété VALUE ou FORMATTED_VALUE. Pour plus d'informations, consultez Contenu de FORE_COLOR et BACK_COLOR (MDX). |
CELL_ORDINAL |
Numéro ordinal de la cellule dans le jeu de données. |
FONT_FLAGS |
Masque de bits détaillant les effets sur la police. La valeur de cette propriété est le résultat d'une opération OU au niveau du bit sur une ou plusieurs des constantes suivantes :
Par exemple, la valeur 5 représente la combinaison des effets gras (MDFF_BOLD) et souligné (MDFF_UNDERLINE). |
FONT_NAME |
Police à utiliser pour afficher la propriété VALUE ou FORMATTED_VALUE. |
FONT_SIZE |
Taille de la police à utiliser pour afficher la propriété VALUE ou FORMATTED_VALUE. |
FORE_COLOR |
Couleur d'avant-plan utilisée pour afficher la propriété VALUE ou FORMATTED_VALUE. Pour plus d'informations, consultez Contenu de FORE_COLOR et BACK_COLOR (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 Contenu de FORMAT_STRING (MDX). |
FORMATTED_VALUE |
Chaîne de caractères représentant un affichage avec mise en forme de la propriété VALUE. |
LANGUAGE |
Paramètre régional auquel FORMAT_STRING sera appliqué. LANGUAGE est généralement utilisé pour la conversion de devises. |
UPDATEABLE |
Valeur indiquant si la cellule peut être mise à jour. Cette propriété peut prendre les valeurs suivantes :
|
VALUE |
Valeur sans mise en forme de la cellule. |
Seules les propriétés de cellule CELL_ORDINAL, FORMATTED_VALUE et VALUE sont obligatoires. Toutes les propriétés de cellule, intrinsèques ou propres aux fournisseurs, sont définies dans le jeu de lignes du schéma PROPERTIES, notamment les types de données et la prise en charge par un fournisseur. Pour plus d'informations sur le jeu de lignes du schéma PROPERTIES, consultez Ensemble de lignes MDSCHEMA_PROPERTIES.
Par défaut, si le mot clé CELL PROPERTIES n'est pas utilisé, les propriétés de cellule retournées sont, dans l'ordre : VALUE, FORMATTED_VALUE et CELL_ORDINAL. Si le mot clé CELL PROPERTIES est utilisé, seules les propriétés de cellule explicitement spécifiées avec le mot clé sont retournées.
L'exemple suivant illustre l'utilisation du mot clé CELL PROPERTIES 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 requêtes MDX qui retournent des jeux de lignes réduits ne retournent pas de propriétés de cellule ; dans ce cas, chaque cellule est représentée comme si seule la propriété de cellule FORMATTED_VALUE était retournée.
Définition de propriétés de cellule
Les propriétés de cellule peuvent être définies dans à différents endroits Microsoft SQL Server Analysis Services. Par exemple, la propriété de chaîne de format peut être définie pour des mesures ordinaires sous l'onglet Structure de cube de l'éditeur de cube dans Outils de données SQL Server (SSDT) ; cette même propriété peut être définie pour des mesures calculées définies sur le cube sous l'onglet Calculs de l'éditeur de cube ; c'est également à cet emplacement que la chaîne de format des mesures calculées définies dans la clause WITH d'une requête est définie. La requête suivante montre comment les propriétés de cellule peuvent être définies 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