Usando propriedades da célula (MDX)
As propriedades de célula na linguagem 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:
.gif "Observação") Observação
Ações de detalhamento não são incluídas nas consultas que contêm um conjunto na cláusula where.
|
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. |
Sã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 de esquema PROPERTIES, incluindo seus tipos de dados e o suporte do provedor. Para obter mais informações sobre o conjunto de linhas de 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
As propriedades de célula podem ser definidas no MicrosoftSQL ServerAnalysis Services na guia Cálculos do Designer de Cubo ou do Designer de Dimensão. As propriedades de célula são representadas como expressões de cadeia de caracteres, mostradas no exemplo a seguir que fornece, para o membro especificado, um plano de fundo amarelo com um primeiro plano vermelho:
FORE_COLOR='255',BACK_COLOR='65535'
Normalmente, as propriedades de célula são acumuladas nos membros pai, exceto se o pai for um membro personalizado com propriedades de célula. Nesse caso, as propriedades de célula pai substituem as propriedades de célula provenientes dos filhos.