Usando propriedades da célula (MDX)
As propriedades de célula em expressões multidimensionais (MDX) contêm informações sobre o conteúdo e o formato das células de uma fonte de dados multidimensional, como um cubo.
A linguagem MDX aceita a palavra-chave CELL PROPERTIES em uma instrução MDX SELECT para recuperar propriedades de célula intrínsecas. As propriedades de célula intrínsecas são usadas geralmente para auxiliar na apresentação visual dos dados da célula.
Sintaxe da palavra-chave CELL PROPERTIES
Use a sintaxe a seguir para a palavra-chave CELL PROPERTIES da instrução MDX SELECT:
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
A sintaxe a seguir mostra o formato do valor <cell_props> e como ele utiliza a palavra-chave CELL PROPERTIES com uma ou mais das propriedades de célula intrínsecas:
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propriedades de célula intrínsecas suportadas
A tabela a seguir lista as propriedades de célula intrínsecas suportadas que são usadas no valor <property>.
Propriedade |
Descrição |
||
|---|---|---|---|
ACTION_TYPE |
Um bitmask que indica quais tipos de ações existem na célula. Essa propriedade pode ter um dos seguintes valores:
|
||
BACK_COLOR |
A cor do plano de fundo por exibir a propriedade VALUE ou FORMATTED_VALUE. Para obter mais informações, consulte Conteúdo de FORE_COLOR e BACK_COLOR (MDX). |
||
CELL_ORDINAL |
O número ordinal da célula no conjunto de dados. |
||
FONT_FLAGS |
O bitmask que detalha os efeitos da fonte. O valor é o resultado de uma operação OR bit a bit de uma ou mais destas constantes:
Por exemplo, o valor 5 representa a combinação dos efeitos de fonte negrito (MDFF_BOLD) e sublinhado (MDFF_UNDERLINE). |
||
FONT_NAME |
A fonte que será usada para exibir a propriedade VALUE ou FORMATTED_VALUE. |
||
FONT_SIZE |
O tamanho de fonte que será usada para exibir a propriedade VALUE ou FORMATTED_VALUE. |
||
FORE_COLOR |
A cor de primeiro plano para exibir a propriedade VALUE ou FORMATTED_VALUE. Para obter mais informações, consulte Conteúdo de FORE_COLOR e BACK_COLOR (MDX). |
||
FORMAT |
Igual a FORMAT_STRING. |
||
FORMAT_STRING |
A cadeia de caracteres de formato usada para criar o valor de propriedade FORMATTED_VALUE. Para obter mais informações, consulte Conteúdo de FORMAT_STRING (MDX). |
||
FORMATTED_VALUE |
A cadeia de caracteres que representa a exibição formatada da propriedade VALUE. |
||
LANGUAGE |
A localidade onde FORMAT_STRING será aplicada. Normalmente, a propriedade LANGUAGE é usada para conversão de moeda. |
||
UPDATEABLE |
Um valor que indica se a célula pode ser atualizada. Essa propriedade pode ter um dos seguintes valores:
|
||
VALUE |
O valor não formatado da célula. |
.gif "Observação")
ObservaçãoSão necessárias apenas as propriedades de célula CELL_ORDINAL, FORMATTED_VALUE e VALUE. Todas as propriedades de célula, intrínsecas ou específicas do provedor, são definidas no conjunto de linhas do esquema PROPERTIES, incluindo seus tipos de dados e o suporte do provedor. Para obter mais informações sobre o conjunto de linhas do esquema PROPERTIES, consulte Conjunto de linhas MDSCHEMA_PROPERTIES.
Por padrão, se a palavra-chave CELL PROPERTIES não for usada, serão retornadas as propriedades de célula VALUE, FORMATTED_VALUE e CELL_ORDINAL (nessa ordem). Se a palavra-chave CELL PROPERTIES for usada, serão retornadas somente as propriedades de célula explicitamente declaradas com a palavra-chave.
O exemplo a seguir demonstra o uso da palavra-chave CELL PROPERTIES em uma 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
As propriedades de célula não são retornadas para consultas MDX que retornam conjuntos de linhas bidimensionais; nesse caso, cada célula é representada como se apenas a propriedade de célula FORMATTED_VALUE fosse retornada.
Definindo propriedades de célula
Propriedades de célula podem ser definidas no Microsoft SQL Server Analysis Services em vários locais. Por exemplo, a propriedade Format String pode ser definida para medidas normais na guia Estrutura do Cubo do Editor de Cubos no SSDT (SQL Server Data Tools); a mesma propriedade pode ser definida para medidas calculadas definidas no cubo na guia Cálculos do Editor de Cubos; medidas calculadas definidas na cláusula WITH de uma consulta têm a cadeia de caracteres de formato definida nesse local também. A seguinte consulta demonstra como propriedades de célula podem ser definidas em uma 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