Propiedades de celda MDX: uso de propiedades de celda
Se aplica a:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Las propiedades de celda de las expresiones multidimensionales (MDX) contienen información sobre el contenido y el formato de las celdas de un origen de datos multidimensional, como un cubo.
MDX admite la palabra clave CELL PROPERTIES en una instrucción MDX SELECT para recuperar propiedades de celda intrínsecas. Las propiedades de celda intrínsecas se suelen utilizar para facilitar la presentación visual de los datos de las celdas.
Sintaxis de la palabra clave CELL PROPERTIES
Utilice la siguiente sintaxis para la palabra clave CELL PROPERTIES de la instrucción MDX SELECT :
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
En la siguiente sintaxis se muestra el formato del valor <cell_props> y cómo este usa la palabra clave CELL PROPERTIES junto con una o más propiedades de celda intrínsecas:
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propiedades de celda intrínsecas compatibles
En la siguiente tabla figuran las propiedades de celda intrínsecas compatibles que se utilizan en el valor <property> .
| Propiedad | Descripción |
|---|---|
| ACTION_TYPE | Máscara de bits que indica los tipos de acciones de la celda. Esta propiedad admite cualquiera de los siguientes valores: 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 Nota: Las acciones de obtención de detalles no se incluyen para las consultas que contienen un conjunto en la cláusula WHERE. |
| BACK_COLOR | Color de fondo para mostrar las propiedades VALUE o FORMATTED_VALUE. Para obtener más información, vea FORE_COLOR y contenido de BACK_COLOR (MDX). |
| CELL_ORDINAL | Número ordinal de la celda en el conjunto de datos. |
| FONT_FLAGS | Máscara de bits que detalla los efectos de la fuente. El valor es el resultado de una operación de bits OR de una o varias de las siguientes constantes: MDFF_BOLD = 1 MDFF_ITALIC = 2 MDFF_UNDERLINE = 4 MDFF_STRIKEOUT = 8 Por ejemplo, el valor 5 representa la combinación de los efectos de fuente negrita (MDFF_BOLD) y subrayado (MDFF_UNDERLINE). |
| FONT_NAME | Fuente usada para mostrar la propiedad VALUE o FORMATTED_VALUE . |
| FONT_SIZE | Tamaño de fuente usado para mostrar la propiedad VALUE o FORMATTED_VALUE . |
| FORE_COLOR | Color de primer plano para mostrar las propiedades VALUE o FORMATTED_VALUE. Para obtener más información, vea FORE_COLOR y contenido de BACK_COLOR (MDX). |
| FORMAT | Equivalente a FORMAT_STRING. |
| FORMAT_STRING | Cadena de formato usada para crear el valor de la propiedad FORMATTED_VALUE. Para obtener más información, vea contenido de FORMAT_STRING (MDX). |
| FORMATTED_VALUE | Cadena de caracteres que representa una visualización con formato de la propiedad VALUE . |
| LANGUAGE | Configuración regional a la que se aplicará FORMAT_STRING . LANGUAGE suele utilizarse para la conversión de moneda. |
| ACTUALIZABLE | Valor que indica si la celda puede actualizarse. Esta propiedad admite cualquiera de los siguientes valores: |
| MD_MASK_ENABLED (0x00000000) Se puede actualizar la celda. | |
| MD_MASK_NOT_ENABLED (0x10000000) No se puede actualizar la celda. | |
| CELL_UPDATE_ENABLED (0x00000001) Celda se puede actualizar en el conjunto de celdas. | |
| CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) La celda se puede actualizar con una instrucción update. La actualización puede no realizarse correctamente si se actualiza una celda hoja no habilitada para escritura. | |
| CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) No se puede actualizar la celda porque la celda tiene un miembro calculado entre sus coordenadas; la celda se recuperó con un conjunto en la cláusula where. Las celdas pueden actualizarse incluso si tienen una fórmula que incida en el valor de una celda, o si hay una celda calculada activa (en algún punto de la ruta de agregación). Con este escenario, es posible que el valor final de la celda no sea el valor actualizado, puesto que el cálculo afecta al resultado. | |
| CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) No se puede actualizar la celda porque no se pueden actualizar medidas no sumas (count, min, max, distinct count, semi-additive). | |
| CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) No se puede actualizar la celda porque la celda no existe tal como está en la intersección de una medida y un miembro de dimensión no relacionado con el grupo de medida de la medida. | |
| CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) La celda no se puede actualizar porque la celda está protegida. | |
| CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) Reservado para uso futuro. | |
| CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007) La celda no se puede actualizar debido a motivos internos. | |
| CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) La celda no se puede actualizar porque la actualización no se admite en las dimensiones de minería de datos, indirectas o de minería de datos. | |
| VALUE | Valor sin formato de la celda. |
Solo son obligatorias las propiedades de celda CELL_ORDINAL, FORMATTED_VALUEy VALUE . Todas las propiedades de celda, intrínsecas o específicas del proveedor, se definen en el conjunto de filas de esquema PROPERTIES , incluidos los tipos de datos y la compatibilidad con el proveedor.
De forma predeterminada, si no se usa la palabra clave CELL PROPERTIES , las propiedades de celda devueltas son VALUE, FORMATTED_VALUEy CELL_ORDINAL (en este orden). Si se utiliza la palabra clave CELL PROPERTIES , se devuelven únicamente las propiedades de celda especificadas explícitamente con la palabra clave.
En el siguiente ejemplo se muestra el uso de la palabra clave CELL PROPERTIES en una consulta 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
No se devuelven las propiedades de celda de consultas MDX que devuelven conjuntos de filas planas; en este caso, cada celda se representa como si solo se hubiese devuelto la propiedad de celda FORMATTED_VALUE .
Establecer las propiedades de celda
Las propiedades de celda se pueden establecer en Microsoft SQL Server SQL Server Analysis Services en varios lugares. Por ejemplo, la propiedad Format String se puede establecer para medidas normales en la pestaña Estructura de cubo del Editor de cubos en SQL Server Data Tools; la misma propiedad se puede establecer para las medidas calculadas definidas en el cubo de la pestaña Cálculos del Editor de cubos; las medidas calculadas definidas en la cláusula WITH de una consulta también tienen definida su cadena de formato. En la consulta siguiente se muestra cómo se pueden establecer las propiedades de celda en una medida calculada:
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