Propriedades da célula MDX – Usando propriedades de célula
Aplica-se a:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
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: 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 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 da tela de fundo para exibir a propriedade VALUE ou FORMATTED_VALUE. Para obter mais informações, consulte FORE_COLOR e BACK_COLOR Contents (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: MDFF_BOLD = 1 MDFF_ITALIC = 2 MDFF_UNDERLINE = 4 MDFF_STRIKEOUT = 8 Por exemplo, o valor 5 representa a combinação dos efeitos de fonte negrito (MDFF_BOLD) e sublinhado (MDFF_UNDERLINE). |
| FONT_NAME | A fonte a ser usada para exibir a propriedade VALUE ou FORMATTED_VALUE . |
| FONT_SIZE | O tamanho da fonte a ser usado 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 FORE_COLOR e BACK_COLOR Contents (MDX). |
| FORMAT | Mesmo que FORMAT_STRING. |
| FORMAT_STRING | A cadeia de caracteres de formato usada para criar o valor da propriedade FORMATTED_VALUE. Para obter mais informações, consulte FORMAT_STRING Contents (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 propriedadeLANGUAGE é usada para conversão de moeda. |
| ATUALIZÁVEL | Um valor que indica se a célula pode ser atualizada. Essa propriedade pode ter um dos seguintes valores: |
| MD_MASK_ENABLED (0x00000000) A célula pode ser atualizada. | |
| MD_MASK_NOT_ENABLED (0x10000000) A célula não pode ser atualizada. | |
| CELL_UPDATE_ENABLED (0x00000001) Célula pode ser atualizada no conjunto de células. | |
| CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) A célula pode ser atualizada com uma instrução update. Pode ocorrer um erro na atualização se uma célula folha for atualizada sem estar habilitada para gravação. | |
| CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) A célula não pode ser atualizada porque a célula tem um membro calculado entre suas coordenadas; a célula foi recuperada com um conjunto na cláusula where. A célula pode ser atualizada mesmo que uma fórmula afete o valor da célula ou haja uma célula calculada ativada (em algum ponto do caminho de agregação). Nessa situação, o valor final da célula pode não ser o valor atualizado, pois o cálculo afetará o resultado. | |
| CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) A célula não pode ser atualizada porque medidas não somadas (count, min, max, distinct count, semi-additive) não podem ser atualizadas. | |
| CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) A célula não pode ser atualizada porque a célula não existe como está na interseção de uma medida e um membro de dimensão não relacionado ao grupo de medidas da medida. | |
| CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) A célula não pode ser atualizada porque a célula está protegida. | |
| CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) Reservado para uso futuro. | |
| CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007) A célula não pode ser atualizada por motivos internos. | |
| CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) A célula não pode ser atualizada porque não há suporte para atualização em dimensões de mineração, indiretas ou de modelo de mineração de dados. | |
| VALUE | O valor não formatado da célula. |
Somente as propriedades de célula CELL_ORDINAL, FORMATTED_VALUEe VALUE são necessárias. 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.
Por padrão, se a palavra-chave CELL PROPERTIES não for usada, as propriedades da célula retornadas serão VALUE, FORMATTED_VALUEe 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 seria representada como se apenas a propriedade de célula FORMATTED_VALUE fosse retornada.
Definindo propriedades de célula
As propriedades da célula podem ser definidas no Microsoft SQL Server SQL Server Analysis Services em vários locais. Por exemplo, a propriedade Format String pode ser definida para medidas regulares na guia Estrutura do Cubo do Editor de Cubos em SQL Server Data Tools; a mesma propriedade pode ser definida para medidas calculadas definidas no cubo na guia Cálculos do Editor de Cubo; medidas calculadas definidas na cláusula WITH de uma consulta têm sua cadeia de caracteres de formato definida lá também. A consulta a seguir demonstra como as propriedades da 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