Partager via


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 :

  • MDACTION_TYPE_URL

  • MDACTION_TYPE_HTML

  • MDACTION_TYPE_STATEMENT

  • MDACTION_TYPE_DATASET

  • MDACTION_TYPE_ROWSET

  • MDACTION_TYPE_COMMANDLINE

  • MDACTION_TYPE_PROPRIETARY

  • MDACTION_TYPE_REPORT

  • MDACTION_TYPE_DRILLTHROUGH

RemarqueRemarque
Les actions d'extraction des requêtes dont la clause Where contient un jeu ne sont pas comprises.

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 :

  • MDFF_BOLD = 1

  • MDFF_ITALIC = 2

  • MDFF_UNDERLINE = 4

  • MDFF_STRIKEOUT = 8

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 :

  • MD_MASK_ENABLED (0x00000000)   La cellule peut être mise à jour.

  • MD_MASK_NOT_ENABLED (0x10000000)   La cellule ne peut pas être mise à jour.

  • CELL_UPDATE_ENABLED (0x00000001)   La cellule peut être mise à jour dans le jeu de cellules.

  • CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002)   La cellule peut être mise à jour avec une instruction UPDATE. La mise à jour peut échouer si une cellule feuille non activée en écriture est mise à jour.

  • CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001)   La cellule ne peut pas être mise à jour, car elle possède un membre calculé parmi ses coordonnées ; elle a été récupérée avec un jeu dans la clause Where. Une cellule peut être mise à jour même si une formule affecte sa valeur (se trouve à un certain endroit sur le chemin d'agrégation) ou si une cellule calculée se trouve dessus. Dans ce scénario, la valeur finale de la cellule ne peut pas être la valeur mise à jour, car le calcul affectera le résultat.

  • CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002)   La cellule ne peut pas être mise à jour, car les mesures de type non-somme (comptage, min, max, compte distinct, semi-additives) ne peuvent pas être mises à jour.

  • CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003)   La cellule ne peut pas être mise à jour, car elle n'existe pas en tant que telle à l'intersection d'une mesure et d'un membre de dimension sans rapport avec le groupe de mesures de la mesure.

  • CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005)    La cellule ne peut pas être mise à jour, car elle n'est pas sécurisée.

  • CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006)   Réservé pour un usage futur.

  • CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007)   La cellule ne peut pas être mise à jour pour des raisons internes.

  • CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009)   La cellule ne peut pas être mise à jour, car la mise à jour n'est pas prise en charge dans le modèle d'exploration de données, les dimensions indirectes et les dimensions d'exploration de données.

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 MicrosoftSQL ServerAnalysis Services à l'aide de l'onglet Calculs du Concepteur de cube ou du Concepteur de dimensions. Les propriétés de cellule sont représentées sous forme d'expressions de chaîne, illustrées dans l'exemple suivant qui fournit, pour le membre spécifié, un arrière-plan jaune avec un avant-plan rouge :

FORE_COLOR='255',BACK_COLOR='65535'

Les propriétés de cellule se cumulent généralement au niveau du membre parent, sauf si ce dernier est un membre personnalisé avec ses propres propriétés de cellule. Dans ce dernier cas, les propriétés de cellule du parent annulent et remplacent celles provenant de ses enfants.

Voir aussi

Autres ressources