Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
As propriedades de célula em Expressões Multidimensionais (MDX) contêm informações sobre o conteúdo e o formato das células em uma fonte de dados multidimensional, como um cubo.
O MDX dá suporte à palavra-chave CELL PROPERTIES em uma instrução MDX SELECT para recuperar propriedades de célula intrínseca. As propriedades de célula intrínseca são mais comumente usadas para ajudar na apresentação visual de dados de célula.
Sintaxe da palavra-chave CELL PROPERTIES
Use a seguinte sintaxe para a CELL PROPERTIES palavra-chave 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 <cell_props> valor e como esse valor usa a CELL PROPERTIES palavra-chave junto com uma ou mais propriedades de célula intrínseca:
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propriedades intrínsecas de células suportadas
A tabela a seguir lista as propriedades intrínsecas de célula com suporte que são usadas no valor do <property>.
| Propriedade | Descrição |
|---|---|
ACTION_TYPE |
Uma máscara de bits 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: as ações de detalhamento não são incluídas para consultas que contêm um conjunto na cláusula where. |
| BACK_COLOR | A cor 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 na base de dados. |
| FONT_FLAGS | A máscara de bits que detalha os efeitos na fonte. Por exemplo, o valor 5 representa a combinação de efeitos de fonte em negrito (MDFF_BOLD) e sublinhado (MDFF_UNDERLINE). O valor é o resultado de uma operação OR bit a bit de uma ou mais das seguintes constantes:MDFF_BOLD = 1MDFF_ITALIC = 2MDFF_UNDERLINE = 4MDFF_STRIKEOUT = 8 |
| FONT_NAME | A fonte a ser usada para exibir a propriedade VALUE ou a propriedade FORMATTED_VALUE. |
| FONT_SIZE | Tamanho da fonte a ser usado para exibir a propriedade VALUE ou FORMATTED_VALUE. |
| FORE_COLOR | A cor do primeiro plano para exibir a propriedade VALUE ou FORMATTED_VALUE. Para obter mais informações, consulte FORE_COLOR e BACK_COLOR Contents (MDX). |
FORMAT |
O mesmo que FORMAT_STRING. |
FORMAT_STRING |
A string 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 uma exibição formatada da VALUE propriedade. |
LANGUAGE |
A localidade em que a FORMAT_STRING opção será aplicada.
LANGUAGE geralmente é usado 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: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) A célula pode ser atualizada no conjunto de dados de células.CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) A célula pode ser atualizada com uma instrução de atualização. A atualização poderá falhar se uma célula folha que não está habilitada para escrita for atualizada.CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) A célula não pode ser atualizada porque possui um membro calculado entre suas coordenadas; a célula foi recuperada com um conjunto especificado na cláusula where. Uma célula pode ser atualizada mesmo que uma fórmula a afete ou que uma célula calculada influencie seu valor (estando em algum lugar ao longo do caminho de agregação). Nesse cenário, o valor final da célula pode não ser o valor atualizado, pois o cálculo afetará o resultadoCELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) A célula não pode ser atualizada pois medidas que não são soma (contagem, mínimo, máximo, contagem distinta, semi-aditivas) não podem ser atualizadas.CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) A célula não pode ser atualizada porque não existe, pois está na interseção de uma medida e de um membro de dimensão não relacionado ao grupo de medidas.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 a atualização não é suportada no modelo de mineração, indireto ou nas dimensões de mineração de dados. |
VALUE |
O valor não formatado da célula. |
Somente as propriedades de célula CELL_ORDINAL, FORMATTED_VALUE e VALUE são necessárias. Todas as propriedades de célula, intrínsecas ou específicas do provedor, são definidas no rowset do esquema PROPERTIES, incluindo seus tipos de dados e suporte do provedor. Para obter mais informações sobre o conjunto de linhas de PROPERTIES esquema, consulte MDSCHEMA_PROPERTIES Conjunto de linhas.
Por padrão, se a CELL PROPERTIES palavra-chave não for usada, as propriedades da célula retornadas serão VALUE, FORMATTED_VALUEe CELL_ORDINAL (nessa ordem). Se a CELL PROPERTIES palavra-chave for usada, somente essas propriedades de célula explicitamente declaradas com a palavra-chave serão retornadas.
O exemplo a seguir demonstra o uso da CELL PROPERTIES palavra-chave 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 da célula não são retornadas para consultas MDX que retornam conjuntos de linhas achatados; nesse caso, cada célula é representada como se apenas a propriedade da FORMATTED_VALUE célula fosse retornada.
Definindo propriedades da célula
As propriedades da célula podem ser definidas no Microsoft SQL Server Analysis Services em vários locais. Por exemplo, a propriedade Cadeia de Caracteres de Formato pode ser definida para medidas regulares na guia Estrutura do Cubo do Editor de Cubo 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 Cubo; medidas calculadas definidas na cláusula WITH de uma consulta também têm sua cadeia de caracteres de formato definida lá. 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