Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL Server Analysis Services
Azure Analysis Services
Fabric/Power BI Premium
As propriedades das células em Expressões Multidimensionais (MDX) contêm informação sobre o conteúdo e formato das células numa fonte de dados multidimensional, como um cubo.
O MDX suporta a palavra-chave PROPRIEDADES da célula numa instrução MDX SELECT para recuperar propriedades intrínsecas da célula. As propriedades intrínsecas das células são mais frequentemente utilizadas para ajudar na apresentação visual dos dados celulares.
SINTAXE DAS PROPRIEDADES DA CÉLULA Palavra-chave
Use a seguinte sintaxe 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 seguinte sintaxe mostra o formato do <cell_props> valor e como este valor utiliza a palavra-chave PROPRIEDADES CÉLULAS juntamente com uma ou mais propriedades intrínsecas das células:
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propriedades das Células Intrínsecas Suportadas
A tabela seguinte lista as propriedades intrínsecas das células suportadas que são usadas no <property> valor.
| Propriedade | Description |
|---|---|
| ACTION_TYPE | Uma máscara de bits que indica que tipos de ações existem na célula. Esta 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 Nota: As ações de drillthrough não estão incluídas para consultas que contenham um conjunto na cláusula where. |
| BACK_COLOR | A cor de fundo para exibir a propriedade VALUE ou FORMATTED_VALUE. Para mais informações, consulte FORE_COLOR e BACK_COLOR Conteúdos (MDX). |
| CELL_ORDINAL | O número ordinal da célula no conjunto de dados. |
| FONT_FLAGS | A máscara de bits detalha os efeitos na fonte. O valor é o resultado de uma operação bit a bit OR de uma ou mais das seguintes 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 a negrito (MDFF_BOLD) e sublinhado (MDFF_UNDERLINE). |
| FONT_NAME | A fonte a ser usada para mostrar a propriedade VALOR ou FORMATTED_VALUE . |
| FONT_SIZE | Tamanho da fonte a ser usado para exibir a propriedade VALUE ou FORMATTED_VALUE. |
| FORE_COLOR | A cor de primeiro plano para exibir o VALOR ou FORMATTED_VALUE. Para mais informações, consulte FORE_COLOR e BACK_COLOR Conteúdos (MDX). |
| FORMATO | Tal como FORMAT_STRING. |
| FORMAT_STRING | A string de formato utilizada para criar o valor da propriedade FORMATTED_VALUE. Para mais informações, consulte FORMAT_STRING Conteúdo (MDX). |
| FORMATTED_VALUE | A cadeia de caracteres que representa uma exibição formatada da propriedade VALUE . |
| IDIOMA | O local onde o FORMAT_STRING será aplicado. LANGUAGE é geralmente usado para conversão de moeda. |
| ATUALIZÁVEL | Um valor que indica se a célula pode ser atualizada. Esta 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 células. | |
| CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) A célula pode ser atualizada com uma instrução UPDATE. A atualização pode falhar se uma célula folha for atualizada sem estar com a permissão de escrita ativada. | |
| CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) A célula não pode ser atualizada porque tem um membro calculado entre as suas coordenadas; a célula foi recuperada com um conjunto na cláusula WHERE. Uma célula pode ser atualizada mesmo que uma fórmula afete, ou que uma célula calculada esteja ativa, o valor de uma célula (esteja algures ao longo do caminho de agregação). Neste cenário, o valor final da célula pode não ser o valor atualizado, porque 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 (contagem, mínimo, máximo, contagem distinta, semi-aditiva) não podem ser atualizadas. | |
| CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) A célula não pode ser atualizada porque ela não existe, pois está na interseção de uma medida e de um membro dimensional não relacionado com o grupo de medida da medida. | |
| CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) A célula não pode ser atualizada porque 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 razões internas. | |
| CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) A célula não pode ser atualizada porque a atualização não é suportada em dimensões de modelos de mineração, de mineração indireta ou de mineração de dados. | |
| VALUE | O valor não formatado da célula. |
São necessárias apenas as propriedades das células CELL_ORDINAL, FORMATTED_VALUE e VALUE . Todas as propriedades das células, intrínsecas ou específicas do fornecedor, são definidas no conjunto de linhas do esquema PROPERTIES , incluindo os seus tipos de dados e suporte ao fornecedor.
Por defeito, se a palavra-chave PROPRIEDADES da célula não for usada, as propriedades da célula devolvidas são VALUE, FORMATTED_VALUE e CELL_ORDINAL (nessa ordem). Se for usada a palavra-chave PROPRIEDADES da célula, apenas as propriedades da célula explicitamente indicadas com a palavra-chave são devolvidas.
O exemplo seguinte demonstra a utilização da palavra-chave PROPRIEDADES CELL numa 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 das células não são devolvidas para consultas MDX que retornam conjuntos de linhas achatadas; Neste caso, cada célula é representada como se apenas a propriedade FORMATTED_VALUE célula fosse devolvida.
Definição das Propriedades da Célula
As propriedades das células podem ser definidas no Microsoft SQL Server Analysis Services em vários locais. Por exemplo, a propriedade Format String pode ser definida para medidas regulares no separador Cube Structure do Editor de Cubos no SQL Server Data Tools; a mesma propriedade pode ser definida para medidas calculadas definidas no cubo no separador Cálculos do Editor de Cubos; as medidas calculadas definidas na cláusula WITH de uma consulta também têm a sua string de formato definida aí. A consulta seguinte demonstra como as propriedades das células podem ser definidas numa 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